@hasna/microservices 0.0.3 → 0.0.4

package/microservices/microservice-payments/src/mcp/index.ts

@@ -0,0 +1,460 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import {
+  createPayment,
+  getPayment,
+  listPayments,
+  updatePayment,
+  deletePayment,
+  refundPayment,
+  searchPayments,
+  getRevenueReport,
+  getRevenueByCustomer,
+  reconcileWithInvoice,
+  getPaymentStats,
+  getBalanceByProvider,
+  listByProvider,
+} from "../db/payments.js";
+import {
+  createDispute,
+  getDispute,
+  listDisputes,
+  respondDispute,
+  deleteDispute,
+} from "../db/payments.js";
+import {
+  createPayout,
+  getPayout,
+  listPayouts,
+  updatePayout,
+  deletePayout,
+} from "../db/payments.js";
+
+const server = new McpServer({
+  name: "microservice-payments",
+  version: "0.0.1",
+});
+
+// --- Payments ---
+
+server.registerTool(
+  "create_payment",
+  {
+    title: "Create Payment",
+    description: "Create a new payment record.",
+    inputSchema: {
+      type: z.enum(["charge", "refund", "transfer", "payout"]),
+      amount: z.number(),
+      currency: z.string().optional(),
+      status: z.enum(["pending", "succeeded", "failed", "disputed", "refunded"]).optional(),
+      customer_name: z.string().optional(),
+      customer_email: z.string().optional(),
+      description: z.string().optional(),
+      provider: z.enum(["stripe", "square", "mercury", "manual"]).optional(),
+      provider_id: z.string().optional(),
+      invoice_id: z.string().optional(),
+    },
+  },
+  async (params) => {
+    const payment = createPayment(params);
+    return { content: [{ type: "text", text: JSON.stringify(payment, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "get_payment",
+  {
+    title: "Get Payment",
+    description: "Get a payment by ID.",
+    inputSchema: { id: z.string() },
+  },
+  async ({ id }) => {
+    const payment = getPayment(id);
+    if (!payment) {
+      return { content: [{ type: "text", text: `Payment '${id}' not found.` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(payment, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "list_payments",
+  {
+    title: "List Payments",
+    description: "List payments with optional filters.",
+    inputSchema: {
+      status: z.enum(["pending", "succeeded", "failed", "disputed", "refunded"]).optional(),
+      type: z.enum(["charge", "refund", "transfer", "payout"]).optional(),
+      provider: z.enum(["stripe", "square", "mercury", "manual"]).optional(),
+      customer_email: z.string().optional(),
+      limit: z.number().optional(),
+    },
+  },
+  async (params) => {
+    const payments = listPayments(params);
+    return {
+      content: [
+        { type: "text", text: JSON.stringify({ payments, count: payments.length }, null, 2) },
+      ],
+    };
+  }
+);
+
+server.registerTool(
+  "update_payment",
+  {
+    title: "Update Payment",
+    description: "Update an existing payment.",
+    inputSchema: {
+      id: z.string(),
+      status: z.enum(["pending", "succeeded", "failed", "disputed", "refunded"]).optional(),
+      customer_name: z.string().optional(),
+      customer_email: z.string().optional(),
+      description: z.string().optional(),
+      provider: z.enum(["stripe", "square", "mercury", "manual"]).optional(),
+      provider_id: z.string().optional(),
+      invoice_id: z.string().optional(),
+    },
+  },
+  async ({ id, ...input }) => {
+    const payment = updatePayment(id, input);
+    if (!payment) {
+      return { content: [{ type: "text", text: `Payment '${id}' not found.` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(payment, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "delete_payment",
+  {
+    title: "Delete Payment",
+    description: "Delete a payment by ID.",
+    inputSchema: { id: z.string() },
+  },
+  async ({ id }) => {
+    const deleted = deletePayment(id);
+    return { content: [{ type: "text", text: JSON.stringify({ id, deleted }) }] };
+  }
+);
+
+server.registerTool(
+  "refund_payment",
+  {
+    title: "Refund Payment",
+    description: "Refund a succeeded payment. Creates a refund record and marks the original as refunded.",
+    inputSchema: {
+      id: z.string(),
+      amount: z.number().optional(),
+    },
+  },
+  async ({ id, amount }) => {
+    const refund = refundPayment(id, amount);
+    if (!refund) {
+      return {
+        content: [{ type: "text", text: `Cannot refund payment '${id}' — not found or not succeeded.` }],
+        isError: true,
+      };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(refund, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "search_payments",
+  {
+    title: "Search Payments",
+    description: "Search payments by customer name, email, description, provider ID, or invoice ID.",
+    inputSchema: { query: z.string() },
+  },
+  async ({ query }) => {
+    const results = searchPayments(query);
+    return {
+      content: [
+        { type: "text", text: JSON.stringify({ results, count: results.length }, null, 2) },
+      ],
+    };
+  }
+);
+
+server.registerTool(
+  "revenue_report",
+  {
+    title: "Revenue Report",
+    description: "Get revenue report for a date range.",
+    inputSchema: {
+      start_date: z.string(),
+      end_date: z.string(),
+    },
+  },
+  async ({ start_date, end_date }) => {
+    const report = getRevenueReport(start_date, end_date);
+    return { content: [{ type: "text", text: JSON.stringify(report, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "revenue_by_customer",
+  {
+    title: "Revenue by Customer",
+    description: "Get revenue breakdown by customer.",
+    inputSchema: {},
+  },
+  async () => {
+    const revenue = getRevenueByCustomer();
+    return { content: [{ type: "text", text: JSON.stringify(revenue, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "reconcile_payment",
+  {
+    title: "Reconcile Payment",
+    description: "Link a payment to an invoice ID for reconciliation.",
+    inputSchema: {
+      payment_id: z.string(),
+      invoice_id: z.string(),
+    },
+  },
+  async ({ payment_id, invoice_id }) => {
+    const payment = reconcileWithInvoice(payment_id, invoice_id);
+    if (!payment) {
+      return { content: [{ type: "text", text: `Payment '${payment_id}' not found.` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(payment, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "payment_stats",
+  {
+    title: "Payment Statistics",
+    description: "Get overall payment statistics.",
+    inputSchema: {},
+  },
+  async () => {
+    const stats = getPaymentStats();
+    return { content: [{ type: "text", text: JSON.stringify(stats, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "balance_by_provider",
+  {
+    title: "Balance by Provider",
+    description: "Get balance breakdown by payment provider.",
+    inputSchema: {},
+  },
+  async () => {
+    const balances = getBalanceByProvider();
+    return { content: [{ type: "text", text: JSON.stringify(balances, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "list_by_provider",
+  {
+    title: "List by Provider",
+    description: "List all payments for a specific provider.",
+    inputSchema: {
+      provider: z.enum(["stripe", "square", "mercury", "manual"]),
+    },
+  },
+  async ({ provider }) => {
+    const payments = listByProvider(provider);
+    return {
+      content: [
+        { type: "text", text: JSON.stringify({ payments, count: payments.length }, null, 2) },
+      ],
+    };
+  }
+);
+
+// --- Disputes ---
+
+server.registerTool(
+  "create_dispute",
+  {
+    title: "Create Dispute",
+    description: "Create a dispute for a payment.",
+    inputSchema: {
+      payment_id: z.string(),
+      reason: z.string().optional(),
+      amount: z.number().optional(),
+    },
+  },
+  async (params) => {
+    const dispute = createDispute(params);
+    return { content: [{ type: "text", text: JSON.stringify(dispute, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "get_dispute",
+  {
+    title: "Get Dispute",
+    description: "Get a dispute by ID.",
+    inputSchema: { id: z.string() },
+  },
+  async ({ id }) => {
+    const dispute = getDispute(id);
+    if (!dispute) {
+      return { content: [{ type: "text", text: `Dispute '${id}' not found.` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(dispute, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "list_disputes",
+  {
+    title: "List Disputes",
+    description: "List disputes with optional status filter.",
+    inputSchema: {
+      status: z.enum(["open", "under_review", "won", "lost"]).optional(),
+    },
+  },
+  async ({ status }) => {
+    const disputes = listDisputes(status);
+    return {
+      content: [
+        { type: "text", text: JSON.stringify({ disputes, count: disputes.length }, null, 2) },
+      ],
+    };
+  }
+);
+
+server.registerTool(
+  "respond_dispute",
+  {
+    title: "Respond to Dispute",
+    description: "Respond to a dispute — update status and optionally add evidence.",
+    inputSchema: {
+      id: z.string(),
+      status: z.enum(["open", "under_review", "won", "lost"]),
+    },
+  },
+  async ({ id, status }) => {
+    const dispute = respondDispute(id, { status });
+    if (!dispute) {
+      return { content: [{ type: "text", text: `Dispute '${id}' not found.` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(dispute, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "delete_dispute",
+  {
+    title: "Delete Dispute",
+    description: "Delete a dispute by ID.",
+    inputSchema: { id: z.string() },
+  },
+  async ({ id }) => {
+    const deleted = deleteDispute(id);
+    return { content: [{ type: "text", text: JSON.stringify({ id, deleted }) }] };
+  }
+);
+
+// --- Payouts ---
+
+server.registerTool(
+  "create_payout",
+  {
+    title: "Create Payout",
+    description: "Initiate a new payout.",
+    inputSchema: {
+      amount: z.number(),
+      currency: z.string().optional(),
+      destination: z.string().optional(),
+    },
+  },
+  async (params) => {
+    const payout = createPayout(params);
+    return { content: [{ type: "text", text: JSON.stringify(payout, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "get_payout",
+  {
+    title: "Get Payout",
+    description: "Get a payout by ID.",
+    inputSchema: { id: z.string() },
+  },
+  async ({ id }) => {
+    const payout = getPayout(id);
+    if (!payout) {
+      return { content: [{ type: "text", text: `Payout '${id}' not found.` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(payout, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "list_payouts",
+  {
+    title: "List Payouts",
+    description: "List payouts with optional status filter.",
+    inputSchema: {
+      status: z.enum(["pending", "in_transit", "paid", "failed"]).optional(),
+    },
+  },
+  async ({ status }) => {
+    const payouts = listPayouts(status);
+    return {
+      content: [
+        { type: "text", text: JSON.stringify({ payouts, count: payouts.length }, null, 2) },
+      ],
+    };
+  }
+);
+
+server.registerTool(
+  "update_payout",
+  {
+    title: "Update Payout",
+    description: "Update a payout status.",
+    inputSchema: {
+      id: z.string(),
+      status: z.enum(["pending", "in_transit", "paid", "failed"]).optional(),
+      destination: z.string().optional(),
+      arrived_at: z.string().optional(),
+    },
+  },
+  async ({ id, ...input }) => {
+    const payout = updatePayout(id, input);
+    if (!payout) {
+      return { content: [{ type: "text", text: `Payout '${id}' not found.` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(payout, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "delete_payout",
+  {
+    title: "Delete Payout",
+    description: "Delete a payout by ID.",
+    inputSchema: { id: z.string() },
+  },
+  async ({ id }) => {
+    const deleted = deletePayout(id);
+    return { content: [{ type: "text", text: JSON.stringify({ id, deleted }) }] };
+  }
+);
+
+// --- Start ---
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("microservice-payments MCP server running on stdio");
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/microservices/microservice-payroll/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@hasna/microservice-payroll",
+  "version": "0.0.1",
+  "description": "Payroll management microservice with SQLite — manage employees, pay periods, pay stubs, and payments",
+  "type": "module",
+  "bin": {
+    "microservice-payroll": "./src/cli/index.ts",
+    "microservice-payroll-mcp": "./src/mcp/index.ts"
+  },
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "dev": "bun run ./src/cli/index.ts",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "commander": "^12.1.0",
+    "zod": "^3.24.0"
+  },
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  }
+}