@lara-node/db 0.1.0

package/dist/connection.cjs

@@ -0,0 +1,286 @@
+const require_chunk = require("./chunk.cjs");
+let mysql2_promise = require("mysql2/promise");
+mysql2_promise = require_chunk.__toESM(mysql2_promise, 1);
+let fs = require("fs");
+fs = require_chunk.__toESM(fs, 1);
+let mongodb = require("mongodb");
+//#region src/QueryInstrumentation.ts
+/** Compact JSON string of a MongoDB filter/pipeline argument (max 300 chars). */
+function mongoArgSummary(val) {
+	try {
+		return JSON.stringify(val ?? {}).slice(0, 300);
+	} catch {
+		return "{}";
+	}
+}
+/** Optional hook registered by Telescope/events layer — avoids circular deps. */
+let _queryEventHook = null;
+/** Called by @lara-node/telescope or @lara-node/events to wire up query event emission. */
+function setQueryEventHook(hook) {
+	_queryEventHook = hook;
+}
+/** Emit a query event via the registered hook (no-op if none registered). */
+async function emitQueryEvent(payload) {
+	if (_queryEventHook) await _queryEventHook(payload).catch(() => {});
+}
+/** Promise-based MongoDB operations that resolve with a result directly. */
+const MONGO_PROMISE_OPS = new Set([
+	"insertOne",
+	"insertMany",
+	"updateOne",
+	"updateMany",
+	"replaceOne",
+	"deleteOne",
+	"deleteMany",
+	"findOne",
+	"findOneAndUpdate",
+	"findOneAndDelete",
+	"findOneAndReplace",
+	"countDocuments",
+	"estimatedDocumentCount",
+	"distinct",
+	"bulkWrite"
+]);
+/** Cursor-returning MongoDB operations — we instrument toArray(). */
+const MONGO_CURSOR_OPS = new Set([
+	"find",
+	"aggregate",
+	"listIndexes"
+]);
+/**
+* Wraps a MongoCollection in a Proxy that times every operation and calls
+* emitQueryEvent() so Telescope captures it regardless of which process runs it.
+*/
+function createMongoQueryProxy(collectionName, col) {
+	const emit = (op, filter, durationMs, rows, error) => {
+		emitQueryEvent({
+			sql: `${collectionName}.${op}(${mongoArgSummary(filter)})`,
+			duration: durationMs,
+			rows,
+			error,
+			connection: "mongodb",
+			collection: collectionName
+		}).catch(() => {});
+	};
+	return new Proxy(col, { get(target, prop) {
+		const value = target[prop];
+		if (typeof prop !== "string" || typeof value !== "function") return value;
+		if (MONGO_PROMISE_OPS.has(prop)) return (...args) => {
+			const start = process.hrtime.bigint();
+			const filter = args[0];
+			return value.apply(target, args).then((res) => {
+				emit(prop, filter, Number((process.hrtime.bigint() - start) / 1000000n), res == null ? 0 : Array.isArray(res) ? res.length : res.insertedCount ?? res.modifiedCount ?? res.deletedCount ?? 1);
+				return res;
+			}).catch((err) => {
+				emit(prop, filter, Number((process.hrtime.bigint() - start) / 1000000n), 0, err.message);
+				throw err;
+			});
+		};
+		if (MONGO_CURSOR_OPS.has(prop)) return (...args) => {
+			const start = process.hrtime.bigint();
+			const filter = args[0];
+			const cursor = value.apply(target, args);
+			const origToArray = cursor.toArray.bind(cursor);
+			cursor.toArray = async () => {
+				try {
+					const rows = await origToArray();
+					emit(prop, filter, Number((process.hrtime.bigint() - start) / 1000000n), rows.length);
+					return rows;
+				} catch (err) {
+					emit(prop, filter, Number((process.hrtime.bigint() - start) / 1000000n), 0, err.message);
+					throw err;
+				}
+			};
+			return cursor;
+		};
+		return value.bind(target);
+	} });
+}
+/** The Cache key pattern used for cross-process query entries. */
+const TELESCOPE_QUERY_CACHE_KEY = `${process.env.APP_NAME || "app"}:telescope:queries`;
+//#endregion
+//#region src/connection.ts
+const dbType = (process.env.DB_CONNECTION || process.env.DB_DRIVER || "mysql").toLowerCase();
+const dbHost = process.env.DB_HOST || "localhost";
+const dbUser = process.env.DB_USER || "root";
+const dbPassword = process.env.DB_PASSWORD || "";
+const dbName = process.env.DB_NAME || "test";
+const dbPort = process.env.DB_PORT ? parseInt(process.env.DB_PORT, 10) : void 0;
+const socketPath = process.env.DB_SOCKET_PATH || process.env.DB_SOCKET || void 0;
+const baseOptions = {
+	waitForConnections: true,
+	connectionLimit: parseInt(process.env.DB_POOL_LIMIT || "10", 10),
+	queueLimit: 0,
+	multipleStatements: true
+};
+let pool;
+let mongoDb;
+function ensureMysqlPool() {
+	if (pool) return pool;
+	pool = mysql2_promise.default.createPool(socketPath ? {
+		...baseOptions,
+		user: dbUser,
+		password: dbPassword,
+		database: dbName,
+		socketPath
+	} : {
+		...baseOptions,
+		host: dbHost,
+		user: dbUser,
+		password: dbPassword,
+		database: dbName,
+		port: dbPort
+	});
+	return pool;
+}
+function getDbType() {
+	return dbType;
+}
+async function query(sql, params = []) {
+	if (dbType === "mysql") {
+		const [rows] = await ensureMysqlPool().query(sql, params);
+		return rows;
+	}
+	throw new Error("query(sql, params) is not supported for MongoDB. Use the Mongo helpers (collection, getMongoDb).");
+}
+async function initDatabase() {
+	if (dbType === "mysql") {
+		let conn;
+		try {
+			conn = await ensureMysqlPool().getConnection();
+			await conn.ping();
+		} catch (err) {
+			const triedSockets = [];
+			if (!socketPath) {
+				for (const pth of [
+					"/var/run/mysqld/mysqld.sock",
+					"/tmp/mysql.sock",
+					"/var/lib/mysql/mysql.sock"
+				]) try {
+					if (!fs.default.existsSync(pth)) continue;
+					triedSockets.push(pth);
+					pool = mysql2_promise.default.createPool({
+						...baseOptions,
+						user: dbUser,
+						password: dbPassword,
+						database: dbName,
+						socketPath: pth
+					});
+					conn = await pool.getConnection();
+					await conn.ping();
+					return;
+				} catch (e) {
+					continue;
+				} finally {
+					if (conn) {
+						try {
+							conn.release();
+						} catch (_) {}
+						conn = void 0;
+					}
+				}
+				if (triedSockets.length) err.message = `${err.message} (attempted sockets: ${triedSockets.join(", ")})`;
+			}
+			const hintLines = [];
+			if (err && err.code && String(err.code).startsWith("ER_ACCESS_DENIED")) hintLines.push("Access denied: verify DB_USER/DB_PASSWORD and that the user has permissions on DB_NAME.", "On many Linux setups, MySQL 'root' uses auth_socket and can't login with a blank password.", "Either create a dedicated user, set a proper password, or use DB_SOCKET_PATH if using a local socket.");
+			if (!process.env.DB_USER) hintLines.push("DB_USER is not set in your environment/.env; set it (e.g., DB_USER=rentivo)");
+			if (!dbName) hintLines.push("DB_NAME is empty; set it in your .env (e.g., DB_NAME=rentivo).");
+			if (!socketPath && !dbHost) hintLines.push("DB_HOST is empty; set DB_HOST or DB_SOCKET_PATH in your .env.");
+			const help = hintLines.length ? `\nHints:\n- ${hintLines.join("\n- ")}` : "";
+			const safeTarget = socketPath ? `socket ${socketPath}` : `${dbHost}${dbPort ? ":" + dbPort : ""}`;
+			throw new Error(`Database ping failed for ${safeTarget} as '${dbUser}' on schema '${dbName}'. Original: ${err?.message || err}${help}`);
+		} finally {
+			if (conn) conn.release();
+		}
+		return;
+	}
+	if (mongoDb) return;
+	const mongoUri = process.env.MONGO_URI || process.env.MONGODB_URI || `mongodb://${dbHost}:${dbPort || 27017}`;
+	const replicaSet = process.env.MONGO_REPLICA_SET || void 0;
+	const isReplicaSet = !!replicaSet || process.env.MONGO_DIRECT_CONNECTION === "false";
+	const directConnection = process.env.MONGO_DIRECT_CONNECTION === "true" ? true : process.env.MONGO_DIRECT_CONNECTION === "false" ? false : !isReplicaSet;
+	const clientOptions = {
+		serverSelectionTimeoutMS: 1e4,
+		retryWrites: process.env.MONGO_RETRY_WRITES === "true" ? true : process.env.MONGO_RETRY_WRITES === "false" ? false : isReplicaSet
+	};
+	if (!isReplicaSet) clientOptions.directConnection = directConnection;
+	if (replicaSet) clientOptions.replicaSet = replicaSet;
+	const client = new mongodb.MongoClient(mongoUri, clientOptions);
+	await client.connect();
+	mongoDb = client.db(dbName);
+	await mongoDb.command({ ping: 1 });
+}
+function getPool() {
+	if (dbType !== "mysql") throw new Error("getPool() only valid for MySQL");
+	return ensureMysqlPool();
+}
+function getMongoDb() {
+	if (dbType !== "mongodb") throw new Error("getMongoDb() only valid for MongoDB");
+	if (!mongoDb) throw new Error("MongoDB not initialized. Call initDatabase() first.");
+	return mongoDb;
+}
+function collection(name) {
+	return createMongoQueryProxy(name, getMongoDb().collection(name));
+}
+dbType === "mysql" && ensureMysqlPool();
+//#endregion
+Object.defineProperty(exports, "TELESCOPE_QUERY_CACHE_KEY", {
+	enumerable: true,
+	get: function() {
+		return TELESCOPE_QUERY_CACHE_KEY;
+	}
+});
+Object.defineProperty(exports, "collection", {
+	enumerable: true,
+	get: function() {
+		return collection;
+	}
+});
+Object.defineProperty(exports, "createMongoQueryProxy", {
+	enumerable: true,
+	get: function() {
+		return createMongoQueryProxy;
+	}
+});
+Object.defineProperty(exports, "emitQueryEvent", {
+	enumerable: true,
+	get: function() {
+		return emitQueryEvent;
+	}
+});
+Object.defineProperty(exports, "getDbType", {
+	enumerable: true,
+	get: function() {
+		return getDbType;
+	}
+});
+Object.defineProperty(exports, "getMongoDb", {
+	enumerable: true,
+	get: function() {
+		return getMongoDb;
+	}
+});
+Object.defineProperty(exports, "getPool", {
+	enumerable: true,
+	get: function() {
+		return getPool;
+	}
+});
+Object.defineProperty(exports, "initDatabase", {
+	enumerable: true,
+	get: function() {
+		return initDatabase;
+	}
+});
+Object.defineProperty(exports, "query", {
+	enumerable: true,
+	get: function() {
+		return query;
+	}
+});
+Object.defineProperty(exports, "setQueryEventHook", {
+	enumerable: true,
+	get: function() {
+		return setQueryEventHook;
+	}
+});

