@pineliner/odb-client 1.0.7 → 1.0.9

package/dist/index.js

@@ -6,6 +6,7 @@ var __webpack_modules__ = {
         __webpack_require__.r(__webpack_exports__);
         __webpack_require__.d(__webpack_exports__, {
             ORM: ()=>ORM,
+            Transaction: ()=>Transaction,
             and: ()=>and,
             createORM: ()=>createORM,
             eq: ()=>eq,
@@ -296,10 +297,67 @@ var __webpack_modules__ = {
                 return new DeleteBuilder(this.db, this.tableName);
             }
         }
+        class Transaction {
+            orm;
+            isCommitted = false;
+            isRolledBack = false;
+            db;
+            savepointName;
+            constructor(db, transactionDepth = 0, savepointName){
+                this.db = db;
+                this.orm = new ORM(db, transactionDepth);
+                this.savepointName = savepointName;
+            }
+            select(fields) {
+                this.checkNotFinalized();
+                return this.orm.select(fields);
+            }
+            insert(tableName) {
+                this.checkNotFinalized();
+                return this.orm.insert(tableName);
+            }
+            update(tableName) {
+                this.checkNotFinalized();
+                return this.orm.update(tableName);
+            }
+            delete(tableName) {
+                this.checkNotFinalized();
+                return this.orm.delete(tableName);
+            }
+            execute(sql, params) {
+                this.checkNotFinalized();
+                return this.orm.execute(sql, params);
+            }
+            async transaction(fn) {
+                this.checkNotFinalized();
+                if (fn) return await this.orm.transaction(fn);
+                return await this.orm.transaction();
+            }
+            async commit() {
+                if (this.isCommitted) throw new Error('Transaction already committed');
+                if (this.isRolledBack) throw new Error('Transaction already rolled back');
+                if (this.savepointName) await this.db.execute(`RELEASE SAVEPOINT ${this.savepointName}`, []);
+                else await this.db.execute('COMMIT', []);
+                this.isCommitted = true;
+            }
+            async rollback() {
+                if (this.isCommitted) throw new Error('Transaction already committed');
+                if (this.isRolledBack) throw new Error('Transaction already rolled back');
+                if (this.savepointName) await this.db.execute(`ROLLBACK TO SAVEPOINT ${this.savepointName}`, []);
+                else await this.db.execute('ROLLBACK', []);
+                this.isRolledBack = true;
+            }
+            checkNotFinalized() {
+                if (this.isCommitted) throw new Error('Cannot perform operations on committed transaction');
+                if (this.isRolledBack) throw new Error('Cannot perform operations on rolled back transaction');
+            }
+        }
         class ORM {
             db;
-            constructor(db){
+            transactionDepth = 0;
+            constructor(db, transactionDepth = 0){
                 this.db = db;
+                this.transactionDepth = transactionDepth;
             }
             table(tableName) {
                 return new TableQueryBuilder(this.db, tableName);
@@ -325,6 +383,33 @@ var __webpack_modules__ = {
             execute(sql, params) {
                 return this.db.execute(sql, params);
             }
+            async transaction(fn) {
+                if (!fn) if (this.transactionDepth > 0) {
+                    const savepointName = `sp_${this.transactionDepth}_${Date.now()}`;
+                    await this.db.execute(`SAVEPOINT ${savepointName}`, []);
+                    return new Transaction(this.db, this.transactionDepth + 1, savepointName);
+                } else {
+                    await this.db.execute('BEGIN TRANSACTION', []);
+                    return new Transaction(this.db, 1);
+                }
+                if (!(this.transactionDepth > 0)) return await this.db.transaction(async (txConnection)=>{
+                    const txOrm = new ORM(txConnection, 1);
+                    return await fn(txOrm);
+                });
+                {
+                    const savepointName = `sp_${this.transactionDepth}_${Date.now()}`;
+                    try {
+                        await this.db.execute(`SAVEPOINT ${savepointName}`, []);
+                        const nestedOrm = new ORM(this.db, this.transactionDepth + 1);
+                        const result = await fn(nestedOrm);
+                        await this.db.execute(`RELEASE SAVEPOINT ${savepointName}`, []);
+                        return result;
+                    } catch (error) {
+                        await this.db.execute(`ROLLBACK TO SAVEPOINT ${savepointName}`, []);
+                        throw error;
+                    }
+                }
+            }
         }
         function createORM(db) {
             return new ORM(db);
@@ -1204,6 +1289,26 @@ function sql_template_where(conditions) {
         args: values
     };
 }
+function parseJsonColumns(rows, jsonColumns) {
+    if (!jsonColumns || 0 === jsonColumns.length) return rows;
+    return rows.map((row)=>{
+        const parsed = {
+            ...row
+        };
+        for (const col of jsonColumns)if (col in parsed && 'string' == typeof parsed[col]) try {
+            parsed[col] = JSON.parse(parsed[col]);
+        } catch  {}
+        return parsed;
+    });
+}
+function stringifyJsonParams(params, stringifyParams) {
+    if (!stringifyParams || 0 === Object.keys(stringifyParams).length) return params;
+    const result = [
+        ...params
+    ];
+    for (const [_columnName, index] of Object.entries(stringifyParams))if (index < result.length && null != result[index] && 'object' == typeof result[index]) result[index] = JSON.stringify(result[index]);
+    return result;
+}
 class BunSQLiteAdapter {
     type = 'bun-sqlite';
     config;
@@ -1261,10 +1366,10 @@ class BunSQLiteConnection {
         this.sql.set = set;
         this.sql.where = sql_template_where;
     }
-    async query(sql, params = []) {
-        return this.execute(sql, params);
+    async query(sql, params = [], options) {
+        return this.execute(sql, params, options);
     }
-    async execute(sql, params = []) {
+    async execute(sql, params = [], options) {
         try {
             let sqlStr;
             let sqlParams;
@@ -1283,12 +1388,14 @@ class BunSQLiteConnection {
                 sqlStr = sql;
                 sqlParams = params;
             }
+            if (options?.stringifyParams) sqlParams = stringifyJsonParams(sqlParams, options.stringifyParams);
             const stmt = this.db.query(sqlStr);
             const isSelect = sqlStr.trim().toUpperCase().startsWith('SELECT') || sqlStr.trim().toUpperCase().includes('RETURNING');
             if (isSelect) {
-                const rows = stmt.all(...sqlParams);
+                let rows = stmt.all(...sqlParams);
+                if (options?.jsonColumns) rows = parseJsonColumns(rows, options.jsonColumns);
                 return {
-                    rows: rows,
+                    rows,
                     rowsAffected: 0
                 };
             }
@@ -1355,6 +1462,26 @@ class BunSQLiteConnection {
         return createORM(this);
     }
 }
+function libsql_parseJsonColumns(rows, jsonColumns) {
+    if (!jsonColumns || 0 === jsonColumns.length) return rows;
+    return rows.map((row)=>{
+        const parsed = {
+            ...row
+        };
+        for (const col of jsonColumns)if (col in parsed && 'string' == typeof parsed[col]) try {
+            parsed[col] = JSON.parse(parsed[col]);
+        } catch  {}
+        return parsed;
+    });
+}
+function libsql_stringifyJsonParams(params, stringifyParams) {
+    if (!stringifyParams || 0 === Object.keys(stringifyParams).length) return params;
+    const result = [
+        ...params
+    ];
+    for (const [_columnName, index] of Object.entries(stringifyParams))if (index < result.length && null != result[index] && 'object' == typeof result[index]) result[index] = JSON.stringify(result[index]);
+    return result;
+}
 class LibSQLAdapter {
     type = 'libsql';
     config;
@@ -1412,10 +1539,10 @@ class LibSQLConnection {
         this.sql.set = set;
         this.sql.where = sql_template_where;
     }
-    async query(sql, params = []) {
-        return this.execute(sql, params);
+    async query(sql, params = [], options) {
+        return this.execute(sql, params, options);
     }
-    async execute(sql, params = []) {
+    async execute(sql, params = [], options) {
         try {
             const target = this.txClient || this.client;
             let query;
@@ -1424,23 +1551,29 @@ class LibSQLConnection {
                     console.log('[LibSQL] Executing SQL:', sql);
                     console.log('[LibSQL] With params:', params);
                 }
+                let args = params;
+                if (options?.stringifyParams) args = libsql_stringifyJsonParams(args, options.stringifyParams);
                 query = {
                     sql,
-                    args: params
+                    args
                 };
             } else {
                 if (process.env.DEBUG_SQL) {
                     console.log('[LibSQL] Executing SQL:', sql.sql);
                     console.log('[LibSQL] With args:', sql.args);
                 }
+                let args = sql.args || [];
+                if (options?.stringifyParams) args = libsql_stringifyJsonParams(args, options.stringifyParams);
                 query = {
                     sql: sql.sql,
-                    args: sql.args || []
+                    args
                 };
             }
             const result = await target.execute(query);
+            let rows = result.rows;
+            if (options?.jsonColumns) rows = libsql_parseJsonColumns(rows, options.jsonColumns);
             return {
-                rows: result.rows,
+                rows,
                 rowsAffected: Number(result.rowsAffected),
                 lastInsertRowid: result.lastInsertRowid ? BigInt(result.lastInsertRowid.toString()) : void 0
             };
@@ -1482,6 +1615,26 @@ class LibSQLConnection {
         return createORM(this);
     }
 }
+function odblite_parseJsonColumns(rows, jsonColumns) {
+    if (!jsonColumns || 0 === jsonColumns.length) return rows;
+    return rows.map((row)=>{
+        const parsed = {
+            ...row
+        };
+        for (const col of jsonColumns)if (col in parsed && 'string' == typeof parsed[col]) try {
+            parsed[col] = JSON.parse(parsed[col]);
+        } catch  {}
+        return parsed;
+    });
+}
+function odblite_stringifyJsonParams(params, stringifyParams) {
+    if (!stringifyParams || 0 === Object.keys(stringifyParams).length) return params;
+    const result = [
+        ...params
+    ];
+    for (const [_columnName, index] of Object.entries(stringifyParams))if (index < result.length && null != result[index] && 'object' == typeof result[index]) result[index] = JSON.stringify(result[index]);
+    return result;
+}
 class ODBLiteAdapter {
     type = 'odblite';
     config;
@@ -1568,32 +1721,42 @@ class ODBLiteConnection {
         this.sql.set = set;
         this.sql.where = sql_template_where;
     }
-    async query(sql, params = []) {
-        return this.execute(sql, params);
+    async query(sql, params = [], options) {
+        return this.execute(sql, params, options);
     }
-    async execute(sql, params = []) {
+    async execute(sql, params = [], options) {
         try {
+            let rows;
+            let rowsAffected;
+            let lastInsertRowid;
             if ('object' == typeof sql) {
                 if (process.env.DEBUG_SQL) {
                     console.log('[ODBLite] Executing SQL:', sql.sql);
                     console.log('[ODBLite] With args:', sql.args);
                 }
-                const result = await this.client.sql.execute(sql.sql, sql.args || []);
-                return {
-                    rows: result.rows,
-                    rowsAffected: result.rowsAffected || 0,
-                    lastInsertRowid: result.lastInsertRowid
-                };
-            }
-            if (process.env.DEBUG_SQL) {
-                console.log('[ODBLite] Executing SQL:', sql);
-                console.log('[ODBLite] With params:', params);
+                let args = sql.args || [];
+                if (options?.stringifyParams) args = odblite_stringifyJsonParams(args, options.stringifyParams);
+                const result = await this.client.sql.execute(sql.sql, args);
+                rows = result.rows;
+                rowsAffected = result.rowsAffected || 0;
+                lastInsertRowid = result.lastInsertRowid;
+            } else {
+                if (process.env.DEBUG_SQL) {
+                    console.log('[ODBLite] Executing SQL:', sql);
+                    console.log('[ODBLite] With params:', params);
+                }
+                let args = params;
+                if (options?.stringifyParams) args = odblite_stringifyJsonParams(args, options.stringifyParams);
+                const result = await this.client.sql.execute(sql, args);
+                rows = result.rows;
+                rowsAffected = result.rowsAffected || 0;
+                lastInsertRowid = result.lastInsertRowid;
             }
-            const result = await this.client.sql.execute(sql, params);
+            if (options?.jsonColumns) rows = odblite_parseJsonColumns(rows, options.jsonColumns);
             return {
-                rows: result.rows,
-                rowsAffected: result.rowsAffected || 0,
-                lastInsertRowid: result.lastInsertRowid
+                rows,
+                rowsAffected,
+                lastInsertRowid
             };
         } catch (error) {
             throw error;
@@ -1875,6 +2038,7 @@ class DatabaseManager {
 var orm = __webpack_require__("./src/orm/index.ts");
 const { raw: src_raw, identifier: src_identifier, where: src_where, insertValues: src_insertValues, updateSet: src_updateSet, join: src_join } = ODBLiteClient;
 var __webpack_exports__ORM = orm.ORM;
+var __webpack_exports__ORMTransaction = orm.Transaction;
 var __webpack_exports__and = orm.and;
 var __webpack_exports__createORM = orm.createORM;
 var __webpack_exports__eq = orm.eq;
@@ -1888,4 +2052,4 @@ var __webpack_exports__lt = orm.lt;
 var __webpack_exports__lte = orm.lte;
 var __webpack_exports__ne = orm.ne;
 var __webpack_exports__or = orm.or;
-export { BunSQLiteAdapter, ConnectionError, DatabaseManager, HTTPClient, LibSQLAdapter, ODBLiteAdapter, ODBLiteClient, ODBLiteError, ODBLiteTransaction, types_QueryError as QueryError, sql_parser_SQLParser as SQLParser, ServiceClient, SimpleTransaction, convertTemplateToQuery, odblite as default, empty, fragment, src_identifier as identifier, src_insertValues as insertValues, src_join as join, odblite, parseSQL, src_raw as raw, sql_template_raw as rawSQL, set, splitSQLStatements, sql_parser_sql as sql, sql_template_fragment as sqlFragment, sql_template_join as sqlJoin, sql_template_sql as sqlTemplate, sql_template_where as sqlWhere, src_updateSet as updateSet, src_where as where, __webpack_exports__ORM as ORM, __webpack_exports__and as and, __webpack_exports__createORM as createORM, __webpack_exports__eq as eq, __webpack_exports__gt as gt, __webpack_exports__gte as gte, __webpack_exports__inArray as inArray, __webpack_exports__isNotNull as isNotNull, __webpack_exports__isNull as isNull, __webpack_exports__like as like, __webpack_exports__lt as lt, __webpack_exports__lte as lte, __webpack_exports__ne as ne, __webpack_exports__or as or };
+export { BunSQLiteAdapter, ConnectionError, DatabaseManager, HTTPClient, LibSQLAdapter, ODBLiteAdapter, ODBLiteClient, ODBLiteError, ODBLiteTransaction, types_QueryError as QueryError, sql_parser_SQLParser as SQLParser, ServiceClient, SimpleTransaction, convertTemplateToQuery, odblite as default, empty, fragment, src_identifier as identifier, src_insertValues as insertValues, src_join as join, odblite, parseSQL, src_raw as raw, sql_template_raw as rawSQL, set, splitSQLStatements, sql_parser_sql as sql, sql_template_fragment as sqlFragment, sql_template_join as sqlJoin, sql_template_sql as sqlTemplate, sql_template_where as sqlWhere, src_updateSet as updateSet, src_where as where, __webpack_exports__ORM as ORM, __webpack_exports__ORMTransaction as ORMTransaction, __webpack_exports__and as and, __webpack_exports__createORM as createORM, __webpack_exports__eq as eq, __webpack_exports__gt as gt, __webpack_exports__gte as gte, __webpack_exports__inArray as inArray, __webpack_exports__isNotNull as isNotNull, __webpack_exports__isNull as isNull, __webpack_exports__like as like, __webpack_exports__lt as lt, __webpack_exports__lte as lte, __webpack_exports__ne as ne, __webpack_exports__or as or };

package/dist/orm/index.d.ts

@@ -186,13 +186,53 @@ declare class TableQueryBuilder {
      */
     delete(): DeleteBuilder;
 }
+/**
+ * Manual Transaction Control
+ * Allows explicit commit/rollback control
+ */
+export declare class Transaction {
+    private orm;
+    private isCommitted;
+    private isRolledBack;
+    private db;
+    private savepointName?;
+    constructor(db: Connection, transactionDepth?: number, savepointName?: string);
+    /**
+     * Access ORM methods (select, insert, update, delete)
+     */
+    select(fields?: Record<string, any>): {
+        from: (tableName: string) => SelectBuilder<any>;
+    };
+    insert(tableName: string): InsertBuilder<any>;
+    update(tableName: string): UpdateBuilder<any>;
+    delete(tableName: string): DeleteBuilder;
+    execute(sql: string, params?: any[]): Promise<import("../index.ts").DatabaseQueryResult<any>>;
+    /**
+     * Create nested transaction (savepoint)
+     */
+    transaction(): Promise<Transaction>;
+    transaction<T>(fn: (tx: ORM) => Promise<T>): Promise<T>;
+    /**
+     * Commit the transaction
+     */
+    commit(): Promise<void>;
+    /**
+     * Rollback the transaction
+     */
+    rollback(): Promise<void>;
+    /**
+     * Check if transaction is finalized
+     */
+    private checkNotFinalized;
+}
 /**
  * ORM Wrapper for Connection
  * Provides Drizzle-like syntax for database operations
  */
 export declare class ORM {
     private db;
-    constructor(db: Connection);
+    private transactionDepth;
+    constructor(db: Connection, transactionDepth?: number);
     /**
      * Access a table for querying
      */
@@ -219,6 +259,44 @@ export declare class ORM {
      * Raw query access
      */
     execute(sql: string, params?: any[]): Promise<import("../index.ts").DatabaseQueryResult<any>>;
+    /**
+     * Execute a transaction with support for nested transactions (savepoints)
+     * @example
+     * // Callback-style transaction
+     * const result = await orm.transaction(async (tx) => {
+     *   const user = await tx.insert('users').values({ name: 'Alice' }).returning()
+     *   const profile = await tx.insert('profiles').values({
+     *     userId: user[0].id,
+     *     bio: 'Hello world',
+     *   }).returning()
+     *   return { user, profile }
+     * })
+     *
+     * @example
+     * // Manual transaction control
+     * const tx = await orm.transaction()
+     * try {
+     *   await tx.insert('users').values({ name: 'Bob' }).execute()
+     *   await tx.insert('profiles').values({ userId: 1, bio: 'Something' }).execute()
+     *   await tx.commit()
+     * } catch (err) {
+     *   await tx.rollback()
+     *   throw err
+     * }
+     *
+     * @example
+     * // Nested transaction (savepoint)
+     * await orm.transaction(async (outer) => {
+     *   await outer.insert('users').values({ name: 'Outer' })
+     *
+     *   await outer.transaction(async (inner) => {
+     *     await inner.insert('users').values({ name: 'Inner' })
+     *     // If this inner block throws, only the inner part rolls back
+     *   })
+     * })
+     */
+    transaction(): Promise<Transaction>;
+    transaction<T>(fn: (tx: ORM) => Promise<T>): Promise<T>;
 }
 /**
  * Create ORM instance from Connection

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pineliner/odb-client",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Isomorphic client for ODB-Lite with postgres.js-like template string SQL support",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -42,4 +42,4 @@
     "template-strings",
     "postgres-like"
   ]
-}
+}

package/src/database/adapters/bun-sqlite.ts

@@ -5,6 +5,7 @@ import type {
   QueryResult,
   PreparedStatement,
   BunSQLiteConfig,
+  QueryOptions,
 } from '../types'
 import {
   convertTemplateToQuery,
@@ -17,6 +18,48 @@ import {
   where
 } from '../sql-template'
 
+/**
+ * Parse JSON columns in query results
+ * Only parses if the value is a string (to avoid double-parsing)
+ */
+function parseJsonColumns<T = any>(rows: any[], jsonColumns?: string[]): T[] {
+  if (!jsonColumns || jsonColumns.length === 0) {
+    return rows
+  }
+
+  return rows.map(row => {
+    const parsed = { ...row }
+    for (const col of jsonColumns) {
+      if (col in parsed && typeof parsed[col] === 'string') {
+        try {
+          parsed[col] = JSON.parse(parsed[col])
+        } catch {
+          // Keep original value if parsing fails
+        }
+      }
+    }
+    return parsed
+  })
+}
+
+/**
+ * Stringify JSON parameters for INSERT/UPDATE queries
+ * Only stringifies if the value is an object/array (not already a string)
+ */
+function stringifyJsonParams(params: any[], stringifyParams?: Record<string, number>): any[] {
+  if (!stringifyParams || Object.keys(stringifyParams).length === 0) {
+    return params
+  }
+
+  const result = [...params]
+  for (const [_columnName, index] of Object.entries(stringifyParams)) {
+    if (index < result.length && result[index] != null && typeof result[index] === 'object') {
+      result[index] = JSON.stringify(result[index])
+    }
+  }
+  return result
+}
+
 /**
  * Bun SQLite adapter for DatabaseManager
  * Wraps bun:sqlite with Connection interface
@@ -117,14 +160,14 @@ class BunSQLiteConnection implements Connection {
   /**
    * Query with SQL string and parameters (alias for execute)
    */
-  async query<T = any>(sql: string, params: any[] = []): Promise<QueryResult<T>> {
-    return this.execute(sql, params) as Promise<QueryResult<T>>
+  async query<T = any>(sql: string, params: any[] = [], options?: QueryOptions): Promise<QueryResult<T>> {
+    return this.execute(sql, params, options) as Promise<QueryResult<T>>
   }
 
   /**
    * Execute SQL with parameters
    */
-  async execute(sql: string | { sql: string; args?: any[] }, params: any[] = []): Promise<QueryResult> {
+  async execute(sql: string | { sql: string; args?: any[] }, params: any[] = [], options?: QueryOptions): Promise<QueryResult> {
     try {
       // Handle object format { sql, args }
       let sqlStr: string
@@ -147,14 +190,25 @@ class BunSQLiteConnection implements Connection {
         sqlParams = params
       }
 
+      // Stringify JSON parameters if specified
+      if (options?.stringifyParams) {
+        sqlParams = stringifyJsonParams(sqlParams, options.stringifyParams)
+      }
+
       const stmt = this.db.query(sqlStr)
       const isSelect = sqlStr.trim().toUpperCase().startsWith('SELECT') ||
                        sqlStr.trim().toUpperCase().includes('RETURNING')
 
       if (isSelect) {
-        const rows = stmt.all(...sqlParams)
+        let rows = stmt.all(...sqlParams) as any[]
+
+        // Parse JSON columns if specified
+        if (options?.jsonColumns) {
+          rows = parseJsonColumns(rows, options.jsonColumns)
+        }
+
         return {
-          rows: rows as any[],
+          rows,
           rowsAffected: 0,
         }
       } else {