@pineliner/odb-client 1.0.7 → 1.0.8

package/dist/index.cjs

@@ -4,6 +4,7 @@ var __webpack_modules__ = {
         __webpack_require__.r(__webpack_exports__);
         __webpack_require__.d(__webpack_exports__, {
             ORM: ()=>ORM,
+            Transaction: ()=>Transaction,
             and: ()=>and,
             createORM: ()=>createORM,
             eq: ()=>eq,
@@ -294,10 +295,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);
@@ -323,6 +381,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);
@@ -398,6 +483,7 @@ var __webpack_exports__ = {};
         splitSQLStatements: ()=>splitSQLStatements,
         where: ()=>src_where,
         LibSQLAdapter: ()=>LibSQLAdapter,
+        ORMTransaction: ()=>orm.Transaction,
         lt: ()=>orm.lt,
         fragment: ()=>fragment,
         isNull: ()=>orm.isNull,
@@ -1948,6 +2034,7 @@ exports.ODBLiteClient = __webpack_exports__.ODBLiteClient;
 exports.ODBLiteError = __webpack_exports__.ODBLiteError;
 exports.ODBLiteTransaction = __webpack_exports__.ODBLiteTransaction;
 exports.ORM = __webpack_exports__.ORM;
+exports.ORMTransaction = __webpack_exports__.ORMTransaction;
 exports.QueryError = __webpack_exports__.QueryError;
 exports.SQLParser = __webpack_exports__.SQLParser;
 exports.ServiceClient = __webpack_exports__.ServiceClient;
@@ -1996,6 +2083,7 @@ for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "ODBLiteError",
     "ODBLiteTransaction",
     "ORM",
+    "ORMTransaction",
     "QueryError",
     "SQLParser",
     "ServiceClient",

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { HTTPClient } from './core/http-client.ts';
 export { SQLParser, sql, fragment } from './core/sql-parser.ts';
 export { ServiceClient } from './service/service-client.ts';
 export { DatabaseManager, parseSQL, splitSQLStatements, BunSQLiteAdapter, LibSQLAdapter, ODBLiteAdapter, sql as sqlTemplate, raw as rawSQL, empty, fragment as sqlFragment, join as sqlJoin, set, where as sqlWhere, convertTemplateToQuery, } from './database/index.ts';
-export { ORM, createORM, eq, ne, gt, gte, lt, lte, like, inArray, isNull, isNotNull, and, or, type WhereCondition, type OrderByDirection, } from './orm/index.ts';
+export { ORM, Transaction as ORMTransaction, createORM, eq, ne, gt, gte, lt, lte, like, inArray, isNull, isNotNull, and, or, type WhereCondition, type OrderByDirection, } from './orm/index.ts';
 export type { ODBLiteConfig, ODBLiteConnection, QueryResult, Transaction, SQLFragment, PreparedQuery, QueryParameter, PrimitiveType, Row } from './types.ts';
 export type { ServiceClientConfig, ODBLiteDatabase, ODBLiteNode } from './service/service-client.ts';
 export type { TenancyMode, BackendType, QueryResult as DatabaseQueryResult, Connection, DatabaseAdapter, PreparedStatement as DatabasePreparedStatement, DatabaseManagerConfig, MigrationConfig, BunSQLiteConfig, LibSQLConfig, ODBLiteConfig as DatabaseODBLiteConfig, TenantInfo, ParsedStatements, SQLParserOptions, SqlQuery, SqlFragment, } from './database/index.ts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,OAAO,EACL,eAAe,EACf,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,cAAc,EAEd,GAAG,IAAI,WAAW,EAClB,GAAG,IAAI,MAAM,EACb,KAAK,EACL,QAAQ,IAAI,WAAW,EACvB,IAAI,IAAI,OAAO,EACf,GAAG,EACH,KAAK,IAAI,QAAQ,EACjB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,GAAG,EACH,SAAS,EACT,EAAE,EACF,EAAE,EACF,EAAE,EACF,GAAG,EACH,EAAE,EACF,GAAG,EACH,IAAI,EACJ,OAAO,EACP,MAAM,EACN,SAAS,EACT,GAAG,EACH,EAAE,EACF,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EACd,aAAa,EACb,GAAG,EACJ,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAGrC,YAAY,EACV,WAAW,EACX,WAAW,EACX,WAAW,IAAI,mBAAmB,EAClC,UAAU,EACV,eAAe,EACf,iBAAiB,IAAI,yBAAyB,EAC9C,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,aAAa,IAAI,qBAAqB,EACtC,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,UAAU,EACX,MAAM,YAAY,CAAC;AAGpB,eAAO,MACL,GAAG,4BACH,UAAU,mCACV,KAAK,8BACL,YAAY,qCACZ,SAAS,kCACT,IAAI,2BACW,CAAC;AAGlB,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,OAAO,EACL,eAAe,EACf,QAAQ,EACR,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,cAAc,EAEd,GAAG,IAAI,WAAW,EAClB,GAAG,IAAI,MAAM,EACb,KAAK,EACL,QAAQ,IAAI,WAAW,EACvB,IAAI,IAAI,OAAO,EACf,GAAG,EACH,KAAK,IAAI,QAAQ,EACjB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,GAAG,EACH,WAAW,IAAI,cAAc,EAC7B,SAAS,EACT,EAAE,EACF,EAAE,EACF,EAAE,EACF,GAAG,EACH,EAAE,EACF,GAAG,EACH,IAAI,EACJ,OAAO,EACP,MAAM,EACN,SAAS,EACT,GAAG,EACH,EAAE,EACF,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EACd,aAAa,EACb,GAAG,EACJ,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAGrC,YAAY,EACV,WAAW,EACX,WAAW,EACX,WAAW,IAAI,mBAAmB,EAClC,UAAU,EACV,eAAe,EACf,iBAAiB,IAAI,yBAAyB,EAC9C,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,aAAa,IAAI,qBAAqB,EACtC,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,UAAU,EACX,MAAM,YAAY,CAAC;AAGpB,eAAO,MACL,GAAG,4BACH,UAAU,mCACV,KAAK,8BACL,YAAY,qCACZ,SAAS,kCACT,IAAI,2BACW,CAAC;AAGlB,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC"}

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);
@@ -1875,6 +1960,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 +1974,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.8",
   "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/index.ts

