web_plsql 1.0.0 → 1.3.0

package/dist/oracledb-mock-Dn8aHtd7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracledb-mock-Dn8aHtd7.mjs","names":[],"sources":["../src/backend/util/oracledb-mock.ts"],"sourcesContent":["import type {Connection, Pool, Lob, Result, BindParameters, ExecuteOptions, DbType} from 'oracledb';\n\n// Mock implementation\nexport type ExecuteCallback = (sql: string, binds?: BindParameters) => Promise<Result<unknown>> | Result<unknown>;\nlet executeCallback: ExecuteCallback | null = null;\n\n/**\n * Test utility: Set the callback for execute calls.\n * @param cb - The callback\n */\nexport const setExecuteCallback = (cb: ExecuteCallback | null) => {\n\texecuteCallback = cb;\n};\n\n/**\n * Mock LOB class.\n */\nclass MockLob {\n\ttype: DbType | number;\n\tconstructor(type: DbType | number) {\n\t\tthis.type = type;\n\t}\n\t// eslint-disable-next-line @typescript-eslint/no-empty-function\n\tdestroy(): void {}\n}\n\n/**\n * Mock Connection class.\n */\nclass MockConnection {\n\tasync execute<T = unknown>(sql: string, bindParams?: BindParameters, _options?: ExecuteOptions): Promise<Result<T>> {\n\t\tif (executeCallback) {\n\t\t\treturn (await executeCallback(sql, bindParams)) as Result<T>;\n\t\t}\n\t\treturn {rows: []} as Result<T>;\n\t}\n\n\t// eslint-disable-next-line @typescript-eslint/require-await\n\tasync createLob(type: DbType | number): Promise<Lob> {\n\t\treturn new MockLob(type) as unknown as Lob;\n\t}\n\n\tasync commit(): Promise<void> {\n\t\t// empty\n\t}\n\tasync rollback(): Promise<void> {\n\t\t// empty\n\t}\n\tasync release(): Promise<void> {\n\t\t// empty\n\t}\n}\n\n/**\n * Mock Pool class.\n */\nclass MockPool {\n\tconnectionsOpen = 0;\n\tconnectionsInUse = 0;\n\n\t// eslint-disable-next-line @typescript-eslint/require-await\n\tasync getConnection(): Promise<Connection> {\n\t\tthis.connectionsInUse++;\n\t\tthis.connectionsOpen = Math.max(this.connectionsOpen, this.connectionsInUse);\n\t\treturn new MockConnection() as unknown as Connection;\n\t}\n\n\t// eslint-disable-next-line @typescript-eslint/require-await\n\tasync close(_drainTime?: number): Promise<void> {\n\t\tthis.connectionsOpen = 0;\n\t\tthis.connectionsInUse = 0;\n\t}\n}\n\n/**\n * Mock createPool function.\n * @param _config - The configuration\n * @returns The pool\n */\n// eslint-disable-next-line @typescript-eslint/require-await\nexport async function createPool(_config: unknown): Promise<Pool> {\n\treturn new MockPool() as unknown as Pool;\n}\n\n// Default export mimics oracledb module structure for test mocking\nexport default {\n\t// Constants will be merged from actual oracledb by vi.importActual in test_setup.ts\n\tcreatePool,\n\tsetExecuteCallback,\n};\n"],"mappings":";;;;;;;AAIA,IAAI,kBAA0C;;;;;AAM9C,MAAa,sBAAsB,OAA+B;AACjE,mBAAkB;;;;;AAMnB,IAAM,UAAN,MAAc;CACb;CACA,YAAY,MAAuB;AAClC,OAAK,OAAO;;CAGb,UAAgB;;;;;AAMjB,IAAM,iBAAN,MAAqB;CACpB,MAAM,QAAqB,KAAa,YAA6B,UAA+C;AACnH,MAAI,gBACH,QAAQ,MAAM,gBAAgB,KAAK,WAAW;AAE/C,SAAO,EAAC,MAAM,EAAE,EAAC;;CAIlB,MAAM,UAAU,MAAqC;AACpD,SAAO,IAAI,QAAQ,KAAK;;CAGzB,MAAM,SAAwB;CAG9B,MAAM,WAA0B;CAGhC,MAAM,UAAyB;;;;;AAQhC,IAAM,WAAN,MAAe;CACd,kBAAkB;CAClB,mBAAmB;CAGnB,MAAM,gBAAqC;AAC1C,OAAK;AACL,OAAK,kBAAkB,KAAK,IAAI,KAAK,iBAAiB,KAAK,iBAAiB;AAC5E,SAAO,IAAI,gBAAgB;;CAI5B,MAAM,MAAM,YAAoC;AAC/C,OAAK,kBAAkB;AACvB,OAAK,mBAAmB;;;;;;;;AAU1B,eAAsB,WAAW,SAAiC;AACjE,QAAO,IAAI,UAAU"}

