quantix-mcp 1.0.0

package/src/types/schemas.ts

@@ -0,0 +1,193 @@
+import { z } from 'zod';
+
+// --- Domain Entities ---
+
+export const CategorySchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  type: z.enum(["INCOME", "EXPENSE"]),
+  color: z.string().optional(),
+  createdAt: z.string().datetime().optional()
+});
+
+export const TransactionSchema = z.object({
+  id: z.string(),
+  type: z.enum(["INCOME", "EXPENSE"]),
+  name: z.string(),
+  amount: z.number().min(0),
+  date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Invalid date format YYYY-MM-DD"),
+  categoryId: z.string().optional(),
+  paymentMethod: z.enum(["CASH", "PIX", "DEBIT", "CREDIT"]).optional(),
+  creditCardId: z.string().optional(),
+  installmentGroupId: z.string().optional(),
+  installmentNumber: z.number().int().optional(),
+  installmentTotal: z.number().int().optional(),
+  recurrenceRuleId: z.string().optional(),
+  accountId: z.string().optional(),
+  paid: z.boolean().default(false),
+  createdAt: z.string().datetime().optional()
+});
+
+export const CreditCardSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  brand: z.string().optional(),
+  limitAmount: z.number().min(0),
+  closingDay: z.number().int().min(1).max(31),
+  dueDay: z.number().int().min(1).max(31),
+  createdAt: z.string().datetime().optional()
+});
+
+export const AccountSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  type: z.enum(["BANK_ACCOUNT", "WALLET", "SAVINGS_ACCOUNT", "INVESTMENT_ACCOUNT", "OTHER"]),
+  initialBalance: z.number(),
+  currentBalance: z.number().optional(),
+  createdAt: z.string().datetime().optional(),
+  updatedAt: z.string().datetime().optional()
+});
+
+export const AccountBalanceSchema = z.object({
+  accountId: z.string(),
+  currentBalance: z.number(),
+  calculatedAt: z.string().datetime()
+});
+
+export const StatementSchema = z.object({
+  cardId: z.string(),
+  periodStart: z.string(),
+  periodEnd: z.string(),
+  dueDate: z.string(),
+  transactions: z.array(TransactionSchema).optional(),
+  total: z.number(),
+  availableLimit: z.number()
+});
+
+export const StatementStatusSchema = z.object({
+  cardId: z.string(),
+  month: z.string(),
+  isPaid: z.boolean()
+});
+
+export const SummarySchema = z.object({
+  month: z.string(),
+  income: z.number(),
+  expenses: z.number(),
+  balance: z.number(),
+  creditCardStatements: z.array(z.any()).optional()
+});
+
+export const SettingsSchema = z.object({
+  userName: z.string(),
+  language: z.enum(["pt-BR", "en-US"]),
+  currency: z.enum(["BRL", "USD", "EUR", "GBP", "JPY", "CAD", "AUD", "CHF"]),
+  createdAt: z.string().datetime().optional(),
+  updatedAt: z.string().datetime().optional()
+});
+
+// --- Tool Inputs ---
+
+export const CreateCategoryInput = z.object({
+  name: z.string(),
+  type: z.enum(["INCOME", "EXPENSE"]),
+  color: z.string().regex(/^#[0-9A-Fa-f]{6}$/, "Invalid hex color").optional()
+});
+
+export const UpdateCategoryInput = z.object({
+  id: z.string(),
+  name: z.string().optional(),
+  color: z.string().regex(/^#[0-9A-Fa-f]{6}$/, "Invalid hex color").optional()
+});
+
+export const CreateCreditCardInput = z.object({
+  name: z.string(),
+  brand: z.string().optional(),
+  limitAmount: z.number().min(0),
+  closingDay: z.number().int().min(1).max(31),
+  dueDay: z.number().int().min(1).max(31)
+});
+
+export const UpdateCreditCardInput = z.object({
+  id: z.string(),
+  name: z.string().optional(),
+  brand: z.string().optional(),
+  limitAmount: z.number().min(0).optional(),
+  closingDay: z.number().int().min(1).max(31).optional(),
+  dueDay: z.number().int().min(1).max(31).optional()
+});
+
+export const CreateTransactionInput = z.object({
+  type: z.enum(["INCOME", "EXPENSE"]),
+  name: z.string(),
+  amount: z.number().positive(),
+  date: z.string().describe("ISO date string YYYY-MM-DD"),
+  categoryId: z.string().optional(),
+  paymentMethod: z.enum(["CASH", "PIX", "DEBIT", "CREDIT"]).optional(),
+  creditCardId: z.string().optional(),
+  accountId: z.string().optional(),
+  installments: z.number().int().min(1).optional(),
+  targetDueMonth: z.string().regex(/^\d{4}-\d{2}$/).optional(),
+  recurrence: z.object({
+    frequency: z.enum(["MONTHLY", "WEEKLY", "YEARLY"]),
+    interval: z.number().int().min(1).optional(),
+    endDate: z.string().optional()
+  }).optional()
+});
+
+export const UpdateTransactionInput = z.object({
+  id: z.string(),
+  mode: z.enum(["SINGLE", "PENDING", "ALL"]).default("SINGLE").optional(),
+  type: z.enum(["INCOME", "EXPENSE"]).optional(),
+  name: z.string().optional(),
+  amount: z.number().positive().optional(),
+  date: z.string().describe("ISO date string YYYY-MM-DD").optional(),
+  categoryId: z.string().optional(),
+  paymentMethod: z.enum(["CASH", "PIX", "DEBIT", "CREDIT"]).optional(),
+  creditCardId: z.string().optional(),
+  accountId: z.string().optional(),
+  targetDueMonth: z.string().regex(/^\d{4}-\d{2}$/).optional(),
+  recurrence: z.object({
+    frequency: z.enum(["MONTHLY", "WEEKLY", "YEARLY"]).optional(),
+    interval: z.number().int().min(1).optional(),
+    endDate: z.string().optional()
+  }).optional()
+});
+
+export const CreateAccountInput = z.object({
+  name: z.string(),
+  type: z.enum(["BANK_ACCOUNT", "WALLET", "SAVINGS_ACCOUNT", "INVESTMENT_ACCOUNT", "OTHER"]),
+  initialBalance: z.number()
+});
+
+export const UpdateAccountInput = z.object({
+  id: z.string(),
+  name: z.string().optional(),
+  type: z.enum(["BANK_ACCOUNT", "WALLET", "SAVINGS_ACCOUNT", "INVESTMENT_ACCOUNT", "OTHER"]).optional()
+});
+
+export const GetTransactionsInput = z.object({
+  month: z.string().regex(/^\d{4}-\d{2}$/, "Format: YYYY-MM").describe("Format: YYYY-MM").optional()
+});
+
+export const PayStatementInput = z.object({
+  cardId: z.string(),
+  month: z.string().regex(/^\d{4}-\d{2}$/, "Format: YYYY-MM"),
+  paymentAccountId: z.string()
+});
+
+export const GetSummaryInput = z.object({
+  month: z.string().regex(/^\d{4}-\d{2}$/, "Format: YYYY-MM").describe("Format: YYYY-MM")
+});
+
+export const CreateSettingsInput = z.object({
+  userName: z.string(),
+  language: z.enum(["pt-BR", "en-US"]),
+  currency: z.enum(["BRL", "USD", "EUR", "GBP", "JPY", "CAD", "AUD", "CHF"])
+});
+
+export const UpdateSettingsInput = z.object({
+  userName: z.string().optional(),
+  language: z.enum(["pt-BR", "en-US"]).optional(),
+  currency: z.enum(["BRL", "USD", "EUR", "GBP", "JPY", "CAD", "AUD", "CHF"]).optional()
+});

package/tests/benchmark.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=benchmark.test.d.ts.map

package/tests/benchmark.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.test.d.ts","sourceRoot":"","sources":["benchmark.test.ts"],"names":[],"mappings":""}

package/tests/benchmark.test.js

@@ -0,0 +1,33 @@
+import { describe, it, expect, vi } from 'vitest';
+import { registerCategoryTools } from '../src/tools/categories.js';
+import { apiClient } from '../src/services/apiClient.js';
+vi.mock('../src/services/apiClient.js', () => ({
+    apiClient: {
+        get: vi.fn(),
+    }
+}));
+describe('Performance Benchmark', () => {
+    // This is a rough benchmark, mostly verifying it's not super slow due to overhead
+    it('should execute tool handler with low overhead (<20ms)', async () => {
+        const registeredTools = {};
+        const mockServer = {
+            registerTool: (name, def, handler) => {
+                registeredTools[name] = handler;
+            }
+        };
+        // Setup
+        registerCategoryTools(mockServer);
+        const handler = registeredTools['get_categories'];
+        apiClient.get.mockResolvedValue([]);
+        // Warmup
+        await handler({});
+        // Measure
+        const start = performance.now();
+        await handler({});
+        const end = performance.now();
+        const duration = end - start;
+        console.log(`Tool execution overhead: ${duration.toFixed(3)}ms`);
+        expect(duration).toBeLessThan(20);
+    });
+});
+//# sourceMappingURL=benchmark.test.js.map

package/tests/benchmark.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.test.js","sourceRoot":"","sources":["benchmark.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,EAAE,CAAC,IAAI,CAAC,8BAA8B,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7C,SAAS,EAAE;QACT,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE;KACb;CACF,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACnC,kFAAkF;IAClF,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,eAAe,GAA6B,EAAE,CAAC;QACrD,MAAM,UAAU,GAAG;YACf,YAAY,EAAE,CAAC,IAAY,EAAE,GAAQ,EAAE,OAAiB,EAAE,EAAE;gBACxD,eAAe,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;YACpC,CAAC;SACJ,CAAC;QAEF,QAAQ;QACR,qBAAqB,CAAC,UAAiB,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;QACjD,SAAS,CAAC,GAAW,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAE7C,SAAS;QACT,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;QAElB,UAAU;QACV,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAChC,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;QAClB,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,GAAG,GAAG,KAAK,CAAC;QAE7B,OAAO,CAAC,GAAG,CAAC,4BAA4B,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/tests/benchmark.test.ts

@@ -0,0 +1,38 @@
+import { describe, it, expect, vi } from 'vitest';
+import { registerCategoryTools } from '../src/tools/categories.js';
+import { apiClient } from '../src/services/apiClient.js';
+
+vi.mock('../src/services/apiClient.js', () => ({
+  apiClient: {
+    get: vi.fn(),
+  }
+}));
+
+describe('Performance Benchmark', () => {
+    // This is a rough benchmark, mostly verifying it's not super slow due to overhead
+    it('should execute tool handler with low overhead (<20ms)', async () => {
+        const registeredTools: Record<string, Function> = {};
+        const mockServer = {
+            registerTool: (name: string, def: any, handler: Function) => {
+                registeredTools[name] = handler;
+            }
+        };
+
+        // Setup
+        registerCategoryTools(mockServer as any);
+        const handler = registeredTools['get_categories'];
+        (apiClient.get as any).mockResolvedValue([]);
+
+        // Warmup
+        await handler({});
+
+        // Measure
+        const start = performance.now();
+        await handler({});
+        const end = performance.now();
+        const duration = end - start;
+
+        console.log(`Tool execution overhead: ${duration.toFixed(3)}ms`);
+        expect(duration).toBeLessThan(20); 
+    });
+});

package/tests/server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.test.d.ts.map

package/tests/server.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.d.ts","sourceRoot":"","sources":["server.test.ts"],"names":[],"mappings":""}

package/tests/server.test.js

@@ -0,0 +1,13 @@
+import { describe, it, expect, vi } from 'vitest';
+import { getServer } from '../src/index.js';
+describe('Server Startup', () => {
+    it('should initialize McpServer', () => {
+        const server = getServer();
+        expect(server).toBeDefined();
+        // expect(server.server.name).toBe('quantix_mcp_server'); 
+    });
+    // Since we can't easily inspect registered tools without private access or running it, 
+    // we'll mainly check it doesn't crash on init.
+    // With McpServer from SDK, we might be able to check capabilities or similar if exposed.
+});
+//# sourceMappingURL=server.test.js.map

package/tests/server.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.js","sourceRoot":"","sources":["server.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,0DAA0D;IAC5D,CAAC,CAAC,CAAC;IAEH,wFAAwF;IACxF,+CAA+C;IAC/C,yFAAyF;AAC3F,CAAC,CAAC,CAAC"}

package/tests/server.test.ts

@@ -0,0 +1,14 @@
+import { describe, it, expect, vi } from 'vitest';
+import { getServer } from '../src/index.js';
+
+describe('Server Startup', () => {
+  it('should initialize McpServer', () => {
+    const server = getServer();
+    expect(server).toBeDefined();
+    // expect(server.server.name).toBe('quantix_mcp_server'); 
+  });
+
+  // Since we can't easily inspect registered tools without private access or running it, 
+  // we'll mainly check it doesn't crash on init.
+  // With McpServer from SDK, we might be able to check capabilities or similar if exposed.
+});

package/tests/setup.d.ts

@@ -0,0 +1,4 @@
+import { vi } from 'vitest';
+export declare const mockFetch: ReturnType<typeof vi.fn>;
+export declare function resetMocks(): void;
+//# sourceMappingURL=setup.d.ts.map

package/tests/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAK5B,eAAO,MAAM,SAAS,EAA8B,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;AAE7E,wBAAgB,UAAU,SAEzB"}

package/tests/setup.js

@@ -0,0 +1,17 @@
+import { vi } from 'vitest';
+// Define the global fetch if not already (Vitest/Node should have it, but for explicit typing)
+global.fetch = vi.fn();
+export const mockFetch = global.fetch;
+export function resetMocks() {
+    mockFetch.mockReset();
+}
+// Basic mocks for config to ensure tests don't fail on missing env
+vi.mock('../src/config.js', () => ({
+    config: {
+        QUANTIX_API_URL: 'https://test-api.quantix.com',
+        QUANTIX_API_KEY: 'test-key',
+        MCPPORT: '3000',
+        NODE_ENV: 'test'
+    }
+}));
+//# sourceMappingURL=setup.js.map

package/tests/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE5B,+FAA+F;AAC/F,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAEvB,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,KAA4C,CAAC;AAE7E,MAAM,UAAU,UAAU;IACxB,SAAS,CAAC,SAAS,EAAE,CAAC;AACxB,CAAC;AAED,mEAAmE;AACnE,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,MAAM,EAAE;QACN,eAAe,EAAE,8BAA8B;QAC/C,eAAe,EAAE,UAAU;QAC3B,OAAO,EAAE,MAAM;QACf,QAAQ,EAAE,MAAM;KACjB;CACF,CAAC,CAAC,CAAC"}

package/tests/setup.ts

@@ -0,0 +1,20 @@
+import { vi } from 'vitest';
+
+// Define the global fetch if not already (Vitest/Node should have it, but for explicit typing)
+global.fetch = vi.fn();
+
+export const mockFetch = global.fetch as unknown as ReturnType<typeof vi.fn>;
+
+export function resetMocks() {
+  mockFetch.mockReset();
+}
+
+// Basic mocks for config to ensure tests don't fail on missing env
+vi.mock('../src/config.js', () => ({
+  config: {
+    QUANTIX_API_URL: 'https://test-api.quantix.com',
+    QUANTIX_API_KEY: 'test-key',
+    MCPPORT: '3000',
+    NODE_ENV: 'test'
+  }
+}));

package/tests/tools/accounts.test.ts

@@ -0,0 +1,118 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { registerAccountTools } from '../../src/tools/accounts.js';
+import { apiClient } from '../../src/services/apiClient.js';
+
+vi.mock('../../src/services/apiClient.js', () => ({
+  apiClient: {
+    get: vi.fn(),
+    post: vi.fn(),
+    patch: vi.fn(),
+    delete: vi.fn(),
+  }
+}));
+
+describe('Account Tools', () => {
+  let mockServer: any;
+  let registeredTools: Record<string, Function> = {};
+
+  beforeEach(() => {
+    registeredTools = {};
+    mockServer = {
+      registerTool: vi.fn((name, def, handler) => {
+        registeredTools[name] = handler;
+      })
+    };
+    vi.clearAllMocks();
+  });
+
+  it('should register all account tools', () => {
+    registerAccountTools(mockServer);
+    expect(mockServer.registerTool).toHaveBeenCalledTimes(6);
+    expect(registeredTools['create_account']).toBeDefined();
+    expect(registeredTools['get_accounts']).toBeDefined();
+    expect(registeredTools['get_account']).toBeDefined();
+    expect(registeredTools['update_account']).toBeDefined();
+    expect(registeredTools['delete_account']).toBeDefined();
+    expect(registeredTools['get_account_balance']).toBeDefined();
+  });
+
+  describe('create_account', () => {
+    it('should post new account data', async () => {
+      registerAccountTools(mockServer);
+      const handler = registeredTools['create_account'];
+      (apiClient.post as any).mockResolvedValue({ id: 'acc_1', name: 'My Bank' });
+
+      const input = { name: 'My Bank', type: 'BANK_ACCOUNT', initialBalance: 1000 };
+      const result = await handler(input);
+
+      expect(apiClient.post).toHaveBeenCalledWith('/accounts', input);
+      expect(result.content[0].text).toContain('My Bank');
+    });
+  });
+
+  describe('get_accounts', () => {
+    it('should list accounts', async () => {
+      registerAccountTools(mockServer);
+      const handler = registeredTools['get_accounts'];
+      (apiClient.get as any).mockResolvedValue([{ id: 'acc_1', name: 'My Bank' }]);
+
+      const result = await handler({});
+
+      expect(apiClient.get).toHaveBeenCalledWith('/accounts');
+      expect(result.content[0].text).toContain('My Bank');
+    });
+  });
+
+  describe('get_account', () => {
+    it('should get account details', async () => {
+      registerAccountTools(mockServer);
+      const handler = registeredTools['get_account'];
+      (apiClient.get as any).mockResolvedValue({ id: 'acc_1', name: 'My Bank' });
+
+      const result = await handler({ id: 'acc_1' });
+
+      expect(apiClient.get).toHaveBeenCalledWith('/accounts/acc_1');
+      expect(result.content[0].text).toContain('My Bank');
+    });
+  });
+
+  describe('update_account', () => {
+    it('should update account', async () => {
+      registerAccountTools(mockServer);
+      const handler = registeredTools['update_account'];
+      (apiClient.patch as any).mockResolvedValue({ id: 'acc_1', name: 'Updated Name' });
+
+      const input = { id: 'acc_1', name: 'Updated Name' };
+      const result = await handler(input);
+
+      expect(apiClient.patch).toHaveBeenCalledWith('/accounts/acc_1', { name: 'Updated Name' });
+      expect(result.content[0].text).toContain('Updated Name');
+    });
+  });
+
+  describe('delete_account', () => {
+    it('should delete account', async () => {
+      registerAccountTools(mockServer);
+      const handler = registeredTools['delete_account'];
+      (apiClient.delete as any).mockResolvedValue({});
+
+      const result = await handler({ id: 'acc_1' });
+
+      expect(apiClient.delete).toHaveBeenCalledWith('/accounts/acc_1');
+      expect(result.content[0].text).toContain('deleted successfully');
+    });
+  });
+
+  describe('get_account_balance', () => {
+    it('should get account balance', async () => {
+      registerAccountTools(mockServer);
+      const handler = registeredTools['get_account_balance'];
+      (apiClient.get as any).mockResolvedValue({ accountId: 'acc_1', currentBalance: 500 });
+
+      const result = await handler({ id: 'acc_1' });
+
+      expect(apiClient.get).toHaveBeenCalledWith('/accounts/acc_1/balance');
+      expect(result.content[0].text).toContain('500');
+    });
+  });
+});

package/tests/tools/categories.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=categories.test.d.ts.map

package/tests/tools/categories.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.test.d.ts","sourceRoot":"","sources":["categories.test.ts"],"names":[],"mappings":""}

package/tests/tools/categories.test.js

@@ -0,0 +1,63 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { registerCategoryTools } from '../../src/tools/categories.js';
+import { apiClient } from '../../src/services/apiClient.js';
+// Mock apiClient
+vi.mock('../../src/services/apiClient.js', () => ({
+    apiClient: {
+        get: vi.fn(),
+        post: vi.fn(),
+        delete: vi.fn(),
+    }
+}));
+describe('Category Tools', () => {
+    let mockServer;
+    let registeredTools = {};
+    beforeEach(() => {
+        registeredTools = {};
+        mockServer = {
+            registerTool: vi.fn((name, def, handler) => {
+                registeredTools[name] = handler;
+            })
+        };
+        vi.clearAllMocks();
+    });
+    it('should register category tools', () => {
+        registerCategoryTools(mockServer);
+        expect(mockServer.registerTool).toHaveBeenCalledTimes(3);
+        expect(registeredTools['create_category']).toBeDefined();
+        expect(registeredTools['get_categories']).toBeDefined();
+        expect(registeredTools['delete_category']).toBeDefined();
+    });
+    describe('create_category', () => {
+        it('should call api.post with correct data', async () => {
+            registerCategoryTools(mockServer);
+            const handler = registeredTools['create_category'];
+            apiClient.post.mockResolvedValue({ id: 'cat_1', name: 'Test' });
+            const result = await handler({ name: 'Test', type: 'EXPENSE' });
+            expect(apiClient.post).toHaveBeenCalledWith('/categories', { name: 'Test', type: 'EXPENSE' });
+            expect(result.content[0].text).toContain('Category created');
+            expect(result.content[0].text).toContain('Test');
+        });
+    });
+    describe('get_categories', () => {
+        it('should call api.get', async () => {
+            registerCategoryTools(mockServer);
+            const handler = registeredTools['get_categories'];
+            apiClient.get.mockResolvedValue([{ id: 'cat_1', name: 'Test' }]);
+            const result = await handler({});
+            expect(apiClient.get).toHaveBeenCalledWith('/categories');
+            expect(result.content[0].text).toContain('Test');
+        });
+    });
+    describe('delete_category', () => {
+        it('should call api.delete', async () => {
+            registerCategoryTools(mockServer);
+            const handler = registeredTools['delete_category'];
+            apiClient.delete.mockResolvedValue({});
+            const result = await handler({ id: 'cat_1' });
+            expect(apiClient.delete).toHaveBeenCalledWith('/categories/cat_1');
+            expect(result.content[0].text).toContain('Category deleted');
+        });
+    });
+});
+//# sourceMappingURL=categories.test.js.map

package/tests/tools/categories.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.test.js","sourceRoot":"","sources":["categories.test.ts"],"names":[],"mappings":"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"}

package/tests/tools/categories.test.ts

@@ -0,0 +1,78 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { registerCategoryTools } from '../../src/tools/categories.js';
+import { apiClient } from '../../src/services/apiClient.js';
+
+// Mock apiClient
+vi.mock('../../src/services/apiClient.js', () => ({
+  apiClient: {
+    get: vi.fn(),
+    post: vi.fn(),
+    delete: vi.fn(),
+  }
+}));
+
+describe('Category Tools', () => {
+  let mockServer: any;
+  let registeredTools: Record<string, Function> = {};
+
+  beforeEach(() => {
+    registeredTools = {};
+    mockServer = {
+      registerTool: vi.fn((name, def, handler) => {
+        registeredTools[name] = handler;
+      })
+    };
+    vi.clearAllMocks();
+  });
+
+  it('should register category tools', () => {
+    registerCategoryTools(mockServer);
+    expect(mockServer.registerTool).toHaveBeenCalledTimes(3);
+    expect(registeredTools['create_category']).toBeDefined();
+    expect(registeredTools['get_categories']).toBeDefined();
+    expect(registeredTools['delete_category']).toBeDefined();
+  });
+
+  describe('create_category', () => {
+    it('should call api.post with correct data', async () => {
+      registerCategoryTools(mockServer);
+      const handler = registeredTools['create_category'];
+      
+      (apiClient.post as any).mockResolvedValue({ id: 'cat_1', name: 'Test' });
+
+      const result = await handler({ name: 'Test', type: 'EXPENSE' });
+
+      expect(apiClient.post).toHaveBeenCalledWith('/categories', { name: 'Test', type: 'EXPENSE' });
+      expect(result.content[0].text).toContain('Category created');
+      expect(result.content[0].text).toContain('Test');
+    });
+  });
+
+  describe('get_categories', () => {
+    it('should call api.get', async () => {
+      registerCategoryTools(mockServer);
+      const handler = registeredTools['get_categories'];
+      
+      (apiClient.get as any).mockResolvedValue([{ id: 'cat_1', name: 'Test' }]);
+
+      const result = await handler({});
+
+      expect(apiClient.get).toHaveBeenCalledWith('/categories');
+      expect(result.content[0].text).toContain('Test');
+    });
+  });
+
+  describe('delete_category', () => {
+    it('should call api.delete', async () => {
+      registerCategoryTools(mockServer);
+      const handler = registeredTools['delete_category'];
+      
+      (apiClient.delete as any).mockResolvedValue({});
+
+      const result = await handler({ id: 'cat_1' });
+
+      expect(apiClient.delete).toHaveBeenCalledWith('/categories/cat_1');
+      expect(result.content[0].text).toContain('Category deleted');
+    });
+  });
+});

package/tests/tools/credit-cards.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=credit-cards.test.d.ts.map

package/tests/tools/credit-cards.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-cards.test.d.ts","sourceRoot":"","sources":["credit-cards.test.ts"],"names":[],"mappings":""}