@egdesk/next-api-plugin 1.2.3 → 1.3.1

package/dist/generate-helpers.js

@@ -50,7 +50,7 @@ function generateHelpers(projectPath) {
     const helperContent = `/**
  * EGDesk Helper Functions for Next.js
  *
- * Type-safe helpers for accessing EGDesk user data and FinanceHub.
+ * Type-safe helpers for EGDesk user data, FinanceHub, and browser recorder replay.
  * Works in both client and server components.
  *
  * Generated by @egdesk/next-api-plugin
@@ -58,6 +58,45 @@ function generateHelpers(projectPath) {
 
 import { EGDESK_CONFIG } from './egdesk.config';
 
+/**
+ * Parse EGDesk MCP \`/tools/call\` JSON so \`error\` is shown even when HTTP status is 500.
+ */
+async function parseEgdeskMcpToolResponse(response: Response): Promise<any> {
+  const result = await response.json().catch(() => null);
+
+  if (result && typeof result === 'object' && result.success === false) {
+    const errMsg =
+      typeof result.error === 'string'
+        ? result.error
+        : result.error != null
+          ? String(result.error)
+          : 'Tool call failed';
+    throw new Error(errMsg);
+  }
+
+  if (!response.ok) {
+    let fromBody = '';
+    if (result && typeof result === 'object') {
+      if (typeof result.error === 'string') fromBody = result.error;
+      else if (typeof (result as { message?: string }).message === 'string') {
+        fromBody = (result as { message: string }).message;
+      }
+    }
+    throw new Error(fromBody || \`HTTP \${response.status}: \${response.statusText}\`);
+  }
+
+  if (!result || result.success !== true) {
+    throw new Error(
+      result && typeof result === 'object' && typeof result.error === 'string'
+        ? result.error
+        : 'Tool call failed'
+    );
+  }
+
+  const content = result.result?.content?.[0]?.text;
+  return content ? JSON.parse(content) : null;
+}
+
 /**
  * Call EGDesk user-data MCP tool
  *
@@ -103,19 +142,7 @@ export async function callUserDataTool(
     });
   }
 
-  if (!response.ok) {
-    throw new Error(\`HTTP \${response.status}: \${response.statusText}\`);
-  }
-
-  const result = await response.json();
-
-  if (!result.success) {
-    throw new Error(result.error || 'Tool call failed');
-  }
-
-  // Parse MCP response format
-  const content = result.result?.content?.[0]?.text;
-  return content ? JSON.parse(content) : null;
+  return parseEgdeskMcpToolResponse(response);
 }
 
 /**
@@ -329,18 +356,7 @@ export async function callFinanceHubTool(
     });
   }
 
-  if (!response.ok) {
-    throw new Error(\`HTTP \${response.status}: \${response.statusText}\`);
-  }
-
-  const result = await response.json();
-
-  if (!result.success) {
-    throw new Error(result.error || 'Tool call failed');
-  }
-
-  const content = result.result?.content?.[0]?.text;
-  return content ? JSON.parse(content) : null;
+  return parseEgdeskMcpToolResponse(response);
 }
 
 /**
@@ -439,6 +455,81 @@ export async function getOverallStats() {
 export async function getSyncHistory(limit: number = 50) {
   return callFinanceHubTool('financehub_get_sync_history', { limit });
 }
+
+// ==========================================
+// BROWSER RECORDING HELPERS
+// ==========================================
+
+/**
+ * Call EGDesk Browser Recording MCP tool (saved recorder tests, replay with optional dates).
+ *
+ * - Server: \`POST {apiUrl}/browser-recording/tools/call\`
+ * - Client: \`POST /__browser_recording_proxy\` (see proxy.ts / middleware)
+ */
+export async function callBrowserRecordingTool(
+  toolName: string,
+  args: Record<string, any> = {}
+): Promise<any> {
+  const body = JSON.stringify({ tool: toolName, arguments: args });
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json'
+  };
+
+  const isServer = typeof window === 'undefined';
+
+  let response: Response;
+  if (isServer) {
+    const apiUrl =
+      (typeof process !== 'undefined' && process.env?.NEXT_PUBLIC_EGDESK_API_URL) ||
+      EGDESK_CONFIG.apiUrl;
+    const apiKey =
+      (typeof process !== 'undefined' && process.env?.NEXT_PUBLIC_EGDESK_API_KEY) ||
+      EGDESK_CONFIG.apiKey;
+    if (apiKey) {
+      headers['X-Api-Key'] = apiKey;
+    }
+    response = await fetch(\`\${apiUrl}/browser-recording/tools/call\`, {
+      method: 'POST',
+      headers,
+      body
+    });
+  } else {
+    response = await fetch('/__browser_recording_proxy', {
+      method: 'POST',
+      headers,
+      body
+    });
+  }
+
+  return parseEgdeskMcpToolResponse(response);
+}
+
+/** List saved *.spec.js files in the EGDesk browser-recorder-tests output folder */
+export async function listBrowserRecordingTests() {
+  return callBrowserRecordingTool('browser_recording_list_saved_tests', {});
+}
+
+/** Inspect a spec for date-picker replay options */
+export async function getBrowserRecordingReplayOptions(testFile: string) {
+  return callBrowserRecordingTool('browser_recording_get_replay_options', { testFile });
+}
+
+export type BrowserRecordingRunOptions = {
+  startDate?: string;
+  endDate?: string;
+  datePickersByIndex?: string[];
+};
+
+/** Replay a saved recording in Chrome */
+export async function runBrowserRecording(
+  testFile: string,
+  options: BrowserRecordingRunOptions = {}
+) {
+  return callBrowserRecordingTool('browser_recording_run', {
+    testFile,
+    ...options
+  });
+}
 `;
     fs.writeFileSync(helperPath, helperContent.replace(/\r?\n/g, os.EOL), 'utf-8');
     console.log(`✅ Generated ${helperPath}`);

package/dist/generate-middleware.js

@@ -73,7 +73,8 @@ import type { NextRequest } from 'next/server';
 /**
  * EGDesk Database Proxy Middleware
  *
- * Intercepts __user_data_proxy requests and forwards them to the EGDesk MCP server.
+ * Intercepts __user_data_proxy and __browser_recording_proxy requests and forwards them
+ * to the EGDesk MCP HTTP server.
  * This allows CORS-free database access in both local and tunneled environments.
  *
  * Generated by @egdesk/next-api-plugin
@@ -116,6 +117,38 @@ export async function middleware(request: NextRequest) {
     }
   }
 
+  if (pathname.includes('__browser_recording_proxy')) {
+    try {
+      const body = await request.text();
+
+      const apiKey = process.env.NEXT_PUBLIC_EGDESK_API_KEY;
+      const apiUrl = process.env.NEXT_PUBLIC_EGDESK_API_URL || 'http://localhost:8080';
+
+      const headers: HeadersInit = {
+        'Content-Type': 'application/json',
+      };
+
+      if (apiKey) {
+        headers['X-Api-Key'] = apiKey;
+      }
+
+      const response = await fetch(\`\${apiUrl}/browser-recording/tools/call\`, {
+        method: 'POST',
+        headers,
+        body,
+      });
+
+      const result = await response.json();
+
+      return NextResponse.json(result, { status: response.status });
+    } catch (error: any) {
+      return NextResponse.json(
+        { error: 'Proxy error', message: error.message },
+        { status: 500 }
+      );
+    }
+  }
+
   // Continue to next middleware or route
   return NextResponse.next();
 }

package/dist/generate-proxy.js

@@ -75,8 +75,8 @@ import type { NextRequest } from 'next/server';
 /**
  * EGDesk Database Proxy (Next.js 16+)
  *
- * Intercepts __user_data_proxy requests and forwards them to the EGDesk MCP server.
- * This allows CORS-free database access in both local and tunneled environments.
+ * Intercepts __user_data_proxy and __browser_recording_proxy requests and forwards them
+ * to the EGDesk MCP HTTP server. This avoids CORS in local and tunneled environments.
  *
  * Generated by @egdesk/next-api-plugin
  */
@@ -118,6 +118,38 @@ export async function proxy(request: NextRequest) {
     }
   }
 
