@regle/mcp-server 1.14.6 → 1.14.7-beta.2

package/dist/regle-mcp-server.d.ts

@@ -1 +1 @@
-export { };
+import "dotenv/config";

package/dist/regle-mcp-server.js

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
+import "dotenv/config";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
+import "posthog-node";
 
 var docs_data_default = {
 	docs: [
@@ -1663,7 +1665,15 @@ function searchApi(query) {
 	return results;
 }
 
-var version = "1.14.6";
+var version = "1.14.7-beta.2";
+
+function trackServerConnected(params) {}
+function trackToolCall(params) {}
+function trackSearchQuery(params) {}
+function trackDocAccessed(params) {}
+function trackRuleLookup(params) {}
+function trackHelperLookup(params) {}
+async function shutdown() {}
 
 function jsonResponse(data$1) {
 	return { content: [{
@@ -1687,7 +1697,38 @@ const server = new McpServer({
 	title: "Regle MCP Server",
 	websiteUrl: "https://reglejs.dev"
 });
-server.registerTool("regle-list-documentation", {
+function getClientInfo() {
+	const clientInfo = server.server.getClientVersion();
+	return {
+		clientName: clientInfo?.name,
+		clientVersion: clientInfo?.version
+	};
+}
+function registerTrackedTool(name, config, handler) {
+	server.registerTool(name, config, async (args) => {
+		const clientInfo = getClientInfo();
+		try {
+			const result = await handler(args, clientInfo);
+			const isError = "isError" in result && result.isError === true;
+			/* @__PURE__ */ trackToolCall({
+				toolName: name,
+				success: !isError,
+				...clientInfo,
+				...isError && { errorMessage: JSON.stringify(result.content) }
+			});
+			return result;
+		} catch (error) {
+			/* @__PURE__ */ trackToolCall({
+				toolName: name,
+				success: false,
+				...clientInfo,
+				errorMessage: error instanceof Error ? error.message : String(error)
+			});
+			return Promise.reject(error);
+		}
+	});
+}
+registerTrackedTool("regle-list-documentation", {
 	title: "List all available Regle documentation pages",
 	inputSchema: z.object({ category: z.string().optional().describe("Filter by category (e.g., \"rules\", \"core-concepts\", \"introduction\")") })
 }, async ({ category }) => {
@@ -1702,15 +1743,20 @@ server.registerTool("regle-list-documentation", {
 		}))
 	});
 });
-server.registerTool("regle-get-documentation", {
+registerTrackedTool("regle-get-documentation", {
 	title: "Get the full content of a specific Regle documentation page",
 	inputSchema: z.object({ id: z.string().describe("The documentation page ID (e.g., \"core-concepts-rules-built-in-rules\")") })
-}, async ({ id }) => {
+}, async ({ id }, clientInfo) => {
 	const doc = getDocById(id);
 	if (!doc) return errorResponse("Documentation page not found", {
 		requestedId: id,
 		availableIds: docs.map((d) => d.id)
 	});
+	/* @__PURE__ */ trackDocAccessed({
+		...clientInfo,
+		docId: doc.id,
+		docCategory: doc.category
+	});
 	return jsonResponse({
 		id: doc.id,
 		title: doc.title,
@@ -1719,12 +1765,17 @@ server.registerTool("regle-get-documentation", {
 		content: doc.content
 	});
 });
-server.registerTool("regle-get-usage-guide", {
+registerTrackedTool("regle-get-usage-guide", {
 	title: "Get a comprehensive guide on how to use the useRegle composable",
 	inputSchema: z.object({})
-}, async () => {
+}, async (_args, clientInfo) => {
 	const doc = getDocById("core-concepts-index");
 	if (!doc) return errorResponse("useRegle guide not found");
+	/* @__PURE__ */ trackDocAccessed({
+		...clientInfo,
+		docId: doc.id,
+		docCategory: doc.category
+	});
 	return jsonResponse({
 		id: doc.id,
 		title: doc.title,
@@ -1732,12 +1783,17 @@ server.registerTool("regle-get-usage-guide", {
 		content: doc.content
 	});
 });
-server.registerTool("regle-get-vuelidate-migration-guide", {
+registerTrackedTool("regle-get-vuelidate-migration-guide", {
 	title: "Get a guide on how to migrate from Vuelidate to Regle",
 	inputSchema: z.object({})
-}, async () => {
+}, async (_args, clientInfo) => {
 	const doc = getDocById("introduction-migrate-from-vuelidate");
 	if (!doc) return errorResponse("Vuelidate migration guide not found");
+	/* @__PURE__ */ trackDocAccessed({
+		...clientInfo,
+		docId: doc.id,
+		docCategory: doc.category
+	});
 	return jsonResponse({
 		id: doc.id,
 		title: doc.title,
@@ -1746,14 +1802,20 @@ server.registerTool("regle-get-vuelidate-migration-guide", {
 	});
 });
 const categories = getCategories();
-server.registerTool("regle-search-documentation", {
+registerTrackedTool("regle-search-documentation", {
 	title: "Search Regle documentation for specific topics, rules, or concepts",
 	inputSchema: z.object({
 		query: z.string().describe("Search query (e.g., \"required\", \"async validation\", \"useRegle\")"),
 		limit: z.number().optional().default(5).describe("Maximum number of results to return")
 	})
-}, async ({ query, limit }) => {
+}, async ({ query, limit }, clientInfo) => {
 	const results = searchDocs(query).slice(0, limit);
+	/* @__PURE__ */ trackSearchQuery({
+		...clientInfo,
+		query,
+		resultCount: results.length,
+		toolName: "regle-search-documentation"
+	});
 	if (results.length === 0) return jsonResponse({
 		query,
 		resultCount: 0,
@@ -1772,10 +1834,10 @@ server.registerTool("regle-search-documentation", {
 		results: formattedResults
 	});
 });
-server.registerTool("regle-list-rules", {
+registerTrackedTool("regle-list-rules", {
 	title: "Get a quick reference of all built-in validation rules in Regle",
 	inputSchema: z.object({})
-}, async () => {
+}, async (_args, _clientInfo) => {
 	const rules = getRulesFromDocs();
 	if (rules.length === 0) return errorResponse("Built-in rules documentation not found");
 	return jsonResponse({
@@ -1799,11 +1861,16 @@ const { r$ } = useRegle(
 		fullDocId: "core-concepts-rules-built-in-rules"
 	});
 });
-server.registerTool("regle-get-rule-reference", {
+registerTrackedTool("regle-get-rule-reference", {
 	title: "Get details about a specific built-in validation rule",
 	inputSchema: z.object({ name: z.string().describe("The rule name (e.g., \"required\", \"email\", \"minLength\")") })
-}, async ({ name }) => {
+}, async ({ name }, clientInfo) => {
 	const rule = getApiByName(name);
+	/* @__PURE__ */ trackRuleLookup({
+		...clientInfo,
+		ruleName: name,
+		found: !!rule
+	});
 	if (!rule) {
 		const allRules = getRulesFromDocs();
 		return errorResponse(`Rule "${name}" not found`, { availableRules: allRules.map((r) => r.name) });
@@ -1816,12 +1883,17 @@ server.registerTool("regle-get-rule-reference", {
 		fullDocId: "core-concepts-rules-built-in-rules"
 	});
 });
-server.registerTool("regle-list-validation-properties", {
+registerTrackedTool("regle-list-validation-properties", {
 	title: "Get documentation on all validation properties available on r$ and field objects",
 	inputSchema: z.object({})
-}, async () => {
+}, async (_args, clientInfo) => {
 	const doc = getDocById("core-concepts-validation-properties");
 	if (!doc) return errorResponse("Validation properties documentation not found");
+	/* @__PURE__ */ trackDocAccessed({
+		...clientInfo,
+		docId: doc.id,
+		docCategory: doc.category
+	});
 	return jsonResponse({
 		id: doc.id,
 		title: doc.title,
@@ -1829,10 +1901,10 @@ server.registerTool("regle-list-validation-properties", {
 		content: doc.content
 	});
 });
-server.registerTool("regle-list-helpers", {
+registerTrackedTool("regle-list-helpers", {
 	title: "Get a reference of all validation helper utilities available in Regle",
 	inputSchema: z.object({})
-}, async () => {
+}, async (_args, _clientInfo) => {
 	const helpers = getHelpersFromDocs();
 	if (helpers.length === 0) return errorResponse("Validation helpers documentation not found");
 	const guards = helpers.filter((h) => h.category === "guard");
@@ -1875,11 +1947,16 @@ const rule = createRule({
 		fullDocId: "core-concepts-rules-validations-helpers"
 	});
 });
-server.registerTool("regle-get-helper-reference", {
+registerTrackedTool("regle-get-helper-reference", {
 	title: "Get details about a specific validation helper utility",
 	inputSchema: z.object({ name: z.string().describe("The helper name (e.g., \"isFilled\", \"getSize\", \"toNumber\")") })
-}, async ({ name }) => {
+}, async ({ name }, clientInfo) => {
 	const helper = getApiByName(name);
+	/* @__PURE__ */ trackHelperLookup({
+		...clientInfo,
+		helperName: name,
+		found: !!helper
+	});
 	if (!helper) {
 		const allHelpers = getHelpersFromDocs();
 		return errorResponse(`Helper "${name}" not found`, { availableHelpers: allHelpers.map((h) => h.name) });
@@ -1894,14 +1971,14 @@ server.registerTool("regle-get-helper-reference", {
 	});
 });
 const apiPackages = getApiPackages();
-server.registerTool("regle-get-api-reference", {
+registerTrackedTool("regle-get-api-reference", {
 	title: "Get API reference for Regle packages with full metadata (parameters, return types, examples)",
 	inputSchema: z.object({
 		package: z.string().optional().describe("Package name (e.g., \"@regle/core\", \"@regle/rules\", \"@regle/schemas\", \"@regle/nuxt\")"),
 		name: z.string().optional().describe("Specific function/export name to look up (e.g., \"useRegle\", \"required\")"),
 		search: z.string().optional().describe("Search query to find exports by name or description")
 	})
-}, async ({ package: packageName, name, search }) => {
+}, async ({ package: packageName, name, search }, clientInfo) => {
 	if (name) {
 		const apiItem = getApiByName(name, packageName);
 		if (!apiItem) return errorResponse(`API export "${name}" not found`, { availablePackages: apiPackages });
@@ -1917,6 +1994,12 @@ server.registerTool("regle-get-api-reference", {
 	}
 	if (search) {
 		const results = searchApi(search);
+		/* @__PURE__ */ trackSearchQuery({
+			...clientInfo,
+			query: search,
+			resultCount: results.length,
+			toolName: "regle-get-api-reference"
+		});
 		return jsonResponse({
 			query: search,
 			resultCount: results.length,
@@ -1955,10 +2038,22 @@ server.registerTool("regle-get-api-reference", {
 async function main() {
 	const transport = new StdioServerTransport();
 	await server.connect(transport);
+	const clientInfo = server.server.getClientVersion();
+	/* @__PURE__ */ trackServerConnected({
+		clientName: clientInfo?.name,
+		clientVersion: clientInfo?.version
+	});
 	console.error("Regle MCP Server running on stdio");
 }
-main().catch((error) => {
+async function gracefulShutdown() {
+	await /* @__PURE__ */ shutdown();
+	process.exit(0);
+}
+process.on("SIGINT", gracefulShutdown);
+process.on("SIGTERM", gracefulShutdown);
+main().catch(async (error) => {
 	console.error("Failed to start server:", error);
+	await /* @__PURE__ */ shutdown();
 	process.exit(1);
 });
 

package/package.json

@@ -1,9 +1,11 @@
 {
   "name": "@regle/mcp-server",
-  "version": "1.14.6",
+  "version": "1.14.7-beta.2",
   "description": "MCP Server for Regle",
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.24.3",
+    "dotenv": "17.2.3",
+    "posthog-node": "5.17.4",
     "zod": "4.1.13"
   },
   "devDependencies": {