@hed-hog/finance 0.0.350 → 0.0.353

package/src/mcp-tools/finance-statements.mcp-tools.ts

@@ -0,0 +1,202 @@
+import { McpContext, McpTool } from '@hed-hog/core';
+import { BadRequestException, Injectable } from '@nestjs/common';
+import { FinanceService } from '../finance.service';
+
+@Injectable()
+export class FinanceStatementsMcpTools {
+  constructor(private readonly financeService: FinanceService) {}
+
+  @McpTool({
+    name: 'finance.statements.list',
+    description: 'Lists bank statements with filters and pagination.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+        bank_account_id: { type: 'number', description: 'Bank account ID filter' },
+        search: { type: 'string', description: 'Search term' },
+        from: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+        to: { type: 'string', description: 'End date (YYYY-MM-DD)' },
+      },
+    },
+    readOnly: true,
+  })
+  async list(args: Record<string, any>, _context: McpContext): Promise<any> {
+    const { page, pageSize, bank_account_id, search, from, to } = args;
+    return this.financeService.listBankStatements(
+      { page, pageSize } as any,
+      bank_account_id,
+      search,
+      { from, to },
+    );
+  }
+
+  @McpTool({
+    name: 'finance.bank-reconciliation.summary',
+    description: 'Returns bank reconciliation summary for a bank account.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        bank_account_id: { type: 'number', description: 'Bank account ID' },
+      },
+      required: ['bank_account_id'],
+    },
+    readOnly: true,
+  })
+  async summary(args: { bank_account_id: number }, _context: McpContext): Promise<any> {
+    return this.financeService.getBankReconciliationSummary(args.bank_account_id);
+  }
+
+  @McpTool({
+    name: 'finance.bank-reconciliations.create',
+    description: 'Creates a bank reconciliation.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        bank_account_id: { type: 'number', description: 'Bank account ID' },
+        reconciliation_date: { type: 'string', description: 'Reconciliation date (YYYY-MM-DD)' },
+      },
+      required: ['bank_account_id'],
+    },
+  })
+  async createBankReconciliation(args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.financeService.createBankReconciliation(args as any, context.locale, context.userId);
+  }
+
+  @McpTool({
+    name: 'finance.statements.export',
+    description: 'Exports bank statements in CSV content.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        bank_account_id: { type: 'number', description: 'Bank account ID' },
+        search: { type: 'string', description: 'Search term' },
+        from: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+        to: { type: 'string', description: 'End date (YYYY-MM-DD)' },
+      },
+      required: ['bank_account_id'],
+    },
+    readOnly: true,
+  })
+  async export(args: { bank_account_id: number; search?: string; from?: string; to?: string }, _context: McpContext): Promise<any> {
+    return this.financeService.exportBankStatementsCsv(args.bank_account_id, args.search, {
+      from: args.from,
+      to: args.to,
+    });
+  }
+
+  @McpTool({
+    name: 'finance.statements.import',
+    description: 'Imports bank statements from a base64 file payload.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        bank_account_id: { type: 'number', description: 'Bank account ID' },
+        fileBase64: { type: 'string', description: 'Base64-encoded file content' },
+        fileName: { type: 'string', description: 'Original file name' },
+        mimeType: { type: 'string', description: 'File MIME type' },
+      },
+      required: ['bank_account_id', 'fileBase64', 'fileName', 'mimeType'],
+    },
+  })
+  async import(args: { bank_account_id: number; fileBase64: string; fileName: string; mimeType: string }, context: McpContext): Promise<any> {
+    const file = this.toMulterFile(args.fileBase64, args.fileName, args.mimeType);
+    return this.financeService.importBankStatements(
+      args.bank_account_id,
+      file,
+      context.locale,
+      context.userId,
+    );
+  }
+
+  @McpTool({
+    name: 'finance.statements.adjustments.create',
+    description: 'Creates a bank statement adjustment.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        bank_statement_entry_id: { type: 'number', description: 'Statement entry ID' },
+        adjustment_type: { type: 'string', description: 'Adjustment type' },
+        amount: { type: 'number', description: 'Adjustment amount' },
+      },
+      required: ['bank_statement_entry_id', 'adjustment_type', 'amount'],
+    },
+  })
+  async createAdjustment(args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.financeService.createBankStatementAdjustment(args as any, context.userId);
+  }
+
+  @McpTool({
+    name: 'finance.statements.create',
+    description: 'Creates a bank statement entry.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        bank_account_id: { type: 'number', description: 'Bank account ID' },
+        date: { type: 'string', description: 'Entry date (YYYY-MM-DD)' },
+        amount: { type: 'number', description: 'Entry amount' },
+        kind: { type: 'string', description: 'Entry kind' },
+      },
+      required: ['bank_account_id', 'date', 'amount', 'kind'],
+    },
+  })
+  async create(args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.financeService.createBankStatementEntry(args as any, context.userId);
+  }
+
+  @McpTool({
+    name: 'finance.statements.update',
+    description: 'Updates a bank statement entry.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Statement entry ID' },
+      },
+      required: ['id'],
+    },
+  })
+  async update(args: { id: number; [key: string]: any }, context: McpContext): Promise<any> {
+    const { id, ...data } = args;
+    return this.financeService.updateBankStatementEntry(id, data as any, context.userId);
+  }
+
+  @McpTool({
+    name: 'finance.statements.delete',
+    description: 'Deletes a bank statement entry.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Statement entry ID' },
+      },
+      required: ['id'],
+    },
+  })
+  async delete(args: { id: number }, context: McpContext): Promise<any> {
+    return this.financeService.deleteBankStatementEntry(args.id, context.userId);
+  }
+
+  private toMulterFile(fileBase64: string, fileName: string, mimeType: string): MulterFile {
+    if (!fileBase64 || !fileName || !mimeType) {
+      throw new BadRequestException('bank_account_id, fileBase64, fileName and mimeType are required');
+    }
+
+    const buffer = Buffer.from(fileBase64, 'base64');
+
+    if (!buffer.length) {
+      throw new BadRequestException('Invalid fileBase64 payload');
+    }
+
+    return {
+      fieldname: 'file',
+      originalname: fileName,
+      encoding: '7bit',
+      mimetype: mimeType,
+      size: buffer.length,
+      destination: '',
+      filename: fileName,
+      path: '',
+      buffer,
+    };
+  }
+}

