web_plsql 1.2.0 → 1.3.1

package/src/util/trace.js

@@ -1,326 +0,0 @@
-/*
- *	Trace utilities
- */
-
-import * as rotatingFileStream from 'rotating-file-stream';
-import express from 'express';
-import util from 'node:util';
-import oracledb from 'oracledb';
-import {escapeHtml, convertAsciiToHtml} from './html.js';
-import {errorToString} from './errorToString.js';
-
-/**
- * @typedef {import('express').Request} Request
- * @typedef {import('../types.js').BindParameterConfig} BindParameterConfig
- * @typedef {import('../types.js').environmentType} environmentType
- * @typedef {{html: string; text: string}} outputType
- * @typedef {{type: 'error' | 'warning' | 'trace'; message: string; timestamp?: Date | null; req?: Request | null; environment?: environmentType | null, sql?: string | null; bind?: BindParameterConfig | null}} messageType
- */
-
-const SEPARATOR_H1 = '='.repeat(100);
-const SEPARATOR_H2 = '-'.repeat(30);
-
-/**
- * Return a string representation of the value.
- *
- * @param {unknown} value - Any value.
- * @param {number | null} depth - Specifies the number of times to recurse while formatting object.
- * @returns {string} - The string representation.
- */
-export const inspect = (value, depth = null) => {
-	try {
-		return util.inspect(value, {showHidden: false, depth, colors: false});
-	} catch (err) {
-		/* empty */
-	}
-
-	try {
-		return JSON.stringify(value);
-	} catch (err) {
-		/* empty */
-	}
-
-	return 'Unable to convert value to string';
-};
-
-/**
- * Return a tabular representation of the values.
- *
- * @param {string[]} head - The header values.
- * @param {string[][]} body - The row values.
- * @returns {outputType} - The output.
- */
-export const toTable = (head, body) => {
-	if (head.length === 0) {
-		throw new Error('head cannot be empty');
-	}
-
-	// Calculate column widths
-	const widths = head.map((h, i) => {
-		const bodyMax = Math.max(0, ...body.map((row) => (row[i] ?? '').length));
-		return Math.max(h.length, bodyMax);
-	});
-
-	// Build text representation
-	/**
-	 *	@param {string} cell - The string
-	 *	@param {number} width - The width
-	 *	@returns {string} - The result
-	 */
-	const padCell = (cell, width) => cell.padEnd(width, ' ');
-	const textHeader = head.map((h, i) => padCell(h, widths[i] ?? 0)).join(' | ');
-	const textSeparator = widths.map((w) => '-'.repeat(w ?? 0)).join('-+-');
-	const textRows = body.map((row) => head.map((_, i) => padCell(row[i] ?? '', widths[i] ?? 0)).join(' | '));
-	const text = [textHeader, textSeparator, ...textRows].join('\n');
-
-	const htmlHead = head.map((h) => `<th>${escapeHtml(h)}</th>`).join('');
-	const htmlBody = body.map((row) => `<tr>${head.map((_, i) => `<td>${escapeHtml(row[i] ?? '')}</td>`).join('')}</tr>`).join('');
-	const html = `<table><thead><tr>${htmlHead}</tr></thead><tbody>${htmlBody}</tbody></table>`;
-
-	return {text, html};
-};
-
-/**
- * Log text to the console and to a file.
- *
- * @param {string} text - Text to log.
- * @returns {void}
- */
-export const logToFile = (text) => {
-	const fs = rotatingFileStream.createStream('trace.log', {
-		size: '10M', // rotate every 10 MegaBytes written
-		interval: '1d', // rotate daily
-		maxFiles: 10, // maximum number of rotated files to keep
-		compress: 'gzip', // compress rotated files
-	});
-
-	fs.write(text);
-	fs.end();
-};
-
-/**
- * Return a string representation of the request.
- *
- * @param {express.Request} req - express.Request.
- * @param {boolean} simple - Set to false to see all public properties of the request.
- * @returns {string} - The string representation.
- */
-const inspectRequest = (req, simple = true) => {
-	/** @type {Record<string, unknown>} */
-	const requestData = {};
-
-	Object.keys(req)
-		.filter((prop) =>
-			simple ? ['originalUrl', 'params', 'query', 'url', 'method', 'body', 'files', 'secret', 'cookies'].includes(prop) : !prop.startsWith('_'),
-		)
-		.forEach((prop) => {
-			requestData[prop] = req[/** @type {keyof import('express').Request} */ (prop)];
-		});
-
-	return inspect(requestData);
-};
-
-/**
- *	Return a string representation of the bind parameter.
- *	@param {number | undefined} dir - The direction.
- *	@returns {string} The string.
- */
-const dirToString = (dir) => {
-	switch (dir) {
-		case oracledb.BIND_IN:
-			return 'IN';
-		case oracledb.BIND_OUT:
-			return 'OUT';
-		case oracledb.BIND_INOUT:
-			return 'INOUT';
-		default:
-			return '';
-	}
-};
-
-/**
- *	Return a string representation of the bind type.
- *	@param {oracledb.DbType | string | number | undefined} type - The type.
- *	@returns {string} The string.
- */
-const bindTypeToString = (type) => {
-	if (typeof type === 'object' && 'name' in type) {
-		return type.name;
-	}
-
-	if (typeof type === 'string') {
-		return type;
-	}
-
-	if (typeof type === 'number') {
-		return type.toString();
-	}
-
-	return '';
-};
-
-/**
- *	Return a string representation of the bind parameter.
- *	@param {outputType} output - The output.
- *	@param {BindParameterConfig} bind - The bind parameters.
- *	@returns {undefined}
- */
-const inspectBindParameter = (output, bind) => {
-	const rows = Object.entries(bind);
-
-	if (rows.length === 0) {
-		return;
-	}
-
-	const body = rows.map(([id, row]) => {
-		const dir = dirToString(row.dir);
-		const maxArraySize = row.maxArraySize ? row.maxArraySize.toString() : '';
-		const maxSize = row.maxSize ? row.maxSize.toString() : '';
-		const bindType = bindTypeToString(row.type);
-		const value = inspect(row.val);
-		const valueType = typeof row.val;
-
-		return [id, dir, maxArraySize, maxSize, bindType, value, valueType];
-	});
-
-	const {html, text} = toTable(['id', 'dir', 'maxArraySize', 'maxSize', 'bind type', 'value', 'value type'], body);
-
-	output.html += html;
-	output.text += text;
-};
-
-/**
- * Add environment
- *	@param {outputType} output - The output.
- *	@param {environmentType} environment - The environment.
- */
-const inspectEnvironment = (output, environment) => {
-	const rows = Object.entries(environment);
-
-	if (rows.length === 0) {
-		return;
-	}
-
-	const {html, text} = toTable(['key', 'value'], rows);
-
-	output.html += html;
-	output.text += text;
-};
-
-/**
- *	Get a block.
- *	@param {string} title - The name.
- *	@param {string} body - The name.
- *	@returns {string} - The text.
- */
-export const getBlock = (title, body) => `\n${SEPARATOR_H2}${title.toUpperCase()}${SEPARATOR_H2}\n${body}`;
-
-/**
- *	Get line html
- *	@param {string} text - The text.
- *	@returns {string} - The line.
- */
-const getLineHtml = (text) => `<p>${convertAsciiToHtml(text)}</p>`;
-
-/**
- *	Get line text
- *	@param {string} text - The text.
- *	@returns {string} - The line.
- */
-const getLineText = (text) => `${text}\n`;
-
-/**
- *	Add line
- *	@param {outputType} output - The output.
- *	@param {string} text - The text to convert.
- */
-const addLine = (output, text) => {
-	output.html += getLineHtml(text);
-	output.text += getLineText(text);
-};
-
-/**
- *	Add header
- *	@param {outputType} output - The output.
- *	@param {string} text - The text to convert.
- */
-const addHeader = (output, text) => {
-	output.html += `<h2>${text}</h2>`;
-	output.text += `\n${text}\n${'-'.repeat(text.length)}\n`;
-};
-
-/**
- *	Add procedure
- *	@param {outputType} output - The output.
- *	@param {string} sql - The SQL to execute.
- *	@param {BindParameterConfig} bind - The bind parameters.
- */
-const addProcedure = (output, sql, bind) => {
-	output.html += `${sql}<br><br>`;
-	output.text += `${sql}\n\n`;
-
-	try {
-		inspectBindParameter(output, bind);
-	} catch (err) {
-		addLine(output, `Unable to inspect bind parameter: ${errorToString(err)}`);
-	}
-
-	output.html += `<br>`;
-	output.text += `\n`;
-};
-
-/**
- *	Get a formatted message.
- *	@param {messageType} para - The req object represents the HTTP request.
- *	@returns {outputType} - The output.
- */
-export const getFormattedMessage = (para) => {
-	const timestamp = para.timestamp ?? new Date();
-
-	// header
-	const url = typeof para.req?.originalUrl === 'string' && para.req.originalUrl.length > 0 ? ` on ${para.req.originalUrl}` : '';
-	const type = (para.type ?? 'trace').toUpperCase();
-	const header = `${type} at ${timestamp.toUTCString()}${url}`;
-	const output = {
-		html: `<h1>${header}</h1>`,
-		text: `\n\n${SEPARATOR_H1}\n== ${header}\n${SEPARATOR_H1}\n`,
-	};
-
-	// error
-	addHeader(output, 'ERROR');
-	addLine(output, para.message);
-
-	// request
-	if (para.req) {
-		addHeader(output, 'REQUEST');
-		addLine(output, inspectRequest(para.req));
-	}
-
-	// parameters
-	if (para.sql && para.bind) {
-		addHeader(output, 'PROCEDURE');
-		addProcedure(output, para.sql, para.bind);
-	}
-
-	// environment
-	if (para.environment) {
-		addHeader(output, 'ENVIRONMENT');
-		inspectEnvironment(output, para.environment);
-	}
-
-	return output;
-};
-
-/**
- *	Log a warning message.
- *	@param {messageType} para - The req object represents the HTTP request.
- */
-export const warningMessage = (para) => {
-	const {text} = getFormattedMessage(para);
-
-	// trace to file
-	logToFile(text);
-
-	// console
-	console.warn(text);
-};