package/dist/connection.js

@@ -0,0 +1,226 @@
+import mysql from "mysql2/promise";
+import fs from "fs";
+import { MongoClient } from "mongodb";
+//#region src/QueryInstrumentation.ts
+/** Compact JSON string of a MongoDB filter/pipeline argument (max 300 chars). */
+function mongoArgSummary(val) {
+	try {
+		return JSON.stringify(val ?? {}).slice(0, 300);
+	} catch {
+		return "{}";
+	}
+}
+/** Optional hook registered by Telescope/events layer — avoids circular deps. */
+let _queryEventHook = null;
+/** Called by @lara-node/telescope or @lara-node/events to wire up query event emission. */
+function setQueryEventHook(hook) {
+	_queryEventHook = hook;
+}
+/** Emit a query event via the registered hook (no-op if none registered). */
+async function emitQueryEvent(payload) {
+	if (_queryEventHook) await _queryEventHook(payload).catch(() => {});
+}
+/** Promise-based MongoDB operations that resolve with a result directly. */
+const MONGO_PROMISE_OPS = new Set([
+	"insertOne",
+	"insertMany",
+	"updateOne",
+	"updateMany",
+	"replaceOne",
+	"deleteOne",
+	"deleteMany",
+	"findOne",
+	"findOneAndUpdate",
+	"findOneAndDelete",
+	"findOneAndReplace",
+	"countDocuments",
+	"estimatedDocumentCount",
+	"distinct",
+	"bulkWrite"
+]);
+/** Cursor-returning MongoDB operations — we instrument toArray(). */
+const MONGO_CURSOR_OPS = new Set([
+	"find",
+	"aggregate",
+	"listIndexes"
+]);
+/**
+* Wraps a MongoCollection in a Proxy that times every operation and calls
+* emitQueryEvent() so Telescope captures it regardless of which process runs it.
+*/
+function createMongoQueryProxy(collectionName, col) {
+	const emit = (op, filter, durationMs, rows, error) => {
+		emitQueryEvent({
+			sql: `${collectionName}.${op}(${mongoArgSummary(filter)})`,
+			duration: durationMs,
+			rows,
+			error,
+			connection: "mongodb",
+			collection: collectionName
+		}).catch(() => {});
+	};
+	return new Proxy(col, { get(target, prop) {
+		const value = target[prop];
+		if (typeof prop !== "string" || typeof value !== "function") return value;
+		if (MONGO_PROMISE_OPS.has(prop)) return (...args) => {
+			const start = process.hrtime.bigint();
+			const filter = args[0];
+			return value.apply(target, args).then((res) => {
+				emit(prop, filter, Number((process.hrtime.bigint() - start) / 1000000n), res == null ? 0 : Array.isArray(res) ? res.length : res.insertedCount ?? res.modifiedCount ?? res.deletedCount ?? 1);
+				return res;
+			}).catch((err) => {
+				emit(prop, filter, Number((process.hrtime.bigint() - start) / 1000000n), 0, err.message);
+				throw err;
+			});
+		};
+		if (MONGO_CURSOR_OPS.has(prop)) return (...args) => {
+			const start = process.hrtime.bigint();
+			const filter = args[0];
+			const cursor = value.apply(target, args);
+			const origToArray = cursor.toArray.bind(cursor);
+			cursor.toArray = async () => {
+				try {
+					const rows = await origToArray();
+					emit(prop, filter, Number((process.hrtime.bigint() - start) / 1000000n), rows.length);
+					return rows;
+				} catch (err) {
+					emit(prop, filter, Number((process.hrtime.bigint() - start) / 1000000n), 0, err.message);
+					throw err;
+				}
+			};
+			return cursor;
+		};
+		return value.bind(target);
+	} });
+}
+/** The Cache key pattern used for cross-process query entries. */
+const TELESCOPE_QUERY_CACHE_KEY = `${process.env.APP_NAME || "app"}:telescope:queries`;
+//#endregion
+//#region src/connection.ts
+const dbType = (process.env.DB_CONNECTION || process.env.DB_DRIVER || "mysql").toLowerCase();
+const dbHost = process.env.DB_HOST || "localhost";
+const dbUser = process.env.DB_USER || "root";
+const dbPassword = process.env.DB_PASSWORD || "";
+const dbName = process.env.DB_NAME || "test";
+const dbPort = process.env.DB_PORT ? parseInt(process.env.DB_PORT, 10) : void 0;
+const socketPath = process.env.DB_SOCKET_PATH || process.env.DB_SOCKET || void 0;
+const baseOptions = {
+	waitForConnections: true,
+	connectionLimit: parseInt(process.env.DB_POOL_LIMIT || "10", 10),
+	queueLimit: 0,
+	multipleStatements: true
+};
+let pool;
+let mongoDb;
+function ensureMysqlPool() {
+	if (pool) return pool;
+	pool = mysql.createPool(socketPath ? {
+		...baseOptions,
+		user: dbUser,
+		password: dbPassword,
+		database: dbName,
+		socketPath
+	} : {
+		...baseOptions,
+		host: dbHost,
+		user: dbUser,
+		password: dbPassword,
+		database: dbName,
+		port: dbPort
+	});
+	return pool;
+}
+function getDbType() {
+	return dbType;
+}
+async function query(sql, params = []) {
+	if (dbType === "mysql") {
+		const [rows] = await ensureMysqlPool().query(sql, params);
+		return rows;
+	}
+	throw new Error("query(sql, params) is not supported for MongoDB. Use the Mongo helpers (collection, getMongoDb).");
+}
+async function initDatabase() {
+	if (dbType === "mysql") {
+		let conn;
+		try {
+			conn = await ensureMysqlPool().getConnection();
+			await conn.ping();
+		} catch (err) {
+			const triedSockets = [];
+			if (!socketPath) {
+				for (const pth of [
+					"/var/run/mysqld/mysqld.sock",
+					"/tmp/mysql.sock",
+					"/var/lib/mysql/mysql.sock"
+				]) try {
+					if (!fs.existsSync(pth)) continue;
+					triedSockets.push(pth);
+					pool = mysql.createPool({
+						...baseOptions,
+						user: dbUser,
+						password: dbPassword,
+						database: dbName,
+						socketPath: pth
+					});
+					conn = await pool.getConnection();
+					await conn.ping();
+					return;
+				} catch (e) {
+					continue;
+				} finally {
+					if (conn) {
+						try {
+							conn.release();
+						} catch (_) {}
+						conn = void 0;
+					}
+				}
+				if (triedSockets.length) err.message = `${err.message} (attempted sockets: ${triedSockets.join(", ")})`;
+			}
+			const hintLines = [];
+			if (err && err.code && String(err.code).startsWith("ER_ACCESS_DENIED")) hintLines.push("Access denied: verify DB_USER/DB_PASSWORD and that the user has permissions on DB_NAME.", "On many Linux setups, MySQL 'root' uses auth_socket and can't login with a blank password.", "Either create a dedicated user, set a proper password, or use DB_SOCKET_PATH if using a local socket.");
+			if (!process.env.DB_USER) hintLines.push("DB_USER is not set in your environment/.env; set it (e.g., DB_USER=rentivo)");
+			if (!dbName) hintLines.push("DB_NAME is empty; set it in your .env (e.g., DB_NAME=rentivo).");
+			if (!socketPath && !dbHost) hintLines.push("DB_HOST is empty; set DB_HOST or DB_SOCKET_PATH in your .env.");
+			const help = hintLines.length ? `\nHints:\n- ${hintLines.join("\n- ")}` : "";
+			const safeTarget = socketPath ? `socket ${socketPath}` : `${dbHost}${dbPort ? ":" + dbPort : ""}`;
+			throw new Error(`Database ping failed for ${safeTarget} as '${dbUser}' on schema '${dbName}'. Original: ${err?.message || err}${help}`);
+		} finally {
+			if (conn) conn.release();
+		}
+		return;
+	}
+	if (mongoDb) return;
+	const mongoUri = process.env.MONGO_URI || process.env.MONGODB_URI || `mongodb://${dbHost}:${dbPort || 27017}`;
+	const replicaSet = process.env.MONGO_REPLICA_SET || void 0;
+	const isReplicaSet = !!replicaSet || process.env.MONGO_DIRECT_CONNECTION === "false";
+	const directConnection = process.env.MONGO_DIRECT_CONNECTION === "true" ? true : process.env.MONGO_DIRECT_CONNECTION === "false" ? false : !isReplicaSet;
+	const clientOptions = {
+		serverSelectionTimeoutMS: 1e4,
+		retryWrites: process.env.MONGO_RETRY_WRITES === "true" ? true : process.env.MONGO_RETRY_WRITES === "false" ? false : isReplicaSet
+	};
+	if (!isReplicaSet) clientOptions.directConnection = directConnection;
+	if (replicaSet) clientOptions.replicaSet = replicaSet;
+	const client = new MongoClient(mongoUri, clientOptions);
+	await client.connect();
+	mongoDb = client.db(dbName);
+	await mongoDb.command({ ping: 1 });
+}
+function getPool() {
+	if (dbType !== "mysql") throw new Error("getPool() only valid for MySQL");
+	return ensureMysqlPool();
+}
+function getMongoDb() {
+	if (dbType !== "mongodb") throw new Error("getMongoDb() only valid for MongoDB");
+	if (!mongoDb) throw new Error("MongoDB not initialized. Call initDatabase() first.");
+	return mongoDb;
+}
+function collection(name) {
+	return createMongoQueryProxy(name, getMongoDb().collection(name));
+}
+dbType === "mysql" && ensureMysqlPool();
+//#endregion
+export { initDatabase as a, createMongoQueryProxy as c, getPool as i, emitQueryEvent as l, getDbType as n, query as o, getMongoDb as r, TELESCOPE_QUERY_CACHE_KEY as s, collection as t, setQueryEventHook as u };
+
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","names":[],"sources":["../src/QueryInstrumentation.ts","../src/connection.ts"],"sourcesContent":["/*\n|--------------------------------------------------------------------------\n| Query Instrumentation — shared utility\n|--------------------------------------------------------------------------\n|\n| Used by both DB.ts (MySQL executeQuery + MongoDB collection) and\n| db.config.ts (mongoCollection shorthand used by EloquentBuilder/Model).\n|\n| emitQueryEvent()\n|   If the application EventDispatcher already has a `db:query` listener\n|   (i.e., Telescope is active in this process), fires the event there.\n|   Otherwise — we're in a worker process — writes the entry to the shared\n|   Cache so the HTTP server's Telescope can poll it.\n|\n| createMongoQueryProxy()\n|   Wraps any MongoCollection in a Proxy that captures timing and calls\n|   emitQueryEvent() for every meaningful operation.\n|\n*/\n\n/** Compact JSON string of a MongoDB filter/pipeline argument (max 300 chars). */\nfunction mongoArgSummary(val: unknown): string {\n  try {\n    return JSON.stringify(val ?? {}).slice(0, 300);\n  } catch {\n    return \"{}\";\n  }\n}\n\nexport interface QueryEventPayload {\n  sql: string;\n  bindings?: any[];\n  duration: number;\n  rows?: number;\n  error?: string;\n  connection: string;\n  collection?: string;\n}\n\n/** Optional hook registered by Telescope/events layer — avoids circular deps. */\nlet _queryEventHook: ((payload: QueryEventPayload) => Promise<void>) | null = null;\n\n/** Called by @lara-node/telescope or @lara-node/events to wire up query event emission. */\nexport function setQueryEventHook(hook: (payload: QueryEventPayload) => Promise<void>): void {\n  _queryEventHook = hook;\n}\n\n/** Emit a query event via the registered hook (no-op if none registered). */\nexport async function emitQueryEvent(payload: QueryEventPayload): Promise<void> {\n  if (_queryEventHook) {\n    await _queryEventHook(payload).catch(() => {});\n  }\n}\n\n/** Promise-based MongoDB operations that resolve with a result directly. */\nconst MONGO_PROMISE_OPS = new Set([\n  \"insertOne\",\n  \"insertMany\",\n  \"updateOne\",\n  \"updateMany\",\n  \"replaceOne\",\n  \"deleteOne\",\n  \"deleteMany\",\n  \"findOne\",\n  \"findOneAndUpdate\",\n  \"findOneAndDelete\",\n  \"findOneAndReplace\",\n  \"countDocuments\",\n  \"estimatedDocumentCount\",\n  \"distinct\",\n  \"bulkWrite\",\n]);\n\n/** Cursor-returning MongoDB operations — we instrument toArray(). */\nconst MONGO_CURSOR_OPS = new Set([\"find\", \"aggregate\", \"listIndexes\"]);\n\n/**\n * Wraps a MongoCollection in a Proxy that times every operation and calls\n * emitQueryEvent() so Telescope captures it regardless of which process runs it.\n */\nexport function createMongoQueryProxy<T extends object>(collectionName: string, col: T): T {\n  const emit = (\n    op: string,\n    filter: unknown,\n    durationMs: number,\n    rows?: number,\n    error?: string,\n  ): void => {\n    emitQueryEvent({\n      sql: `${collectionName}.${op}(${mongoArgSummary(filter)})`,\n      duration: durationMs,\n      rows,\n      error,\n      connection: \"mongodb\",\n      collection: collectionName,\n    }).catch(() => {});\n  };\n\n  return new Proxy(col, {\n    get(target, prop: string | symbol) {\n      const value = (target as any)[prop];\n\n      if (typeof prop !== \"string\" || typeof value !== \"function\") {\n        return value;\n      }\n\n      if (MONGO_PROMISE_OPS.has(prop)) {\n        return (...args: any[]): Promise<any> => {\n          const start = process.hrtime.bigint();\n          const filter = args[0];\n          return (value.apply(target, args) as Promise<any>)\n            .then((res: any) => {\n              const dur = Number((process.hrtime.bigint() - start) / 1_000_000n);\n              const rowCount =\n                res == null\n                  ? 0\n                  : Array.isArray(res)\n                    ? res.length\n                    : (res.insertedCount ?? res.modifiedCount ?? res.deletedCount ?? 1);\n              emit(prop, filter, dur, rowCount);\n              return res;\n            })\n            .catch((err: Error) => {\n              const dur = Number((process.hrtime.bigint() - start) / 1_000_000n);\n              emit(prop, filter, dur, 0, err.message);\n              throw err;\n            });\n        };\n      }\n\n      if (MONGO_CURSOR_OPS.has(prop)) {\n        return (...args: any[]) => {\n          const start = process.hrtime.bigint();\n          const filter = args[0];\n          const cursor = value.apply(target, args);\n          const origToArray = cursor.toArray.bind(cursor);\n          cursor.toArray = async (): Promise<any[]> => {\n            try {\n              const rows: any[] = await origToArray();\n              const dur = Number((process.hrtime.bigint() - start) / 1_000_000n);\n              emit(prop, filter, dur, rows.length);\n              return rows;\n            } catch (err: any) {\n              const dur = Number((process.hrtime.bigint() - start) / 1_000_000n);\n              emit(prop, filter, dur, 0, err.message);\n              throw err;\n            }\n          };\n          return cursor;\n        };\n      }\n\n      return value.bind(target);\n    },\n  }) as T;\n}\n\n/** The Cache key pattern used for cross-process query entries. */\nexport const TELESCOPE_QUERY_CACHE_KEY = `${process.env.APP_NAME || \"app\"}:telescope:queries`;\n","import mysql from \"mysql2/promise\";\nimport fs from \"fs\";\nimport { MongoClient, Db, Collection, Document } from \"mongodb\";\nimport { createMongoQueryProxy } from \"./QueryInstrumentation.js\";\n\n// Ensure .env is loaded if this module is imported directly (safety for various import orders)\n\nconst dbType = (process.env.DB_CONNECTION || process.env.DB_DRIVER || \"mysql\").toLowerCase();\n\n// Common envs\nconst dbHost = process.env.DB_HOST || \"localhost\";\nconst dbUser = process.env.DB_USER || \"root\";\nconst dbPassword = process.env.DB_PASSWORD || \"\";\nconst dbName = process.env.DB_NAME || \"test\";\nconst dbPort = process.env.DB_PORT ? parseInt(process.env.DB_PORT, 10) : undefined;\nconst socketPath = process.env.DB_SOCKET_PATH || process.env.DB_SOCKET || undefined;\n\n// MySQL state\nconst baseOptions: mysql.PoolOptions = {\n  waitForConnections: true,\n  connectionLimit: parseInt(process.env.DB_POOL_LIMIT || \"10\", 10),\n  queueLimit: 0,\n  multipleStatements: true,\n};\n\nlet pool: mysql.Pool | undefined;\n\n// Mongo state\nlet mongoClient: MongoClient | undefined;\nlet mongoDb: Db | undefined;\n\nfunction ensureMysqlPool() {\n  if (pool) return pool;\n  pool = mysql.createPool(\n    socketPath\n      ? { ...baseOptions, user: dbUser, password: dbPassword, database: dbName, socketPath }\n      : {\n          ...baseOptions,\n          host: dbHost,\n          user: dbUser,\n          password: dbPassword,\n          database: dbName,\n          port: dbPort,\n        },\n  );\n  return pool;\n}\n\nexport function getDbType() {\n  return dbType as \"mysql\" | \"mongodb\";\n}\n\nexport async function query<T = any>(sql: string, params: any[] = []): Promise<T[]> {\n  if (dbType === \"mysql\") {\n    const p = ensureMysqlPool();\n    const [rows] = await p.query(sql, params);\n    return rows as T[];\n  }\n  // Intentionally throw for Mongo to avoid accidental SQL usage\n  throw new Error(\n    \"query(sql, params) is not supported for MongoDB. Use the Mongo helpers (collection, getMongoDb).\",\n  );\n}\n\nexport async function initDatabase(): Promise<void> {\n  if (dbType === \"mysql\") {\n    let conn: mysql.PoolConnection | undefined;\n    try {\n      const p = ensureMysqlPool();\n      conn = await p.getConnection();\n      await conn.ping();\n    } catch (err: any) {\n      const triedSockets: string[] = [];\n      if (!socketPath) {\n        const commonSocketPaths = [\n          \"/var/run/mysqld/mysqld.sock\",\n          \"/tmp/mysql.sock\",\n          \"/var/lib/mysql/mysql.sock\",\n        ];\n        for (const pth of commonSocketPaths) {\n          try {\n            if (!fs.existsSync(pth)) continue;\n            triedSockets.push(pth);\n            pool = mysql.createPool({\n              ...baseOptions,\n              user: dbUser,\n              password: dbPassword,\n              database: dbName,\n              socketPath: pth,\n            });\n            conn = await pool.getConnection();\n            await conn.ping();\n            return;\n          } catch (e) {\n            continue;\n          } finally {\n            if (conn) {\n              try {\n                conn.release();\n              } catch (_) {}\n              conn = undefined;\n            }\n          }\n        }\n        if (triedSockets.length) {\n          (err as any).message =\n            `${(err as any).message} (attempted sockets: ${triedSockets.join(\", \")})`;\n        }\n      }\n      const hintLines: string[] = [];\n      if (err && err.code && String(err.code).startsWith(\"ER_ACCESS_DENIED\")) {\n        hintLines.push(\n          \"Access denied: verify DB_USER/DB_PASSWORD and that the user has permissions on DB_NAME.\",\n          \"On many Linux setups, MySQL 'root' uses auth_socket and can't login with a blank password.\",\n          \"Either create a dedicated user, set a proper password, or use DB_SOCKET_PATH if using a local socket.\",\n        );\n      }\n      if (!process.env.DB_USER)\n        hintLines.push(\n          \"DB_USER is not set in your environment/.env; set it (e.g., DB_USER=rentivo)\",\n        );\n      if (!dbName) hintLines.push(\"DB_NAME is empty; set it in your .env (e.g., DB_NAME=rentivo).\");\n      if (!socketPath && !dbHost)\n        hintLines.push(\"DB_HOST is empty; set DB_HOST or DB_SOCKET_PATH in your .env.\");\n      const help = hintLines.length ? `\\nHints:\\n- ${hintLines.join(\"\\n- \")}` : \"\";\n      const safeTarget = socketPath\n        ? `socket ${socketPath}`\n        : `${dbHost}${dbPort ? \":\" + dbPort : \"\"}`;\n      throw new Error(\n        `Database ping failed for ${safeTarget} as '${dbUser}' on schema '${dbName}'. Original: ${err?.message || err}${help}`,\n      );\n    } finally {\n      if (conn) conn.release();\n    }\n    return;\n  }\n\n  // MongoDB init\n  if (mongoDb) return;\n  const mongoUri =\n    process.env.MONGO_URI || process.env.MONGODB_URI || `mongodb://${dbHost}:${dbPort || 27017}`;\n\n  // Replica set configuration\n  // If MONGO_REPLICA_SET is set, we're using a replica set\n  const replicaSet = process.env.MONGO_REPLICA_SET || undefined;\n  const isReplicaSet = !!replicaSet || process.env.MONGO_DIRECT_CONNECTION === \"false\";\n\n  // directConnection: For standalone MongoDB, set to true (default for local dev)\n  // For replica sets, must be false or undefined to allow driver to discover all nodes\n  // Default: true for standalone (safe local dev), false if replica set is configured\n  const directConnection =\n    process.env.MONGO_DIRECT_CONNECTION === \"true\"\n      ? true\n      : process.env.MONGO_DIRECT_CONNECTION === \"false\"\n        ? false\n        : !isReplicaSet; // Default: true for standalone, false for replica set\n\n  // retryWrites: Requires replica set. MongoDB 7.x uses transaction numbers for retryable writes\n  // Default: true for replica sets, false for standalone (to avoid \"Transaction numbers\" error)\n  const retryWrites =\n    process.env.MONGO_RETRY_WRITES === \"true\"\n      ? true\n      : process.env.MONGO_RETRY_WRITES === \"false\"\n        ? false\n        : isReplicaSet; // Default based on replica set detection\n\n  const clientOptions: any = {\n    serverSelectionTimeoutMS: 10000,\n    retryWrites,\n  };\n\n  // Only set directConnection if not using replica set (it's incompatible with replicaSet option)\n  if (!isReplicaSet) {\n    clientOptions.directConnection = directConnection;\n  }\n\n  // Add replica set name if configured\n  if (replicaSet) {\n    clientOptions.replicaSet = replicaSet;\n  }\n\n  const client = new MongoClient(mongoUri, clientOptions);\n  await client.connect();\n  mongoClient = client;\n  mongoDb = client.db(dbName);\n  // Simple ping\n  await mongoDb.command({ ping: 1 });\n}\n\nexport function getPool() {\n  if (dbType !== \"mysql\") throw new Error(\"getPool() only valid for MySQL\");\n  return ensureMysqlPool();\n}\n\nexport function getMongoDb(): Db {\n  if (dbType !== \"mongodb\") throw new Error(\"getMongoDb() only valid for MongoDB\");\n  if (!mongoDb) throw new Error(\"MongoDB not initialized. Call initDatabase() first.\");\n  return mongoDb;\n}\n\nexport function collection(name: string): Collection<Document> {\n  const col: Collection<Document> = getMongoDb().collection(name);\n  return createMongoQueryProxy(name, col) as Collection<Document>;\n}\n\nexport async function closeDatabase(): Promise<void> {\n  if (dbType === \"mysql\") {\n    if (pool) await pool.end();\n    pool = undefined;\n    return;\n  }\n  if (mongoClient) await mongoClient.close();\n  mongoClient = undefined;\n  mongoDb = undefined;\n}\n\nexport default (dbType === \"mysql\" ? ensureMysqlPool() : undefined) as any;\n"],"mappings":"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"}