package/src/mcp-tools/finance-transfers.mcp-tools.ts

@@ -0,0 +1,53 @@
+import { McpContext, McpTool } from '@hed-hog/core';
+import { Injectable } from '@nestjs/common';
+import { FinanceService } from '../finance.service';
+
+@Injectable()
+export class FinanceTransfersMcpTools {
+  constructor(private readonly financeService: FinanceService) {}
+
+  @McpTool({
+    name: 'finance.transfers.list',
+    description: 'Lists transfers with filters and pagination.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+        search: { type: 'string', description: 'Search term' },
+        bank_account_id: { type: 'string', description: 'Bank account ID filter' },
+        from: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+        to: { type: 'string', description: 'End date (YYYY-MM-DD)' },
+      },
+    },
+    readOnly: true,
+  })
+  async list(args: Record<string, any>, _context: McpContext): Promise<any> {
+    const { page, pageSize, search, bank_account_id, from, to } = args;
+    return this.financeService.listTransfers({ page, pageSize } as any, {
+      search,
+      bank_account_id,
+      from,
+      to,
+    });
+  }
+
+  @McpTool({
+    name: 'finance.transfers.create',
+    description: 'Creates a transfer between bank accounts.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        source_account_id: { type: 'number', description: 'Source account ID' },
+        destination_account_id: { type: 'number', description: 'Destination account ID' },
+        date: { type: 'string', description: 'Transfer date (YYYY-MM-DD)' },
+        amount: { type: 'number', description: 'Amount' },
+        description: { type: 'string', description: 'Optional description' },
+      },
+      required: ['source_account_id', 'destination_account_id', 'date', 'amount'],
+    },
+  })
+  async create(args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.financeService.createTransfer(args as any, context.userId);
+  }
+}