web_plsql 0.13.2 → 0.14.0

package/README.md

@@ -50,11 +50,6 @@ The `startServer` api uses the following configuration object:
 /**
  * @typedef {'basic' | 'debug'} errorStyleType
  */
-export const z$errorStyleType = z.enum(['basic', 'debug']);
-
-/**
- * @typedef {{alias: string, procedure: string}} pathAliasType
- */
 
 /**
  * @typedef {object} configStaticType
@@ -63,14 +58,42 @@ export const z$errorStyleType = z.enum(['basic', 'debug']);
  */
 
 /**
- * @typedef {object} configPlSqlType
+ * @callback transactionCallbackType
+ * @param {Request} req - Incoming request object.
+ * @param {import('oracledb').Connection} connection - Active database connection pool.
+ * @returns {void | Promise<void>}
+ */
+
+/**
+ * @typedef {'commit' | 'rollback' | transactionCallbackType | undefined | null} transactionModeType
+ */
+
+/**
+ * @typedef {object} configPlSqlHandlerType
+ * @property {string} defaultPage - The default page.
+ * @property {string} [pathAlias] - The path alias.
+ * @property {string} [pathAliasProcedure] - The path alias.
+ * @property {string} documentTable - The document table.
+ * @property {string[]} [exclusionList] - The exclusion list.
+ * @property {string} [requestValidationFunction] - The request validation function.
+ * @property {Record<string, string>} [cgi] - The additional CGI.
+ * @property {transactionModeType} [transactionMode='commit'] - Specifies an optional transaction mode.
+ * "commit" this automatically commits any open transaction after each request. This is the defaults because this is what mod_plsql and ohs are doing.
+ * "rollback" this automatically rolles back any open transaction after each request.
+ * "transactionCallbackType" this allows to defined a custom handler as a JavaScript function.
+ * @property {errorStyleType} errorStyle - The error style.
+ */
+
+/**
+ * @typedef {object} configPlSqlConfigType
  * @property {string} route - The PL/SQL route path.
  * @property {string} user - The Oracle username.
  * @property {string} password - The Oracle password.
  * @property {string} connectString - The Oracle connect string.
- * @property {string} defaultPage - The default page.
- * @property {pathAliasType} [pathAlias] - The path alias.
- * @property {string} documentTable - The document table.
+ */
+
+/**
+ * @typedef {configPlSqlHandlerType & configPlSqlConfigType} configPlSqlType
  */
 
 /**
@@ -78,7 +101,6 @@ export const z$errorStyleType = z.enum(['basic', 'debug']);
  * @property {number} port - The server port number.
  * @property {configStaticType[]} routeStatic - The static routes.
  * @property {configPlSqlType[]} routePlSql - The PL/SQL routes.
- * @property {errorStyleType} errorStyle - The error style.
  * @property {string} loggerFilename - name of the request logger filename or '' if not required.
  */
 ```
@@ -147,30 +169,36 @@ The following mod_plsql DAD configuration translates to the configuration option
 # Configuration options
 
 ## Supported mod_plsql configuration options
-- PlsqlDatabaseConnectString
-- PlsqlDatabaseUserName
-- PlsqlDatabasePassword
-- PlsqlDefaultPage
-- PlsqlDocumentTablename
-- PlsqlErrorStyle
-- PlsqlLogEnable
-- PlsqlLogDirectory
-- PlsqlPathAlias
-- PlsqlPathAliasProcedure
+- PlsqlDatabaseConnectString -> routePlSql[].connectString
+- PlsqlDatabaseUserName -> routePlSql[].user
+- PlsqlDatabasePassword -> routePlSql[].password
+- PlsqlDefaultPage -> routePlSql[].defaultPage
+- PlsqlDocumentTablename -> routePlSql[].documentTable
+- PlsqlErrorStyle -> routePlSql[].errorStyle
+- PlsqlLogEnable -> loggerFilename
+- PlsqlLogDirectory -> loggerFilename
+- PlsqlPathAlias -> routePlSql[].pathAlias
+- PlsqlPathAliasProcedure -> routePlSql[].pathAliasProcedure
 - Default exclusion list.
-- PlsqlRequestValidationFunction
+- PlsqlRequestValidationFunction -> routePlSql[].pathAliasProcedure
 - PlsqlExclusionList
 - Basic and custom authentication methods, based on the OWA_SEC package and custom packages.
 
+## Features that are only available in web_plsql
+- The option `transactionModeType` specifies an optional transaction mode.
+  "commit" this automatically commits any open transaction after each request. This is the defaults because this is what mod_plsql and ohs are doing.
+  "rollback" this automatically rolles back any open transaction after each request.
+  "transactionCallbackType" this allows to defined a custom handler as a JavaScript function.
+
 ## Features that are planned to be available in web_plsql
 - Support for APEX 5 or greater.
 
 ## Configuration options that will not be supported:
-- PlsqlDocumentProcedure
-- PlsqlAfterProcedure
 - PlsqlAlwaysDescribeProcedure
+- PlsqlAfterProcedure
 - PlsqlBeforeProcedure
 - PlsqlCGIEnvironmentList
+- PlsqlDocumentProcedure
 - PlsqlDocumentPath
 - PlsqlIdleSessionCleanupInterval
 - PlsqlSessionCookieName

package/examples/config-native.js

@@ -1,6 +1,39 @@
 #!/usr/bin/env node
 
 import {startServer} from '../src/index.js';
+import oracledb from 'oracledb';
+
+/**
+ * @param {import('oracledb').Connection} connection - Oracle DB connection.
+ * @returns {Promise<boolean>}
+ */
+const hasOpenTransaction = async (connection) => {
+	const sql = `SELECT COUNT(*) FROM sys.v_$transaction t JOIN sys.v_$session s ON t.ses_addr = s.saddr WHERE s.audsid = USERENV('SESSIONID')`;
+	/** @type {import('oracledb').Result<number>} */
+	let result;
+
+	try {
+		result = await connection.execute(sql, [], {
+			outFormat: oracledb.OUT_FORMAT_ARRAY,
+		});
+	} catch (error) {
+		console.error('hasOpenTransaction: error', error, sql);
+		return false;
+	}
+
+	if (
+		!Array.isArray(result.rows) ||
+		result.rows.length !== 1 ||
+		!Array.isArray(result.rows[0]) ||
+		result.rows[0].length !== 1 ||
+		typeof result.rows[0][0] !== 'number'
+	) {
+		console.error('hasOpenTransaction: invalid result', result, sql);
+		return false;
+	}
+
+	return result.rows[0] > 0;
+};
 
 void startServer({
 	port: 8888,
@@ -22,6 +55,14 @@ void startServer({
 			requestValidationFunction: 'sample_pkg.request_validation_function', // PlsqlRequestValidationFunction
 			pathAlias: 'myalias', // PlsqlPathAlias
 			pathAliasProcedure: 'sample_pkg.page_path_alias', // PlsqlPathAliasProcedure
+			transactionMode: 'commit',
+			/*
+			transactionMode: async (req, connection) => {
+				if (await hasOpenTransaction(connection)) {
+					console.log(`We detected an open transaction in "${req.originalUrl}"`);
+				}
+			},
+			*/
 			errorStyle: 'debug', // PlsqlErrorStyle
 		},
 	],

package/examples/sql/install.sql

@@ -15,6 +15,10 @@ GRANT create sequence TO &&SAMPLE_USER;
 GRANT create procedure TO &&SAMPLE_USER;
 GRANT execute on dbms_lob TO &&SAMPLE_USER;
 
+-- only required if you want to test for open connections
+GRANT select on sys.v_$transaction TO &&SAMPLE_USER;
+GRANT select on sys.v_$session TO &&SAMPLE_USER;
+
 -- change schema
 ALTER SESSION SET CURRENT_SCHEMA=&&SAMPLE_USER;
 

package/examples/sql/sample_package.sql

@@ -18,7 +18,7 @@ PROCEDURE page_file_upload;
 PROCEDURE page_file_uploaded(name_array IN owa.vc_arr, value_array IN owa.vc_arr);
 PROCEDURE page_redirect;
 PROCEDURE page_location;
-PROCEDURE page_other;
+PROCEDURE page_open_transaction;
 PROCEDURE page_path_alias(p_path IN VARCHAR2);
 PROCEDURE page_exclusion_list;
 PROCEDURE page_request_validation_function;

package/examples/sql/sample_package_body.sql

@@ -32,6 +32,7 @@ BEGIN
 	htp.p('<li><a href="sample_pkg.page_file_upload">File upload</a></li>');
 	htp.p('<li><a href="sample_pkg.page_redirect">Redirect</a></li>');
 	htp.p('<li><a href="sample_pkg.page_location">Change location</a></li>');
+	htp.p('<li><a href="sample_pkg.page_open_transaction">Transaction mode: custom handler</a></li>');
 	htp.p('<li><a href="myalias">pathAlias configuration setting</a></li>');
 	htp.p('<li><a href="sample_pkg.page_exclusion_list">Custom exclusion list</a></li>');
 	htp.p('<li><a href="sample_pkg.page_request_validation_function">Request validation function</a></li>');
@@ -236,12 +237,17 @@ BEGIN
 	close_page();
 END page_location;
 
-PROCEDURE page_other
+PROCEDURE page_open_transaction
 IS
+	l_name CONSTANT docTable.name%TYPE := 'page_open_transaction';
 BEGIN
-	open_page('web_plsql - Other page');
+	open_page('web_plsql - Transaction mode: custom handler');
+
+	DELETE docTable WHERE name = l_name;
+	INSERT INTO docTable (name) VALUES (l_name);
+
 	close_page();
-END page_other;
+END page_open_transaction;
 
 PROCEDURE page_path_alias(p_path IN VARCHAR2)
 IS

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "web_plsql",
-	"version": "0.13.2",
+	"version": "0.14.0",
 	"author": "Dieter Oberkofler <dieter.oberkofler@gmail.com>",
 	"license": "MIT",
 	"description": "The Express Middleware for Oracle PL/SQL",
@@ -53,7 +53,7 @@
 		"image-save": "docker save web_plsql | gzip > web_plsql.tar.gz"
 	},
 	"peerDependencies": {
-		"oracledb": "6.9.0"
+		"oracledb": "6.10.0"
 	},
 	"dependencies": {
 		"basic-auth": "2.0.1",
@@ -67,27 +67,27 @@
 		"morgan": "1.10.1",
 		"multer": "2.0.2",
 		"rotating-file-stream": "3.2.7",
-		"zod": "4.1.11"
+		"zod": "4.1.12"
 	},
 	"devDependencies": {
 		"@types/basic-auth": "1.1.8",
 		"@types/compression": "1.8.1",
-		"@types/cookie-parser": "1.4.9",
+		"@types/cookie-parser": "1.4.10",
 		"@types/debug": "4.1.12",
 		"@types/escape-html": "1.0.4",
 		"@types/fs-extra": "11.0.4",
 		"@types/morgan": "1.9.10",
 		"@types/multer": "2.0.0",
-		"@types/node": "24.5.2",
-		"@types/oracledb": "6.9.1",
+		"@types/node": "24.9.2",
+		"@types/oracledb": "6.10.0",
 		"@types/supertest": "6.0.3",
-		"eslint": "9.36.0",
-		"eslint-plugin-jsdoc": "60.1.1",
+		"eslint": "9.39.0",
+		"eslint-plugin-jsdoc": "61.1.11",
 		"prettier": "3.6.2",
-		"rimraf": "6.0.1",
+		"rimraf": "6.1.0",
 		"shx": "0.4.0",
 		"supertest": "7.1.4",
-		"typescript": "5.9.2",
-		"typescript-eslint": "8.44.0"
+		"typescript": "5.9.3",
+		"typescript-eslint": "8.46.2"
 	}
 }

package/src/handler/handlerUpload.js

@@ -1,4 +1,4 @@
-import path from 'node:path';
+//import path from 'node:path';
 import multer from 'multer';
 
 /**
@@ -17,11 +17,13 @@ import multer from 'multer';
 export const handlerUpload = () => {
 	const upload = multer({
 		storage: multer.diskStorage({
-			destination: '/tmp/uploads',
+			/*
+			destination: '/tmp/webplsql',
 			filename: (req, file, cb) => {
 				const uniqueSuffix = `${Date.now()}-${Math.round(Math.random() * 1e9)}`;
 				cb(null, `${file.fieldname}-${uniqueSuffix}${path.extname(file.originalname)}`);
 			},
+			*/
 		}),
 		limits: {
 			fileSize: 50 * 1024 * 1024, // 50MB limit

package/src/handler/plsql/handlerPlSql.js

@@ -41,6 +41,7 @@ const requestHandler = async (req, res, next, connectionPool, options) => {
 				errorPage(req, res, options, new RequestError('No procedure name given and no default page has been specified'));
 			}
 		} else {
+			// request handler
 			await processRequest(req, res, options, connectionPool);
 		}
 	} catch (err) {

package/src/handler/plsql/request.js

@@ -49,7 +49,7 @@ export const processRequest = async (req, res, options, connectionPool) => {
 	const argObj = {};
 	Object.assign(argObj, req.query);
 
-	// For add the files that must be uploaded, we now copy the actual filename to the appropriate prameter to the invoked procedure.
+	// For add the files that must be uploaded, we now copy the actual filename to the appropriate parameter to the invoked procedure.
 	filesToUpload.reduce((aggregator, file) => {
 		aggregator[file.fieldname] = file.filename;
 		return aggregator;
@@ -57,10 +57,27 @@ export const processRequest = async (req, res, options, connectionPool) => {
 
 	// Does the request contain a body
 	Object.assign(argObj, normalizeBody(req));
+	debug('executeRequest: argObj=', argObj);
 
 	// invoke the Oracle procedure and get the page contenst
 	await invokeProcedure(req, res, argObj, cgiObj, filesToUpload, options, connection);
 
+	// transaction mode
+	if (options.transactionMode === 'rollback') {
+		debug('transactionMode: rollback');
+		await connection.rollback();
+	} else if (typeof options.transactionMode === 'function') {
+		debug('transactionMode: callback');
+		const result = options.transactionMode(req, connection);
+		debug('transactionMode: callback restult', result);
+		if (result && typeof result.then === 'function') {
+			await result;
+		}
+	} else {
+		debug('transactionMode: commit');
+		await connection.commit();
+	}
+
 	// close database connection
 	await connection.release();
 

package/src/handler/plsql/upload.js

@@ -8,6 +8,7 @@ import debugModule from 'debug';
 const debug = debugModule('webplsql:fileUpload');
 
 import {readFile, removeFile} from '../../util/file.js';
+import {errorToString} from '../../util/errorToString.js';
 import oracledb from 'oracledb';
 import z from 'zod';
 
@@ -37,20 +38,25 @@ const z$reqFiles = z.array(
  * @returns {fileUploadType[]} - Promise that resolves with an array of files to be uploaded.
  */
 export const getFiles = (req) => {
-	/** @type {fileUploadType[]} */
-	const files = [];
-
 	if (!('files' in req)) {
-		return files;
+		debug('getFiles: no files');
+		return [];
 	}
 
 	if (typeof req.files === 'object' && req.files !== null && Object.keys(req.files).length === 0) {
-		return files;
+		debug('getFiles: no files');
+		return [];
+	}
+
+	const files = z$reqFiles.parse(req.files);
+
+	for (const file of files) {
+		file.filename += `/${file.originalname}`;
 	}
 
-	debug('req.files=', req.files);
+	debug('getFiles', files);
 
-	return z$reqFiles.parse(req.files);
+	return files;
 };
 
 /**
@@ -62,12 +68,22 @@ export const getFiles = (req) => {
  * @returns {Promise<void>} - Promise that resolves when uploaded.
  */
 export const uploadFile = async (file, doctable, databaseConnection) => {
+	debug(`uploadFile`, file, doctable);
+
 	/* istanbul ignore next */
 	if (typeof doctable !== 'string' || doctable.length === 0) {
 		throw new Error(`Unable to upload file "${file.filename}" because the option ""doctable" has not been defined`);
 	}
 
