@egdesk/next-api-plugin 1.1.0 → 1.2.2

package/dist/generate-api-wrapper.js

@@ -88,7 +88,8 @@ function generateApiWrapper(projectPath) {
  * Generated by @egdesk/next-api-plugin
  */
 
-const basePath = process.env.NEXT_PUBLIC_EGDESK_BASE_PATH || '';
+const isDev = process.env.NODE_ENV === 'development';
+const basePath = isDev ? '' : (process.env.NEXT_PUBLIC_EGDESK_BASE_PATH || '');
 
 /**
  * Fetch wrapper that handles basePath for tunneled environments

package/dist/generate-helpers.js

@@ -48,9 +48,9 @@ const os = __importStar(require("os"));
 function generateHelpers(projectPath) {
     const helperPath = path.join(projectPath, 'egdesk-helpers.ts');
     const helperContent = `/**
- * EGDesk User Data Helper Functions for Next.js
+ * EGDesk Helper Functions for Next.js
  *
- * Type-safe helpers for accessing EGDesk user data.
+ * Type-safe helpers for accessing EGDesk user data and FinanceHub.
  * Works in both client and server components.
  *
  * Generated by @egdesk/next-api-plugin
@@ -286,6 +286,159 @@ export async function renameTable(
     newDisplayName
   });
 }
+
+// ==========================================
+// FINANCEHUB HELPERS
+// ==========================================
+
+/**
+ * Call EGDesk FinanceHub MCP tool
+ */
+export async function callFinanceHubTool(
+  toolName: string,
+  args: Record<string, any> = {}
+): Promise<any> {
+  const body = JSON.stringify({ tool: toolName, 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}/financehub/tools/call\`, {
+      method: 'POST',
+      headers,
+      body
+    });
+  } else {
+    response = await fetch('/__financehub_proxy', {
+      method: 'POST',
+      headers,
+      body
+    });
+  }
+
+  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;
+}
+
+/**
+ * List all registered banks and card companies
+ */
+export async function listBanks() {
+  return callFinanceHubTool('financehub_list_banks', {});
+}
+
+/**
+ * List bank accounts with balances
+ */
+export async function listAccounts(options: {
+  bankId?: string;
+  isActive?: boolean;
+} = {}) {
+  return callFinanceHubTool('financehub_list_accounts', options);
+}
+
+/**
+ * Query bank transactions
+ */
+export async function queryBankTransactions(options: {
+  accountId?: string;
+  bankId?: string;
+  startDate?: string;
+  endDate?: string;
+  category?: string;
+  minAmount?: number;
+  maxAmount?: number;
+  searchText?: string;
+  limit?: number;
+  offset?: number;
+  orderBy?: 'date' | 'amount' | 'balance';
+  orderDir?: 'asc' | 'desc';
+} = {}) {
+  return callFinanceHubTool('financehub_query_transactions', options);
+}
+
+/**
+ * Query card transactions (NEW)
+ */
+export async function queryCardTransactions(options: {
+  accountId?: string;
+  cardCompanyId?: string;
+  cardNumber?: string;
+  merchantName?: string;
+  startDate?: string;
+  endDate?: string;
+  category?: string;
+  minAmount?: number;
+  maxAmount?: number;
+  includeCancelled?: boolean;
+  limit?: number;
+  offset?: number;
+  orderBy?: 'date' | 'amount';
+  orderDir?: 'asc' | 'desc';
+} = {}) {
+  return callFinanceHubTool('financehub_query_card_transactions', options);
+}
+
+/**
+ * Get transaction statistics
+ */
+export async function getTransactionStats(options: {
+  accountId?: string;
+  bankId?: string;
+  startDate?: string;
+  endDate?: string;
+} = {}) {
+  return callFinanceHubTool('financehub_get_statistics', options);
+}
+
+/**
+ * Get monthly breakdown of deposits/withdrawals
+ */
+export async function getMonthlySummary(options: {
+  accountId?: string;
+  bankId?: string;
+  year?: number;
+  months?: number;
+} = {}) {
+  return callFinanceHubTool('financehub_get_monthly_summary', options);
+}
+
+/**
+ * Get overall stats (banks, accounts, transactions, balances)
+ */
+export async function getOverallStats() {
+  return callFinanceHubTool('financehub_get_overall_stats', {});
+}
+
+/**
+ * Get sync operation history
+ */
+export async function getSyncHistory(limit: number = 50) {
+  return callFinanceHubTool('financehub_get_sync_history', { limit });
+}
 `;
     fs.writeFileSync(helperPath, helperContent.replace(/\r?\n/g, os.EOL), 'utf-8');
     console.log(`✅ Generated ${helperPath}`);

package/dist/setup-userdata.d.ts

@@ -9,7 +9,8 @@ export interface UserDataTable {
     tableName: string;
     displayName: string;
     description?: string;
-    rowCount: number;
+    /** May be unknown until the table is synced or counted */
+    rowCount?: number;
     columnCount: number;
     columns: string[];
 }

package/dist/setup-userdata.js

@@ -163,7 +163,7 @@ function updateEnvLocal(projectPath, config) {
         '',
         '# Available Tables',
         `# Total tables: ${config.tables.length}`,
-        ...config.tables.map((table, index) => `# ${index + 1}. ${table.displayName} (${table.tableName}) - ${table.rowCount} rows, ${table.columnCount} columns`),
+        ...config.tables.map((table, index) => `# ${index + 1}. ${table.displayName} (${table.tableName}) - ${table.rowCount != null ? table.rowCount : '?'} rows, ${table.columnCount} columns`),
         ''
     ].join('\n');
     fs.writeFileSync(envPath, envContent.replace(/\r?\n/g, os.EOL), 'utf-8');
@@ -190,20 +190,26 @@ export interface TableDefinition {
   name: string;
   displayName: string;
   description?: string;
-  rowCount: number;
+  /** Omitted or unknown until synced / counted */
+  rowCount?: number;
   columnCount: number;
   columns: string[];
 }
 
 export const TABLES = {
-${config.tables.map((table, index) => `  table${index + 1}: {
-    name: '${table.tableName}',
-    displayName: '${table.displayName}',
-    description: ${table.description ? `'${table.description}'` : 'undefined'},
-    rowCount: ${table.rowCount},
-    columnCount: ${table.columnCount},
-    columns: [${table.columns.map(col => `'${col}'`).join(', ')}]
-  } as TableDefinition`).join(',\n')}
+${config.tables.map((table, index) => {
+        const properties = [
+            `name: '${table.tableName}'`,
+            `displayName: '${table.displayName}'`,
+            table.description ? `description: '${table.description}'` : null,
+            table.rowCount != null ? `rowCount: ${table.rowCount}` : null,
+            `columnCount: ${table.columnCount}`,
+            `columns: [${table.columns.map(col => `'${col}'`).join(', ')}]`
+        ].filter(Boolean).join(',\n    ');
+        return `  table${index + 1}: {
+    ${properties}
+  } as TableDefinition`;
+    }).join(',\n')}
 } as const;
 
 ${config.tables.length > 0 ? `

package/package.json

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

package/src/generate-api-wrapper.ts

@@ -61,7 +61,8 @@ export function generateApiWrapper(projectPath: string): void {
  * Generated by @egdesk/next-api-plugin
  */
 
-const basePath = process.env.NEXT_PUBLIC_EGDESK_BASE_PATH || '';
+const isDev = process.env.NODE_ENV === 'development';
+const basePath = isDev ? '' : (process.env.NEXT_PUBLIC_EGDESK_BASE_PATH || '');
 
 /**
  * Fetch wrapper that handles basePath for tunneled environments

package/src/generate-helpers.ts

@@ -15,9 +15,9 @@ export function generateHelpers(projectPath: string): void {
   const helperPath = path.join(projectPath, 'egdesk-helpers.ts');
 
   const helperContent = `/**
- * EGDesk User Data Helper Functions for Next.js
+ * EGDesk Helper Functions for Next.js
  *
- * Type-safe helpers for accessing EGDesk user data.
+ * Type-safe helpers for accessing EGDesk user data and FinanceHub.
  * Works in both client and server components.
  *
  * Generated by @egdesk/next-api-plugin
@@ -253,6 +253,159 @@ export async function renameTable(
     newDisplayName
   });
 }
+
+// ==========================================
+// FINANCEHUB HELPERS
+// ==========================================
+
+/**
+ * Call EGDesk FinanceHub MCP tool
+ */
+export async function callFinanceHubTool(
+  toolName: string,
+  args: Record<string, any> = {}
+): Promise<any> {
+  const body = JSON.stringify({ tool: toolName, 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}/financehub/tools/call\`, {
+      method: 'POST',
+      headers,
+      body
+    });
+  } else {
+    response = await fetch('/__financehub_proxy', {
+      method: 'POST',
+      headers,
+      body
+    });
+  }
+
+  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;
+}
+
+/**
+ * List all registered banks and card companies
+ */
+export async function listBanks() {
+  return callFinanceHubTool('financehub_list_banks', {});
+}
+
+/**
+ * List bank accounts with balances
+ */
+export async function listAccounts(options: {
+  bankId?: string;
+  isActive?: boolean;
+} = {}) {
+  return callFinanceHubTool('financehub_list_accounts', options);
+}
+
+/**
+ * Query bank transactions
+ */
+export async function queryBankTransactions(options: {
+  accountId?: string;
+  bankId?: string;
+  startDate?: string;
+  endDate?: string;
+  category?: string;
+  minAmount?: number;
+  maxAmount?: number;
+  searchText?: string;
+  limit?: number;
+  offset?: number;
+  orderBy?: 'date' | 'amount' | 'balance';
+  orderDir?: 'asc' | 'desc';
+} = {}) {
+  return callFinanceHubTool('financehub_query_transactions', options);
+}
+
+/**
+ * Query card transactions (NEW)
+ */
+export async function queryCardTransactions(options: {
+  accountId?: string;
+  cardCompanyId?: string;
+  cardNumber?: string;
+  merchantName?: string;
+  startDate?: string;
+  endDate?: string;
+  category?: string;
+  minAmount?: number;
+  maxAmount?: number;
+  includeCancelled?: boolean;
+  limit?: number;
+  offset?: number;
+  orderBy?: 'date' | 'amount';
+  orderDir?: 'asc' | 'desc';
+} = {}) {
+  return callFinanceHubTool('financehub_query_card_transactions', options);
+}
+
+/**
+ * Get transaction statistics
+ */
+export async function getTransactionStats(options: {
+  accountId?: string;
+  bankId?: string;
+  startDate?: string;
+  endDate?: string;
+} = {}) {
+  return callFinanceHubTool('financehub_get_statistics', options);
+}
+
+/**
+ * Get monthly breakdown of deposits/withdrawals
+ */
+export async function getMonthlySummary(options: {
+  accountId?: string;
+  bankId?: string;
+  year?: number;
+  months?: number;
+} = {}) {
+  return callFinanceHubTool('financehub_get_monthly_summary', options);
+}
+
+/**
+ * Get overall stats (banks, accounts, transactions, balances)
+ */
+export async function getOverallStats() {
+  return callFinanceHubTool('financehub_get_overall_stats', {});
+}
+
+/**
+ * Get sync operation history
+ */
+export async function getSyncHistory(limit: number = 50) {
+  return callFinanceHubTool('financehub_get_sync_history', { limit });
+}
 `;
 
   fs.writeFileSync(helperPath, helperContent.replace(/\r?\n/g, os.EOL), 'utf-8');

package/src/setup-userdata.ts

@@ -14,7 +14,8 @@ export interface UserDataTable {
   tableName: string;
   displayName: string;
   description?: string;
-  rowCount: number;
+  /** May be unknown until the table is synced or counted */
+  rowCount?: number;
   columnCount: number;
   columns: string[];
 }
@@ -168,7 +169,7 @@ export function updateEnvLocal(
     '# Available Tables',
     `# Total tables: ${config.tables.length}`,
     ...config.tables.map((table, index) =>
-      `# ${index + 1}. ${table.displayName} (${table.tableName}) - ${table.rowCount} rows, ${table.columnCount} columns`
+      `# ${index + 1}. ${table.displayName} (${table.tableName}) - ${table.rowCount != null ? table.rowCount : '?'} rows, ${table.columnCount} columns`
     ),
     ''
   ].join('\n');
@@ -202,20 +203,27 @@ export interface TableDefinition {
   name: string;
   displayName: string;
   description?: string;
-  rowCount: number;
+  /** Omitted or unknown until synced / counted */
+  rowCount?: number;
   columnCount: number;
   columns: string[];
 }
 
 export const TABLES = {
-${config.tables.map((table, index) => `  table${index + 1}: {
-    name: '${table.tableName}',
-    displayName: '${table.displayName}',
-    description: ${table.description ? `'${table.description}'` : 'undefined'},
-    rowCount: ${table.rowCount},
-    columnCount: ${table.columnCount},
-    columns: [${table.columns.map(col => `'${col}'`).join(', ')}]
-  } as TableDefinition`).join(',\n')}
+${config.tables.map((table, index) => {
+  const properties = [
+    `name: '${table.tableName}'`,
+    `displayName: '${table.displayName}'`,
+    table.description ? `description: '${table.description}'` : null,
+    table.rowCount != null ? `rowCount: ${table.rowCount}` : null,
+    `columnCount: ${table.columnCount}`,
+    `columns: [${table.columns.map(col => `'${col}'`).join(', ')}]`
+  ].filter(Boolean).join(',\n    ');
+
+  return `  table${index + 1}: {
+    ${properties}
+  } as TableDefinition`;
+}).join(',\n')}
 } as const;
 
 ${config.tables.length > 0 ? `