package/src/util/traceManager.js

@@ -1,68 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-
-/**
- * @typedef {import('../admin/js/types.js').TraceEntry} TraceEntry
- */
-
-class TraceManager {
-	constructor() {
-		this.enabled = false;
-		this.filename = 'trace.json.log';
-		this.maxEntries = 1000;
-	}
-
-	/**
-	 * Toggle tracing
-	 * @param {boolean} enabled - New state
-	 */
-	setEnabled(enabled) {
-		this.enabled = enabled;
-	}
-
-	/**
-	 * Is tracing enabled?
-	 * @returns {boolean} - The state
-	 */
-	isEnabled() {
-		return this.enabled;
-	}
-
-	/**
-	 * Add a trace entry
-	 * @param {object} entry - The trace entry
-	 */
-	addTrace(entry) {
-		if (!this.enabled) return;
-
-		try {
-			const line = JSON.stringify(entry) + '\n';
-			fs.appendFileSync(this.filename, line);
-		} catch (err) {
-			console.error('TraceManager: error writing trace', err);
-		}
-	}
-
-	/**
-	 * Clear all traces
-	 */
-	clear() {
-		try {
-			if (fs.existsSync(this.filename)) {
-				fs.truncateSync(this.filename, 0);
-			}
-		} catch (err) {
-			console.error('TraceManager: error clearing traces', err);
-		}
-	}
-
-	/**
-	 * Get the full path to the trace file
-	 * @returns {string} - The path
-	 */
-	getFilePath() {
-		return path.resolve(this.filename);
-	}
-}
-
-export const traceManager = new TraceManager();