-	const blobContent = await readFile(file.path);
+	// read file
+	let blobContent;
+	try {
+		blobContent = await readFile(file.path);
+	} catch (err) {
+		throw new Error(`Unable to load file "${file.path}".\n${errorToString(err)}`);
+	}
+
+	// insert file in document table
 	const sql = `INSERT INTO ${doctable} (name, mime_type, doc_size, dad_charset, last_updated, content_type, blob_content) VALUES (:name, :mime_type, :doc_size, 'ascii', SYSDATE, 'BLOB', :blob_content)`;
 	const bind = {
 		name: file.filename,
@@ -78,13 +94,16 @@ export const uploadFile = async (file, doctable, databaseConnection) => {
 			type: oracledb.BUFFER,
 		},
 	};
-
 	try {
 		await databaseConnection.execute(sql, bind, {autoCommit: true});
 	} catch (err) {
-		throw new Error(`Unable to insert file "${file.filename}"}`);
+		throw new Error(`Unable to insert file "${file.filename}".\n${errorToString(err)}`);
 	}
 
 	// remove the file
-	await removeFile(file.path);
+	try {
+		await removeFile(file.path);
+	} catch (err) {
+		throw new Error(`Unable to remove file "${file.filename}".\n${errorToString(err)}`);
+	}
 };