+  if (pathname.includes('__browser_recording_proxy')) {
+    try {
+      const body = await request.text();
+
+      const apiKey = process.env.NEXT_PUBLIC_EGDESK_API_KEY;
+      const apiUrl = process.env.NEXT_PUBLIC_EGDESK_API_URL || 'http://localhost:8080';
+
+      const headers: HeadersInit = {
+        'Content-Type': 'application/json',
+      };
+
+      if (apiKey) {
+        headers['X-Api-Key'] = apiKey;
+      }
+
+      const response = await fetch(\`\${apiUrl}/browser-recording/tools/call\`, {
+        method: 'POST',
+        headers,
+        body,
+      });
+
+      const result = await response.json();
+
+      return NextResponse.json(result, { status: response.status });
+    } catch (error: any) {
+      return NextResponse.json(
+        { error: 'Proxy error', message: error.message },
+        { status: 500 }
+      );
+    }
+  }
+
   // Continue to next proxy or route
   return NextResponse.next();
 }
@@ -126,7 +158,7 @@ export const config = {
   matcher: [
     /*
      * Match all paths except static assets
-     * The proxy function itself filters for __user_data_proxy
+     * The proxy function filters for __user_data_proxy / __browser_recording_proxy
      */
     '/:path*',
   ],

package/dist/setup-userdata.js

@@ -66,12 +66,20 @@ async function discoverTables(egdeskUrl = 'http://localhost:8080', apiKey) {
                 arguments: {}
             })
         });
+        const listResult = await listResponse.json().catch(() => null);
+        if (listResult && typeof listResult === 'object' && listResult.success === false) {
+            throw new Error(listResult.error || 'Failed to list tables');
+        }
         if (!listResponse.ok) {
-            throw new Error(`Failed to list tables: ${listResponse.statusText}`);
+            const fromBody = listResult && typeof listResult === 'object' && typeof listResult.error === 'string'
+                ? listResult.error
+                : '';
+            throw new Error(fromBody || `Failed to list tables: ${listResponse.status} ${listResponse.statusText}`);
         }
-        const listResult = await listResponse.json();
-        if (!listResult.success) {
-            throw new Error(listResult.error || 'Failed to list tables');
+        if (!listResult || !listResult.success) {
+            throw new Error(listResult && typeof listResult === 'object' && listResult.error
+                ? String(listResult.error)
+                : 'Failed to list tables');
         }
         // Parse MCP response
         const content = listResult.result?.content?.[0]?.text;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@egdesk/next-api-plugin",
-  "version": "1.2.3",
+  "version": "1.3.1",
   "description": "Next.js plugin for EGDesk database proxy integration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/generate-helpers.ts

@@ -17,7 +17,7 @@ export function generateHelpers(projectPath: string): void {
   const helperContent = `/**
  * EGDesk Helper Functions for Next.js
  *
- * Type-safe helpers for accessing EGDesk user data and FinanceHub.
+ * Type-safe helpers for EGDesk user data, FinanceHub, and browser recorder replay.
  * Works in both client and server components.
  *
  * Generated by @egdesk/next-api-plugin
@@ -25,6 +25,45 @@ export function generateHelpers(projectPath: string): void {
 
 import { EGDESK_CONFIG } from './egdesk.config';
 
+/**
+ * Parse EGDesk MCP \`/tools/call\` JSON so \`error\` is shown even when HTTP status is 500.
+ */
+async function parseEgdeskMcpToolResponse(response: Response): Promise<any> {
+  const result = await response.json().catch(() => null);
+
+  if (result && typeof result === 'object' && result.success === false) {
+    const errMsg =
+      typeof result.error === 'string'
+        ? result.error
+        : result.error != null
+          ? String(result.error)
+          : 'Tool call failed';
+    throw new Error(errMsg);
+  }
+
+  if (!response.ok) {
+    let fromBody = '';
+    if (result && typeof result === 'object') {
+      if (typeof result.error === 'string') fromBody = result.error;
+      else if (typeof (result as { message?: string }).message === 'string') {
+        fromBody = (result as { message: string }).message;
+      }
+    }
+    throw new Error(fromBody || \`HTTP \${response.status}: \${response.statusText}\`);
+  }
+
+  if (!result || result.success !== true) {
+    throw new Error(
+      result && typeof result === 'object' && typeof result.error === 'string'
+        ? result.error
+        : 'Tool call failed'
+    );
+  }
+
+  const content = result.result?.content?.[0]?.text;
+  return content ? JSON.parse(content) : null;
+}
+
 /**
  * Call EGDesk user-data MCP tool
  *
@@ -70,19 +109,7 @@ export async function callUserDataTool(
     });
   }
 
-  if (!response.ok) {
-    throw new Error(\`HTTP \${response.status}: \${response.statusText}\`);
-  }
-
-  const result = await response.json();
-
-  if (!result.success) {
-    throw new Error(result.error || 'Tool call failed');
-  }
-
-  // Parse MCP response format
-  const content = result.result?.content?.[0]?.text;
-  return content ? JSON.parse(content) : null;
+  return parseEgdeskMcpToolResponse(response);
 }
 
 /**
@@ -296,18 +323,7 @@ export async function callFinanceHubTool(
     });
   }
 
-  if (!response.ok) {
-    throw new Error(\`HTTP \${response.status}: \${response.statusText}\`);
-  }
-
-  const result = await response.json();
-
-  if (!result.success) {
-    throw new Error(result.error || 'Tool call failed');
-  }
-
-  const content = result.result?.content?.[0]?.text;
-  return content ? JSON.parse(content) : null;
+  return parseEgdeskMcpToolResponse(response);
 }
 
 /**
@@ -406,6 +422,81 @@ export async function getOverallStats() {
 export async function getSyncHistory(limit: number = 50) {
   return callFinanceHubTool('financehub_get_sync_history', { limit });
 }
+
+// ==========================================
+// BROWSER RECORDING HELPERS
+// ==========================================
+
+/**
+ * Call EGDesk Browser Recording MCP tool (saved recorder tests, replay with optional dates).
+ *
+ * - Server: \`POST {apiUrl}/browser-recording/tools/call\`
+ * - Client: \`POST /__browser_recording_proxy\` (see proxy.ts / middleware)
+ */
+export async function callBrowserRecordingTool(
+  toolName: string,
+  args: Record<string, any> = {}
+): Promise<any> {
+  const body = JSON.stringify({ tool: toolName, arguments: args });
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json'
+  };
+
+  const isServer = typeof window === 'undefined';
+
+  let response: Response;
+  if (isServer) {
+    const apiUrl =
+      (typeof process !== 'undefined' && process.env?.NEXT_PUBLIC_EGDESK_API_URL) ||
+      EGDESK_CONFIG.apiUrl;
+    const apiKey =
+      (typeof process !== 'undefined' && process.env?.NEXT_PUBLIC_EGDESK_API_KEY) ||
+      EGDESK_CONFIG.apiKey;
+    if (apiKey) {
+      headers['X-Api-Key'] = apiKey;
+    }
+    response = await fetch(\`\${apiUrl}/browser-recording/tools/call\`, {
+      method: 'POST',
+      headers,
+      body
+    });
+  } else {
+    response = await fetch('/__browser_recording_proxy', {
+      method: 'POST',
+      headers,
+      body
+    });
+  }
+
+  return parseEgdeskMcpToolResponse(response);
+}
+
+/** List saved *.spec.js files in the EGDesk browser-recorder-tests output folder */
+export async function listBrowserRecordingTests() {
+  return callBrowserRecordingTool('browser_recording_list_saved_tests', {});
+}
+
+/** Inspect a spec for date-picker replay options */
+export async function getBrowserRecordingReplayOptions(testFile: string) {
+  return callBrowserRecordingTool('browser_recording_get_replay_options', { testFile });
+}
+
+export type BrowserRecordingRunOptions = {
+  startDate?: string;
+  endDate?: string;
+  datePickersByIndex?: string[];
+};
+
+/** Replay a saved recording in Chrome */
+export async function runBrowserRecording(
+  testFile: string,
+  options: BrowserRecordingRunOptions = {}
+) {
+  return callBrowserRecordingTool('browser_recording_run', {
+    testFile,
+    ...options
+  });
+}
 `;
 
   fs.writeFileSync(helperPath, helperContent.replace(/\r?\n/g, os.EOL), 'utf-8');

package/src/generate-middleware.ts

@@ -43,7 +43,8 @@ import type { NextRequest } from 'next/server';
 /**
  * EGDesk Database Proxy Middleware
  *
- * Intercepts __user_data_proxy requests and forwards them to the EGDesk MCP server.
+ * Intercepts __user_data_proxy and __browser_recording_proxy requests and forwards them
+ * to the EGDesk MCP HTTP server.
  * This allows CORS-free database access in both local and tunneled environments.
  *
  * Generated by @egdesk/next-api-plugin
@@ -86,6 +87,38 @@ export async function middleware(request: NextRequest) {
     }
   }
 
+  if (pathname.includes('__browser_recording_proxy')) {
+    try {
+      const body = await request.text();
+
+      const apiKey = process.env.NEXT_PUBLIC_EGDESK_API_KEY;
+      const apiUrl = process.env.NEXT_PUBLIC_EGDESK_API_URL || 'http://localhost:8080';
+
+      const headers: HeadersInit = {
+        'Content-Type': 'application/json',
+      };
+
+      if (apiKey) {
+        headers['X-Api-Key'] = apiKey;
+      }
+
+      const response = await fetch(\`\${apiUrl}/browser-recording/tools/call\`, {
+        method: 'POST',
+        headers,
+        body,
+      });
+
+      const result = await response.json();
+
+      return NextResponse.json(result, { status: response.status });
+    } catch (error: any) {
+      return NextResponse.json(
+        { error: 'Proxy error', message: error.message },
+        { status: 500 }
+      );
+    }
+  }
+
   // Continue to next middleware or route
   return NextResponse.next();
 }

package/src/generate-proxy.ts

@@ -45,8 +45,8 @@ import type { NextRequest } from 'next/server';
 /**
  * EGDesk Database Proxy (Next.js 16+)
  *
- * Intercepts __user_data_proxy requests and forwards them to the EGDesk MCP server.
- * This allows CORS-free database access in both local and tunneled environments.
+ * Intercepts __user_data_proxy and __browser_recording_proxy requests and forwards them
+ * to the EGDesk MCP HTTP server. This avoids CORS in local and tunneled environments.
  *
  * Generated by @egdesk/next-api-plugin
  */
@@ -88,6 +88,38 @@ export async function proxy(request: NextRequest) {
     }
   }
 
+  if (pathname.includes('__browser_recording_proxy')) {
+    try {
+      const body = await request.text();
+
+      const apiKey = process.env.NEXT_PUBLIC_EGDESK_API_KEY;
+      const apiUrl = process.env.NEXT_PUBLIC_EGDESK_API_URL || 'http://localhost:8080';
+
+      const headers: HeadersInit = {
+        'Content-Type': 'application/json',
+      };
+
+      if (apiKey) {
+        headers['X-Api-Key'] = apiKey;
+      }
+
+      const response = await fetch(\`\${apiUrl}/browser-recording/tools/call\`, {
+        method: 'POST',
+        headers,
+        body,
+      });
+
+      const result = await response.json();
+
+      return NextResponse.json(result, { status: response.status });
+    } catch (error: any) {
+      return NextResponse.json(
+        { error: 'Proxy error', message: error.message },
+        { status: 500 }
+      );
+    }
+  }
+
   // Continue to next proxy or route
   return NextResponse.next();
 }
@@ -96,7 +128,7 @@ export const config = {
   matcher: [
     /*
      * Match all paths except static assets
-     * The proxy function itself filters for __user_data_proxy
+     * The proxy function filters for __user_data_proxy / __browser_recording_proxy
      */
     '/:path*',
   ],

package/src/setup-userdata.ts

@@ -53,14 +53,26 @@ export async function discoverTables(
       })
     });
 
-    if (!listResponse.ok) {
-      throw new Error(`Failed to list tables: ${listResponse.statusText}`);
+    const listResult = await listResponse.json().catch(() => null);
+
+    if (listResult && typeof listResult === 'object' && listResult.success === false) {
+      throw new Error(listResult.error || 'Failed to list tables');
     }
 
-    const listResult = await listResponse.json();
+    if (!listResponse.ok) {
+      const fromBody =
+        listResult && typeof listResult === 'object' && typeof listResult.error === 'string'
+          ? listResult.error
+          : '';
+      throw new Error(fromBody || `Failed to list tables: ${listResponse.status} ${listResponse.statusText}`);
+    }
 
-    if (!listResult.success) {
-      throw new Error(listResult.error || 'Failed to list tables');
+    if (!listResult || !listResult.success) {
+      throw new Error(
+        listResult && typeof listResult === 'object' && listResult.error
+          ? String(listResult.error)
+          : 'Failed to list tables'
+      );
     }
 
     // Parse MCP response