package/examples/config-apex.js

@@ -1,4 +1,4 @@
-import {startServer} from '../src/index.js';
+import {startServer} from '../src/index.ts';
 
 void startServer({
 	port: 80,

package/examples/config-docker.js

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
 
-// @ts-expect-error NOTE: the following import would show an error because the path does not exist
-import {startHttpServer} from './src/index.js';
+import {startHttpServer} from 'web_plsql';
 
 void startHttpServer({
 	port: 8888,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "web_plsql",
-	"version": "1.0.0",
+	"version": "1.3.0",
 	"author": "Dieter Oberkofler <dieter.oberkofler@gmail.com>",
 	"license": "MIT",
 	"description": "The Express Middleware for Oracle PL/SQL",
@@ -18,8 +18,7 @@
 	],
 	"homepage": "https://github.com/doberkofler/web_plsql",
 	"engines": {
-		"npm": ">=10.0.0",
-		"node": ">=22.0.0"
+		"node": ">=24"
 	},
 	"maintainers": [
 		{
@@ -35,67 +34,81 @@
 		"url": "git://github.com/doberkofler/web_plsql.git"
 	},
 	"files": [
-		"src/",
-		"examples/",
-		"types"
+		"dist/",
+		"examples/"
 	],
-	"main": "./src/index.js",
-	"types": "./types/index.d.ts",
+	"main": "./dist/index.mjs",
+	"types": "./dist/index.d.mts",
 	"type": "module",
 	"scripts": {
-		"build": "npm run build:admin",
-		"build:admin": "vite build",
-		"lint": "prettier --check --experimental-cli . && eslint . && tsc --noEmit && eslint src/admin --config src/admin/js/eslint.config.js",
+		"build": "npm run build:backend && npm run build:frontend",
+		"build:backend": "tsdown",
+		"build:frontend": "vite build",
+		"dev": "concurrently -n backend,frontend -c blue,green \"npm:dev:backend\" \"npm:dev:frontend\"",
+		"dev:backend": "node --experimental-strip-types --no-warnings dev/server.ts",
+		"dev:frontend": "vite",
+		"lint": "tsc --noEmit && eslint --no-cache . && prettier --check .",
+		"knip:backend": "knip --config knip.backend.config.ts",
+		"knip:frontend": "knip --config knip.frontend.config.ts",
 		"test": "vitest run",
+		"test:perf": "vitest run tests/performance.test.ts",
 		"test:coverage": "vitest run --coverage",
-		"stylelint": "stylelint \"src/admin/**/*.css\"",
-		"types": "rm -rf types && tsc  --noEmit false --declaration true --declarationDir types --emitDeclarationOnly true --allowJs true --target es2020 --module es2020 --moduleResolution node --allowSyntheticDefaultImports true src/*.js",
+		"test:e2e": "playwright test",
+		"test:e2e:ui": "playwright test --ui",
+		"test:e2e:debug": "playwright test --debug",
+		"stylelint": "stylelint \"src/frontend/**/*.css\"",
 		"clean": "shx rm -f *.tgz && shx rm -f *.log",
-		"version": "node update-version.js",
-		"prepack": "npm run ci",
-		"ci": "npm run clean && npm run version && npm run types && npm run build && npm run lint && npm run stylelint && npm run test:coverage",
-		"create-package": "shx rm -f *.tgz && npm pack",
-		"image-build": "docker build --no-cache --progress=plain --tag=web_plsql .",
-		"image-save": "docker save web_plsql | gzip > web_plsql.tar.gz"
+		"ci": "npm run clean && npm run lint && npm run build && npm run stylelint && npm run knip:backend && npm run knip:frontend && npm run test:coverage && npm run test:e2e",
+		"image-build": "cd docker && docker build --no-cache --progress=plain --tag=web_plsql .",
+		"image-save": "cd docker && docker save web_plsql > web_plsql.tar",
+		"pack:dev": "VERSION=$(node -p 'require(\"./package.json\").version'); npm pack; mv web_plsql-$VERSION.tgz web_plsql-dev.tgz"
 	},
 	"peerDependencies": {
 		"oracledb": "6.10.0"
 	},
 	"dependencies": {
-		"chart.js": "^4.5.1",
+		"chart.js": "4.5.1",
 		"compression": "1.8.1",
 		"cookie-parser": "1.4.7",
+		"cors": "2.8.6",
 		"debug": "4.4.3",
 		"express": "5.2.1",
-		"http-parser-js": "0.5.10",
+		"express-static-gzip": "3.0.0",
 		"morgan": "1.10.1",
 		"multer": "2.0.2",
 		"rotating-file-stream": "3.2.8",
-		"zod": "^4.3.6"
+		"zod": "4.3.6"
 	},
 	"devDependencies": {
-		"@tailwindcss/vite": "^4.1.18",
+		"@playwright/test": "1.58.2",
+		"@tailwindcss/vite": "4.1.18",
 		"@types/compression": "1.8.1",
 		"@types/cookie-parser": "1.4.10",
+		"@types/cors": "2.8.19",
 		"@types/debug": "4.1.12",
 		"@types/morgan": "1.9.10",
 		"@types/multer": "2.0.0",
-		"@types/node": "25.2.1",
+		"@types/node": "25.2.3",
 		"@types/oracledb": "6.10.1",
 		"@types/supertest": "6.0.3",
-		"@vitest/coverage-v8": "^4.0.18",
+		"@vitest/coverage-v8": "4.0.18",
+		"cheerio": "1.2.0",
+		"concurrently": "9.2.1",
 		"eslint": "9.39.2",
-		"eslint-plugin-jsdoc": "62.5.3",
+		"eslint-plugin-jsdoc": "62.5.4",
+		"knip": "5.83.1",
 		"oracledb": "6.10.0",
 		"prettier": "3.8.1",
 		"shx": "0.4.0",
-		"stylelint": "^17.1.1",
-		"stylelint-config-standard": "^40.0.0",
+		"stylelint": "17.3.0",
+		"stylelint-config-standard": "40.0.0",
 		"supertest": "7.2.2",
-		"tailwindcss": "^4.1.18",
+		"tailwindcss": "4.1.18",
+		"tsdown": "0.20.3",
 		"typescript": "5.9.3",
-		"typescript-eslint": "8.54.0",
-		"vite": "^7.3.1",
-		"vitest": "^4.0.18"
+		"typescript-eslint": "8.55.0",
+		"vite": "7.3.1",
+		"vite-plugin-compression2": "2.4.0",
+		"vitest": "4.0.18"
 	}
 }

package/examples/config-native.js

@@ -1,68 +0,0 @@
-#!/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,
-	routeStatic: [
-		{
-			route: '/static',
-			directoryPath: 'examples/static',
-		},
-	],
-	routePlSql: [
-		{
-			route: '/sample',
-			user: 'sample', // PlsqlDatabaseUserName
-			password: 'sample', // PlsqlDatabasePassword
-			connectString: process.env.WEB_PLSQL_ORACLE_SERVER ?? 'localhost:1521/TEST', // PlsqlDatabaseConnectString
-			defaultPage: 'sample_pkg.page_index', // PlsqlDefaultPage
-			documentTable: 'doctable', // PlsqlDocumentTablename
-			exclusionList: ['sample_pkg.page_exclusion_list'], // PlsqlExclusionList
-			requestValidationFunction: 'sample_pkg.request_validation_function', // PlsqlRequestValidationFunction
-			pathAlias: 'myalias', // PlsqlPathAlias
-			pathAliasProcedure: 'sample_pkg.page_path_alias', // PlsqlPathAliasProcedure
-			//transactionMode: 'commit',
-			transactionMode: async (connection, procedure) => {
-				if (await hasOpenTransaction(connection)) {
-					console.log(`We detected an open transaction in "${procedure}"`);
-				}
-			},
-			errorStyle: 'debug', // PlsqlErrorStyle
-		},
-	],
-	loggerFilename: 'access.log', // PlsqlLogEnable and PlsqlLogDirectory
-});

package/src/admin/client/charts.ts

@@ -1,299 +0,0 @@
-import {Chart, registerables} from 'chart.js';
-import type {State, ChartInstance} from '../js/types.js';
-import type {StatusResponse} from '../js/schemas.js';
-
-// Register Chart.js components
-Chart.register(...registerables);
-
-/**
- * Cache pie chart instances.
- */
-const cachePieInstances = new Map<HTMLCanvasElement, Chart>();
-
-type PoolInfo = StatusResponse['pools'][number];
-
-/**
- * Chart colors based on theme mode.
- */
-type ChartColors = {
-	gridColor: string;
-	textColor: string;
-};
-
-/**
- * Get chart colors for the current theme.
- * @param isDark - Whether dark mode is active.
- * @returns Chart color configuration.
- */
-function getChartColors(isDark: boolean): ChartColors {
-	return {
-		gridColor: isDark ? 'rgba(255,255,255,0.1)' : 'rgba(0,0,0,0.1)',
-		textColor: isDark ? '#94a3b8' : '#475569',
-	};
-}
-
-/**
- * Initialize charts.
- * @param state - Application state.
- */
-export function initCharts(state: State): void {
-	const isDark = document.body.classList.contains('dark');
-	const colors = getChartColors(isDark);
-
-	const trafficEl = document.getElementById('traffic-chart') as HTMLCanvasElement | null;
-	if (trafficEl) {
-		const chartData = {
-			labels: [],
-			datasets: [
-				{
-					label: 'Requests/s',
-					data: [],
-					borderColor: '#3b82f6',
-					backgroundColor: 'rgba(59, 130, 246, 0.1)',
-					fill: true,
-					tension: 0.4,
-					yAxisID: 'y',
-				},
-				{
-					label: 'Avg Response Time (ms)',
-					data: [],
-					borderColor: '#10b981',
-					backgroundColor: 'rgba(16, 185, 129, 0.1)',
-					fill: true,
-					tension: 0.4,
-					yAxisID: 'y1',
-				},
-			],
-		};
-
-		const chartOptions = {
-			responsive: true,
-			maintainAspectRatio: false,
-			scales: {
-				x: {
-					grid: {color: colors.gridColor},
-					ticks: {
-						color: colors.textColor,
-						maxRotation: 0,
-						autoSkip: true,
-						maxTicksLimit: 10,
-					},
-					title: {
-						display: true,
-						text: 'Time',
-						color: colors.textColor,
-					},
-				},
-				y: {
-					type: 'linear' as const,
-					display: true,
-					position: 'left' as const,
-					grid: {color: colors.gridColor},
-					ticks: {color: colors.textColor},
-					beginAtZero: true,
-					title: {
-						display: true,
-						text: 'Requests/s',
-						color: colors.textColor,
-					},
-				},
-				y1: {
-					type: 'linear' as const,
-					display: true,
-					position: 'right' as const,
-					grid: {drawOnChartArea: false, color: colors.gridColor},
-					ticks: {color: '#10b981'},
-					beginAtZero: true,
-					title: {
-						display: true,
-						text: 'Avg Response Time (ms)',
-						color: '#10b981',
-					},
-				},
-			},
-			plugins: {
-				legend: {
-					labels: {color: colors.textColor},
-				},
-			},
-		};
-
-		const chart = new Chart(trafficEl, {
-			type: 'line',
-			data: chartData,
-			options: chartOptions,
-		});
-
-		state.charts.traffic = {
-			data: chartData,
-			options: chartOptions,
-			update: () => chart.update(),
-		} as ChartInstance;
-	}
-
-	const poolEl = document.getElementById('pool-chart') as HTMLCanvasElement | null;
-	if (poolEl) {
-		const chartData = {
-			labels: [],
-			datasets: [],
-		};
-
-		const chartOptions = {
-			responsive: true,
-			maintainAspectRatio: false,
-			scales: {
-				x: {
-					grid: {color: colors.gridColor},
-					ticks: {
-						color: colors.textColor,
-						maxRotation: 0,
-						autoSkip: true,
-						maxTicksLimit: 10,
-					},
-					title: {
-						display: true,
-						text: 'Time',
-						color: colors.textColor,
-					},
-				},
-				y: {
-					grid: {color: colors.gridColor},
-					ticks: {color: colors.textColor},
-					beginAtZero: true,
-					title: {
-						display: true,
-						text: 'Connections',
-						color: colors.textColor,
-					},
-				},
-			},
-			plugins: {
-				legend: {
-					labels: {color: colors.textColor},
-				},
-			},
-		};
-
-		const chart = new Chart(poolEl, {
-			type: 'line',
-			data: chartData,
-			options: chartOptions,
-		});
-
-		state.charts.pool = {
-			data: chartData,
-			options: chartOptions,
-			update: () => chart.update(),
-		} as ChartInstance;
-	}
-}
-
-/**
- * Update charts with new data.
- * @param state - Application state.
- * @param timeLabel - Time label for the data point.
- * @param reqPerSec - Requests per second.
- * @param avgResponseTime - Average response time in ms.
- * @param pools - Pool information.
- */
-export function updateCharts(state: State, timeLabel: string, reqPerSec: number, avgResponseTime: number, pools: PoolInfo[]): void {
-	const maxPoints = state.maxHistoryPoints;
-
-	state.history.labels.push(timeLabel);
-	state.history.requests.push(reqPerSec);
-	state.history.avgResponseTimes.push(avgResponseTime);
-
-	if (state.history.labels.length > maxPoints) {
-		state.history.labels.shift();
-		state.history.requests.shift();
-		state.history.avgResponseTimes.shift();
-	}
-
-	const trafficChart = state.charts.traffic;
-	if (trafficChart?.data.datasets[0] && trafficChart.data.datasets[1]) {
-		trafficChart.data.labels = state.history.labels;
-		trafficChart.data.datasets[0].data = state.history.requests;
-		trafficChart.data.datasets[1].data = state.history.avgResponseTimes;
-		trafficChart.update();
-	}
-
-	const poolChart = state.charts.pool;
-	if (poolChart) {
-		poolChart.data.labels = state.history.labels;
-		pools.forEach((p, i) => {
-			const poolName = p.name;
-			const history = state.history;
-			let usage = history.poolUsage[poolName];
-			if (!usage) {
-				usage = [];
-				history.poolUsage[poolName] = usage;
-				const colors = ['#10b981', '#f59e0b', '#3b82f6', '#8b5cf6', '#ec4899'];
-				const color = colors[i % colors.length];
-				if (color) {
-					poolChart.data.datasets.push({
-						label: poolName,
-						data: usage,
-						borderColor: color,
-						backgroundColor: undefined,
-						fill: undefined,
-						tension: 0.4,
-					});
-				}
-			}
-			usage.push(p.connectionsInUse);
-			if (usage.length > maxPoints) {
-				usage.shift();
-			}
-		});
-		poolChart.update();
-	}
-}
-
-/**
- * Create or update a pie chart for cache statistics.
- * @param canvas - The canvas element.
- */
-export function renderCachePie(canvas: HTMLCanvasElement): void {
-	const hits = parseInt(canvas.dataset.hits ?? '0');
-	const misses = parseInt(canvas.dataset.misses ?? '0');
-
-	const existingChart = cachePieInstances.get(canvas);
-	if (existingChart?.data.datasets[0]) {
-		existingChart.data.datasets[0].data = [hits, misses];
-		existingChart.update();
-		return;
-	}
-
-	const chart = new Chart(canvas, {
-		type: 'pie',
-		data: {
-			labels: ['Hits', 'Misses'],
-			datasets: [
-				{
-					data: [hits, misses],
-					backgroundColor: ['#10b981', '#ef4444'],
-					borderColor: 'transparent',
-				},
-			],
-		},
-		options: {
-			responsive: true,
-			maintainAspectRatio: true,
-			plugins: {
-				legend: {display: false},
-				tooltip: {
-					callbacks: {
-						label: (context) => {
-							const value = context.raw as number;
-							const total = hits + misses;
-							const pct = total > 0 ? ((value / total) * 100).toFixed(1) : '0';
-							return `${context.label}: ${value} (${pct}%)`;
-						},
-					},
-				},
-			},
-		},
-	});
-
-	cachePieInstances.set(canvas, chart);
-}

package/src/admin/client/main.js

@@ -1,3 +0,0 @@
-import '../js/api.js';
-import '../js/app.js';
-import './tailwind.css';

package/src/admin/client/tailwind.css

@@ -1,41 +0,0 @@
-@import 'tailwindcss';
-
-@theme {
-	--color-primary: #3b82f6;
-	--color-success: #10b981;
-	--color-warning: #f59e0b;
-	--color-danger: #ef4444;
-}
-
-body {
-	font-family:
-		'Inter',
-		-apple-system,
-		BlinkMacSystemFont,
-		'Segoe UI',
-		Roboto,
-		Helvetica,
-		Arial,
-		sans-serif;
-	-webkit-font-smoothing: antialiased;
-}
-
-body.dark {
-	--bg-main: #0f172a;
-	--bg-side: #1e293b;
-	--bg-card: #1e293b;
-	--bg-hover: #334155;
-	--text-main: #94a3b8;
-	--text-bright: #f8fafc;
-	--border: #334155;
-}
-
-body:not(.dark) {
-	--bg-main: #f8fafc;
-	--bg-side: #ffffff;
-	--bg-card: #ffffff;
-	--bg-hover: #f1f5f9;
-	--text-main: #475569;
-	--text-bright: #0f172a;
-	--border: #e2e8f0;
-}