package/src/server/config.js

@@ -14,30 +14,38 @@ export const showConfig = (config) => {
 	console.log('NODE PL/SQL SERVER');
 	console.log(LINE);
 
-	console.log(`Server port:           ${config.port}`);
-	console.log(`Access log:            ${config.loggerFilename.length > 0 ? config.loggerFilename : ''}`);
+	console.log(`Server port:            ${config.port}`);
+	console.log(`Access log:             ${config.loggerFilename.length > 0 ? config.loggerFilename : ''}`);
 
 	if (config.routeStatic.length > 0) {
 		console.log(LINE);
 		config.routeStatic.forEach((e) => {
-			console.log(`Static route:          ${e.route}`);
-			console.log(`Directory path:        ${e.directoryPath}`);
+			console.log(`Static route:           ${e.route}`);
+			console.log(`Directory path:         ${e.directoryPath}`);
 		});
 	}
 
 	if (config.routePlSql.length > 0) {
 		console.log(LINE);
 		config.routePlSql.forEach((e) => {
-			console.log(`Route:                 http://localhost:${config.port}${e.route}`);
-			console.log(`Oracle user:           ${e.user}`);
-			console.log(`Oracle server:         ${e.connectString}`);
-			console.log(`Oracle document table: ${e.documentTable}`);
-			console.log(`Default page:          ${e.defaultPage}`);
-			console.log(`Path alias:            ${e.pathAlias}`);
-			console.log(`Path alias procedure:  ${e.pathAliasProcedure}`);
-			console.log(`Exclution list:        ${e.exclusionList?.join(', ')}`);
-			console.log(`Validation function:   ${e.requestValidationFunction}`);
-			console.log(`Error style:           ${e.errorStyle}`);
+			let transactionMode = '';
+			if (typeof e.transactionMode === 'string') {
+				transactionMode = e.transactionMode;
+			} else if (typeof e.transactionMode === 'function') {
+				transactionMode = 'custom callback';
+			}
+
+			console.log(`Route:                  http://localhost:${config.port}${e.route}`);
+			console.log(`Oracle user:            ${e.user}`);
+			console.log(`Oracle server:          ${e.connectString}`);
+			console.log(`Oracle document table:  ${e.documentTable}`);
+			console.log(`Default page:           ${e.defaultPage}`);
+			console.log(`Path alias:             ${e.pathAlias}`);
+			console.log(`Path alias procedure:   ${e.pathAliasProcedure}`);
+			console.log(`Exclution list:         ${e.exclusionList?.join(', ')}`);
+			console.log(`Validation function:    ${e.requestValidationFunction}`);
+			console.log(`After request handler:  ${transactionMode}`);
+			console.log(`Error style:            ${e.errorStyle}`);
 		});
 	}
 

package/src/server/server.js

@@ -67,20 +67,20 @@ export const createServer = (app, ssl) => {
 export const startServer = async (config, ssl) => {
 	debug('startServer: BEGIN', config, ssl);
 
-	config = z$configType.parse(config);
+	const internalConfig = /** @type {configType} */ (z$configType.parse(config));
 
-	showConfig(config);
+	showConfig(internalConfig);
 
 	// Create express app
 	const app = express();
 
 	// Access log
-	if (config.loggerFilename.length > 0) {
-		app.use(handlerLogger(config.loggerFilename));
+	if (internalConfig.loggerFilename.length > 0) {
+		app.use(handlerLogger(internalConfig.loggerFilename));
 	}
 
 	// Serving static files
-	for (const i of config.routeStatic) {
+	for (const i of internalConfig.routeStatic) {
 		app.use(i.route, express.static(i.directoryPath));
 	}
 
@@ -95,7 +95,7 @@ export const startServer = async (config, ssl) => {
 	const connectionPools = [];
 
 	// Oracle pl/sql express middleware
-	for (const i of config.routePlSql) {
+	for (const i of internalConfig.routePlSql) {
 		// Allocate the Oracle database pool
 		const pool = await poolCreate(i.user, i.password, i.connectString);
 		connectionPools.push(pool);
@@ -145,7 +145,7 @@ export const startServer = async (config, ssl) => {
 	await /** @type {Promise<void>} */ (
 		new Promise((resolve, reject) => {
 			server
-				.listen(config.port)
+				.listen(internalConfig.port)
 				.on('listening', () => {
 					debug('startServer: listener running');
 					resolve();
@@ -160,7 +160,7 @@ export const startServer = async (config, ssl) => {
 	debug('startServer: END');
 
 	return {
-		config,
+		config: internalConfig,
 		connectionPools,
 		app,
 		server,
@@ -173,7 +173,7 @@ export const startServer = async (config, ssl) => {
  * @param {string} [filename] - The configuration filename.
  * @returns {configType} - Promise.
  */
-export const loadConfig = (filename = 'config.json') => z$configType.parse(getJsonFile(filename));
+export const loadConfig = (filename = 'config.json') => /** @type {configType} */ (z$configType.parse(getJsonFile(filename)));
 
 /**
  * Start server from config file.

package/src/types.js

@@ -3,6 +3,7 @@ import z from 'zod';
 /**
  * @typedef {import('oracledb').BindParameter} BindParameter
  * @typedef {import('express').CookieOptions} CookieOptions
+ * @typedef {import('express').Request} Request
  */
 
 /**
@@ -20,6 +21,17 @@ export const z$configStaticType = z.strictObject({
 	directoryPath: z.string(),
 });
 
+/**
+ * @callback transactionCallbackType
+ * @param {Request} req - Incoming request object.
+ * @param {import('oracledb').Connection} connection - Active database connection pool.
+ * @returns {void | Promise<void>}
+ */
+
+/**
+ * @typedef {'commit' | 'rollback' | transactionCallbackType | undefined | null} transactionModeType
+ */
+
 /**
  * @typedef {object} configPlSqlHandlerType
  * @property {string} defaultPage - The default page.
@@ -29,6 +41,10 @@ export const z$configStaticType = z.strictObject({
  * @property {string[]} [exclusionList] - The exclusion list.
  * @property {string} [requestValidationFunction] - The request validation function.
  * @property {Record<string, string>} [cgi] - The additional CGI.
+ * @property {transactionModeType} [transactionMode='commit'] - Specifies an optional transaction mode.
+ * "commit" this automatically commits any open transaction after each request. This is the defaults because this is what mod_plsql and ohs are doing.
+ * "rollback" this automatically rolles back any open transaction after each request.
+ * "transactionCallbackType" this allows to defined a custom handler as a JavaScript function.
  * @property {errorStyleType} errorStyle - The error style.
  */
 export const z$configPlSqlHandlerType = z.strictObject({
@@ -38,6 +54,7 @@ export const z$configPlSqlHandlerType = z.strictObject({
 	documentTable: z.string(),
 	exclusionList: z.array(z.string()).optional(),
 	requestValidationFunction: z.string().optional(),
+	transactionMode: z.unknown().optional(),
 	errorStyle: z$errorStyleType,
 });
 

package/src/util/type.js

@@ -1,3 +1,5 @@
+/* eslint-disable jsdoc/no-undefined-types */
+
 /**
  *	Is the given value a string or an array of strings
  *	@param {unknown} value - The value to check.

package/types/types.d.ts

@@ -1,6 +1,7 @@
 /**
  * @typedef {import('oracledb').BindParameter} BindParameter
  * @typedef {import('express').CookieOptions} CookieOptions
+ * @typedef {import('express').Request} Request
  */
 /**
  * @typedef {'basic' | 'debug'} errorStyleType
@@ -18,6 +19,15 @@ export const z$configStaticType: z.ZodObject<{
     route: z.ZodString;
     directoryPath: z.ZodString;
 }, z.core.$strict>;
+/**
+ * @callback transactionCallbackType
+ * @param {Request} req - Incoming request object.
+ * @param {import('oracledb').Connection} connection - Active database connection pool.
+ * @returns {void | Promise<void>}
+ */
+/**
+ * @typedef {'commit' | 'rollback' | transactionCallbackType | undefined | null} transactionModeType
+ */
 /**
  * @typedef {object} configPlSqlHandlerType
  * @property {string} defaultPage - The default page.
@@ -27,6 +37,10 @@ export const z$configStaticType: z.ZodObject<{
  * @property {string[]} [exclusionList] - The exclusion list.
  * @property {string} [requestValidationFunction] - The request validation function.
  * @property {Record<string, string>} [cgi] - The additional CGI.
+ * @property {transactionModeType} [transactionMode='commit'] - Specifies an optional transaction mode.
+ * "commit" this automatically commits any open transaction after each request. This is the defaults because this is what mod_plsql and ohs are doing.
+ * "rollback" this automatically rolles back any open transaction after each request.
+ * "transactionCallbackType" this allows to defined a custom handler as a JavaScript function.
  * @property {errorStyleType} errorStyle - The error style.
  */
 export const z$configPlSqlHandlerType: z.ZodObject<{
@@ -36,6 +50,7 @@ export const z$configPlSqlHandlerType: z.ZodObject<{
     documentTable: z.ZodString;
     exclusionList: z.ZodOptional<z.ZodArray<z.ZodString>>;
     requestValidationFunction: z.ZodOptional<z.ZodString>;
+    transactionMode: z.ZodOptional<z.ZodUnknown>;
     errorStyle: z.ZodEnum<{
         basic: "basic";
         debug: "debug";
@@ -68,6 +83,7 @@ export const z$configPlSqlType: z.ZodObject<{
     documentTable: z.ZodString;
     exclusionList: z.ZodOptional<z.ZodArray<z.ZodString>>;
     requestValidationFunction: z.ZodOptional<z.ZodString>;
+    transactionMode: z.ZodOptional<z.ZodUnknown>;
     errorStyle: z.ZodEnum<{
         basic: "basic";
         debug: "debug";
@@ -97,6 +113,7 @@ export const z$configType: z.ZodObject<{
         documentTable: z.ZodString;
         exclusionList: z.ZodOptional<z.ZodArray<z.ZodString>>;
         requestValidationFunction: z.ZodOptional<z.ZodString>;
+        transactionMode: z.ZodOptional<z.ZodUnknown>;
         errorStyle: z.ZodEnum<{
             basic: "basic";
             debug: "debug";
@@ -106,6 +123,7 @@ export const z$configType: z.ZodObject<{
 }, z.core.$strict>;
 export type BindParameter = import("oracledb").BindParameter;
 export type CookieOptions = import("express").CookieOptions;
+export type Request = import("express").Request;
 export type errorStyleType = "basic" | "debug";
 export type configStaticType = {
     /**
@@ -117,6 +135,8 @@ export type configStaticType = {
      */
     directoryPath: string;
 };
+export type transactionCallbackType = (req: Request, connection: import("oracledb").Connection) => void | Promise<void>;
+export type transactionModeType = "commit" | "rollback" | transactionCallbackType | undefined | null;
 export type configPlSqlHandlerType = {
     /**
      * - The default page.
@@ -146,6 +166,13 @@ export type configPlSqlHandlerType = {
      * - The additional CGI.
      */
     cgi?: Record<string, string>;
+    /**
+     * - Specifies an optional transaction mode.
+     * "commit" this automatically commits any open transaction after each request. This is the defaults because this is what mod_plsql and ohs are doing.
+     * "rollback" this automatically rolles back any open transaction after each request.
+     * "transactionCallbackType" this allows to defined a custom handler as a JavaScript function.
+     */
+    transactionMode?: transactionModeType;
     /**
      * - The error style.
      */