@@ -32,6 +32,7 @@ export {
 // ORM exports (Drizzle-like query builder)
 export {
   ORM,
+  Transaction as ORMTransaction,
   createORM,
   eq,
   ne,

package/src/orm/index.ts

@@ -461,6 +461,129 @@ class TableQueryBuilder {
   }
 }
 
+// ============================================================
+// MANUAL TRANSACTION CLASS
+// ============================================================
+
+/**
+ * Manual Transaction Control
+ * Allows explicit commit/rollback control
+ */
+export class Transaction {
+  private orm: ORM
+  private isCommitted: boolean = false
+  private isRolledBack: boolean = false
+  private db: Connection
+  private savepointName?: string
+
+  constructor(db: Connection, transactionDepth: number = 0, savepointName?: string) {
+    this.db = db
+    this.orm = new ORM(db, transactionDepth)
+    this.savepointName = savepointName
+  }
+
+  /**
+   * Access ORM methods (select, insert, update, delete)
+   */
+  select(fields?: Record<string, any>) {
+    this.checkNotFinalized()
+    return this.orm.select(fields)
+  }
+
+  insert(tableName: string) {
+    this.checkNotFinalized()
+    return this.orm.insert(tableName)
+  }
+
+  update(tableName: string) {
+    this.checkNotFinalized()
+    return this.orm.update(tableName)
+  }
+
+  delete(tableName: string) {
+    this.checkNotFinalized()
+    return this.orm.delete(tableName)
+  }
+
+  execute(sql: string, params?: any[]) {
+    this.checkNotFinalized()
+    return this.orm.execute(sql, params)
+  }
+
+  /**
+   * Create nested transaction (savepoint)
+   */
+  async transaction(): Promise<Transaction>
+  async transaction<T>(fn: (tx: ORM) => Promise<T>): Promise<T>
+  async transaction<T>(fn?: (tx: ORM) => Promise<T>): Promise<T | Transaction> {
+    this.checkNotFinalized()
+
+    if (fn) {
+      // Callback-style nested transaction
+      return await this.orm.transaction(fn)
+    } else {
+      // Manual-style nested transaction
+      return await this.orm.transaction()
+    }
+  }
+
+  /**
+   * Commit the transaction
+   */
+  async commit(): Promise<void> {
+    if (this.isCommitted) {
+      throw new Error('Transaction already committed')
+    }
+    if (this.isRolledBack) {
+      throw new Error('Transaction already rolled back')
+    }
+
+    if (this.savepointName) {
+      // Release savepoint for nested transaction
+      await this.db.execute(`RELEASE SAVEPOINT ${this.savepointName}`, [])
+    } else {
+      // Commit top-level transaction
+      await this.db.execute('COMMIT', [])
+    }
+
+    this.isCommitted = true
+  }
+
+  /**
+   * Rollback the transaction
+   */
+  async rollback(): Promise<void> {
+    if (this.isCommitted) {
+      throw new Error('Transaction already committed')
+    }
+    if (this.isRolledBack) {
+      throw new Error('Transaction already rolled back')
+    }
+
+    if (this.savepointName) {
+      // Rollback to savepoint for nested transaction
+      await this.db.execute(`ROLLBACK TO SAVEPOINT ${this.savepointName}`, [])
+    } else {
+      // Rollback top-level transaction
+      await this.db.execute('ROLLBACK', [])
+    }
+
+    this.isRolledBack = true
+  }
+
+  /**
+   * Check if transaction is finalized
+   */
+  private 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')
+    }
+  }
+}
+
 // ============================================================
 // ORM CONNECTION WRAPPER
 // ============================================================
