@egdesk/next-api-plugin 1.1.0 → 1.2.0

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/package.json

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

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');