package/src/util/type.js

@@ -1,6 +0,0 @@
-/**
- *	Is the given value a string or an array of strings
- *	@param {unknown} value - The value to check.
- *	@returns {value is string | string[]} - True if the value is a string or an array of strings
- */
-export const isStringOrArrayOfString = (value) => typeof value === 'string' || (Array.isArray(value) && value.every((element) => typeof element === 'string'));

package/src/util/util.js

@@ -1,66 +0,0 @@
-/**
- * Get duration as human readable string.
- * @param {number} duration - Milliseconds.
- * @returns {string} String.
- */
-export const humanDuration = (duration) => {
-	if (!Number.isFinite(duration)) return 'invalid';
-
-	const ms = Math.floor(duration % 1000);
-	const s = Math.floor((duration / 1000) % 60);
-	const m = Math.floor((duration / (1000 * 60)) % 60);
-	const h = Math.floor((duration / (1000 * 60 * 60)) % 24);
-	const d = Math.floor(duration / (1000 * 60 * 60 * 24));
-
-	const parts = [];
-	if (d) parts.push(`${d}d`);
-	if (h) parts.push(`${h}h`);
-	if (m) parts.push(`${m}m`);
-	if (s) parts.push(`${s}s`);
-	if (ms || !parts.length) parts.push(`${ms}ms`);
-
-	return parts.join(' ');
-};
-
-/**
- * Convert a string to a number
- *
- * @param {unknown} value - The string to convert
- * @returns {number | null} The number or null if the string could not be converted
- */
-export const stringToNumber = (value) => {
-	// is the value already of type number?
-	if (typeof value === 'number') {
-		return !Number.isNaN(value) && Number.isFinite(value) ? value : null;
-	}
-
-	// Test for invalid characters
-	if (typeof value !== 'string' || !/^[+-]?(?:\d+(?:\.\d+)?|\.\d+)(?:E[+-]?\d+)?$/i.test(value)) {
-		return null;
-	}
-
-	// Convert value to a number
-	const num = Number(value);
-	return Number.isNaN(num) ? null : num;
-};
-
-/**
- * Convert a string to a integer
- *
- * @param {unknown} value - The value to convert
- * @returns {number | null} The integer or null if the string could not be converted
- */
-export const stringToInteger = (value) => {
-	// is the value already a "real" integer, we just return the value
-	if (typeof value === 'number' && Number.isInteger(value)) {
-		return value;
-	}
-
-	// try to convert value to a number
-	const num = stringToNumber(value);
-	if (num === null || !Number.isInteger(num)) {
-		return null;
-	}
-
-	return num;
-};

package/src/version.js

@@ -1,5 +0,0 @@
-/**
- * Returns the current library version
- * @returns {string} - Version.
- */
-export const getVersion = () => '1.2.0';