@@ -471,9 +594,11 @@ class TableQueryBuilder {
  */
 export class ORM {
   private db: Connection
+  private transactionDepth: number = 0
 
-  constructor(db: Connection) {
+  constructor(db: Connection, transactionDepth: number = 0) {
     this.db = db
+    this.transactionDepth = transactionDepth
   }
 
   /**
@@ -525,6 +650,96 @@ export class ORM {
   execute(sql: string, params?: any[]) {
     return this.db.execute(sql, params)
   }
+
+  /**
+   * 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
+   *   })
+   * })
+   */
+  async transaction(): Promise<Transaction>
+  async transaction<T>(fn: (tx: ORM) => Promise<T>): Promise<T>
+  async transaction<T>(fn?: (tx: ORM) => Promise<T>): Promise<T | Transaction> {
+    // Manual transaction control (no callback provided)
+    if (!fn) {
+      if (this.transactionDepth > 0) {
+        // Nested manual transaction - create savepoint
+        const savepointName = `sp_${this.transactionDepth}_${Date.now()}`
+        await this.db.execute(`SAVEPOINT ${savepointName}`, [])
+        return new Transaction(this.db, this.transactionDepth + 1, savepointName)
+      } else {
+        // Top-level manual transaction
+        await this.db.execute('BEGIN TRANSACTION', [])
+        return new Transaction(this.db, 1)
+      }
+    }
+
+    // Callback-style transaction
+    // Check if we're already in a transaction (nested transaction)
+    if (this.transactionDepth > 0) {
+      // Nested transaction - use savepoint
+      const savepointName = `sp_${this.transactionDepth}_${Date.now()}`
+
+      try {
+        // Create savepoint
+        await this.db.execute(`SAVEPOINT ${savepointName}`, [])
+
+        // Create a new ORM instance with incremented depth
+        const nestedOrm = new ORM(this.db, this.transactionDepth + 1)
+
+        // Execute the user's transaction function
+        const result = await fn(nestedOrm)
+
+        // Release savepoint on success
+        await this.db.execute(`RELEASE SAVEPOINT ${savepointName}`, [])
+
+        return result
+      } catch (error) {
+        // Rollback to savepoint on error
+        await this.db.execute(`ROLLBACK TO SAVEPOINT ${savepointName}`, [])
+        throw error
+      }
+    } else {
+      // Top-level transaction - use the connection's transaction method
+      return await this.db.transaction(async (txConnection) => {
+        // Create a new ORM instance wrapping the transaction connection
+        // Start at depth 1 since we're now inside a transaction
+        const txOrm = new ORM(txConnection, 1)
+        // Execute the user's transaction function with the transaction ORM
+        return await fn(txOrm)
+      })
+    }
+  }
 }
 
 /**