@jshookmcp/jshook 0.2.8 → 0.2.9

package/dist/betterSqlite3-0pqusHHH.mjs

@@ -0,0 +1,74 @@
+import { createRequire } from "node:module";
+//#region src/utils/betterSqlite3.ts
+const require = createRequire(import.meta.url);
+const INSTALL_HINT = `pnpm add -O better-sqlite3@12.6.2`;
+const REBUILD_HINT = "npm rebuild better-sqlite3 --foreground-scripts";
+function extractErrorMessage(error) {
+	if (error instanceof Error) return error.message;
+	return String(error);
+}
+function isBetterSqlite3RelatedError(error) {
+	return /better-sqlite3|better_sqlite3\.node|NODE_MODULE_VERSION|compiled against a different Node\.js version/i.test(extractErrorMessage(error));
+}
+function classifyBetterSqlite3Issue(error) {
+	const message = extractErrorMessage(error);
+	if (/Cannot find module 'better-sqlite3'|Cannot find package 'better-sqlite3'|better-sqlite3 is not installed/i.test(message)) return "missing";
+	if (/better_sqlite3\.node|NODE_MODULE_VERSION|compiled against a different Node\.js version|module was compiled against/i.test(message)) return "abi-mismatch";
+	return "load-failed";
+}
+function formatBetterSqlite3Error(error) {
+	const issue = classifyBetterSqlite3Issue(error);
+	const message = extractErrorMessage(error);
+	if (issue === "missing") return `GRACEFUL: better-sqlite3 is not installed. Install the optional trace backend with \`${INSTALL_HINT}\`.`;
+	if (issue === "abi-mismatch") return `GRACEFUL: better-sqlite3 is installed but its native binary is incompatible with the current Node.js runtime (${process.version}, ABI ${process.versions.modules}). Rebuild it with \`${REBUILD_HINT}\` or reinstall dependencies under the active Node version. Original error: ${message}`;
+	return `GRACEFUL: better-sqlite3 failed to initialize. Try \`${REBUILD_HINT}\` or reinstall dependencies under the active Node version. Original error: ${message}`;
+}
+function readBetterSqlite3Version() {
+	try {
+		return require(require.resolve("better-sqlite3/package.json")).version ?? null;
+	} catch {
+		/* v8 ignore next -- CI guarantees node_modules installation */
+		return null;
+	}
+}
+function probeBetterSqlite3() {
+	const version = readBetterSqlite3Version();
+	/* v8 ignore next -- CI guarantees package.json existence */
+	if (!version) return {
+		status: "missing",
+		detail: `GRACEFUL: Optional SQLite backend for trace tools is not installed. Install it with: ${INSTALL_HINT}`,
+		version: null,
+		issue: "missing"
+	};
+	try {
+		const db = new (require("better-sqlite3"))(":memory:");
+		try {
+			db.prepare("SELECT 1 AS ok").get();
+		} finally {
+			db.close();
+		}
+		return {
+			status: "ok",
+			detail: `installed (${version}) — native trace backend healthy`,
+			version
+		};
+	} catch (error) {
+		const issue = classifyBetterSqlite3Issue(error);
+		/* v8 ignore next -- Native loading exceptions cannot be deterministically forced in pure TS envs */
+		if (issue === "missing") return {
+			status: "missing",
+			detail: `GRACEFUL: Optional SQLite backend for trace tools is not installed. Install it with: ${INSTALL_HINT}`,
+			version,
+			issue
+		};
+		/* v8 ignore next */
+		return {
+			status: "warn",
+			detail: `installed (${version}) but ${formatBetterSqlite3Error(error)}`,
+			version,
+			issue
+		};
+	}
+}
+//#endregion
+export { isBetterSqlite3RelatedError as n, probeBetterSqlite3 as r, formatBetterSqlite3Error as t };