@hasna/microservices 0.0.3 → 0.0.4

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

@@ -0,0 +1,385 @@
+#!/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 {
+  createOrder,
+  getOrder,
+  listOrders,
+  updateOrder,
+  deleteOrder,
+  searchOrders,
+  listByStatus,
+} from "../db/shipping.js";
+import {
+  createShipment,
+  getShipment,
+  getShipmentByTracking,
+  listShipments,
+  updateShipment,
+} from "../db/shipping.js";
+import {
+  createReturn,
+  getReturn,
+  listReturns,
+  updateReturn,
+} from "../db/shipping.js";
+import {
+  getShippingStats,
+  getCostsByCarrier,
+} from "../db/shipping.js";
+
+const server = new McpServer({
+  name: "microservice-shipping",
+  version: "0.0.1",
+});
+
+// ─── Orders ──────────────────────────────────────────────────────────────────
+
+const AddressSchema = z.object({
+  street: z.string(),
+  city: z.string(),
+  state: z.string(),
+  zip: z.string(),
+  country: z.string(),
+});
+
+const OrderItemSchema = z.object({
+  name: z.string(),
+  qty: z.number(),
+  weight: z.number(),
+  value: z.number(),
+});
+
+server.registerTool(
+  "create_order",
+  {
+    title: "Create Order",
+    description: "Create a new order.",
+    inputSchema: {
+      customer_name: z.string(),
+      customer_email: z.string().optional(),
+      address: AddressSchema,
+      items: z.array(OrderItemSchema),
+      currency: z.string().optional(),
+    },
+  },
+  async (params) => {
+    const order = createOrder(params);
+    return { content: [{ type: "text", text: JSON.stringify(order, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "get_order",
+  {
+    title: "Get Order",
+    description: "Get an order by ID.",
+    inputSchema: { id: z.string() },
+  },
+  async ({ id }) => {
+    const order = getOrder(id);
+    if (!order) {
+      return { content: [{ type: "text", text: `Order '${id}' not found.` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(order, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "list_orders",
+  {
+    title: "List Orders",
+    description: "List orders with optional filters.",
+    inputSchema: {
+      status: z.string().optional(),
+      search: z.string().optional(),
+      limit: z.number().optional(),
+    },
+  },
+  async (params) => {
+    const orders = listOrders(params);
+    return {
+      content: [
+        { type: "text", text: JSON.stringify({ orders, count: orders.length }, null, 2) },
+      ],
+    };
+  }
+);
+
+server.registerTool(
+  "update_order",
+  {
+    title: "Update Order",
+    description: "Update an existing order.",
+    inputSchema: {
+      id: z.string(),
+      customer_name: z.string().optional(),
+      customer_email: z.string().optional(),
+      status: z.enum(["pending", "processing", "shipped", "delivered", "returned"]).optional(),
+      address: AddressSchema.optional(),
+      items: z.array(OrderItemSchema).optional(),
+      total_value: z.number().optional(),
+      currency: z.string().optional(),
+    },
+  },
+  async ({ id, ...input }) => {
+    const order = updateOrder(id, input);
+    if (!order) {
+      return { content: [{ type: "text", text: `Order '${id}' not found.` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(order, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "delete_order",
+  {
+    title: "Delete Order",
+    description: "Delete an order by ID.",
+    inputSchema: { id: z.string() },
+  },
+  async ({ id }) => {
+    const deleted = deleteOrder(id);
+    return { content: [{ type: "text", text: JSON.stringify({ id, deleted }) }] };
+  }
+);
+
+server.registerTool(
+  "search_orders",
+  {
+    title: "Search Orders",
+    description: "Search orders by customer name or email.",
+    inputSchema: { query: z.string() },
+  },
+  async ({ query }) => {
+    const results = searchOrders(query);
+    return {
+      content: [
+        { type: "text", text: JSON.stringify({ results, count: results.length }, null, 2) },
+      ],
+    };
+  }
+);
+
+// ─── Shipments ───────────────────────────────────────────────────────────────
+
+server.registerTool(
+  "create_shipment",
+  {
+    title: "Create Shipment",
+    description: "Create a shipment for an order.",
+    inputSchema: {
+      order_id: z.string(),
+      carrier: z.enum(["ups", "fedex", "usps", "dhl"]),
+      tracking_number: z.string().optional(),
+      service: z.enum(["ground", "express", "overnight"]).optional(),
+      cost: z.number().optional(),
+      weight: z.number().optional(),
+      estimated_delivery: z.string().optional(),
+      dimensions: z.record(z.unknown()).optional(),
+    },
+  },
+  async (params) => {
+    const shipment = createShipment(params);
+    return { content: [{ type: "text", text: JSON.stringify(shipment, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "get_shipment",
+  {
+    title: "Get Shipment",
+    description: "Get a shipment by ID.",
+    inputSchema: { id: z.string() },
+  },
+  async ({ id }) => {
+    const shipment = getShipment(id);
+    if (!shipment) {
+      return { content: [{ type: "text", text: `Shipment '${id}' not found.` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(shipment, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "track_shipment",
+  {
+    title: "Track Shipment",
+    description: "Track a shipment by tracking number.",
+    inputSchema: { tracking_number: z.string() },
+  },
+  async ({ tracking_number }) => {
+    const shipment = getShipmentByTracking(tracking_number);
+    if (!shipment) {
+      return { content: [{ type: "text", text: `Shipment with tracking '${tracking_number}' not found.` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(shipment, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "list_shipments",
+  {
+    title: "List Shipments",
+    description: "List shipments with optional filters.",
+    inputSchema: {
+      order_id: z.string().optional(),
+      carrier: z.string().optional(),
+      status: z.string().optional(),
+      limit: z.number().optional(),
+    },
+  },
+  async (params) => {
+    const shipments = listShipments(params);
+    return {
+      content: [
+        { type: "text", text: JSON.stringify({ shipments, count: shipments.length }, null, 2) },
+      ],
+    };
+  }
+);
+
+server.registerTool(
+  "update_shipment",
+  {
+    title: "Update Shipment",
+    description: "Update a shipment.",
+    inputSchema: {
+      id: z.string(),
+      carrier: z.enum(["ups", "fedex", "usps", "dhl"]).optional(),
+      tracking_number: z.string().optional(),
+      service: z.enum(["ground", "express", "overnight"]).optional(),
+      status: z.enum(["label_created", "in_transit", "out_for_delivery", "delivered", "exception"]).optional(),
+      shipped_at: z.string().optional(),
+      estimated_delivery: z.string().optional(),
+      delivered_at: z.string().optional(),
+      cost: z.number().optional(),
+      weight: z.number().optional(),
+      dimensions: z.record(z.unknown()).optional(),
+    },
+  },
+  async ({ id, ...input }) => {
+    const shipment = updateShipment(id, input);
+    if (!shipment) {
+      return { content: [{ type: "text", text: `Shipment '${id}' not found.` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(shipment, null, 2) }] };
+  }
+);
+
+// ─── Returns ─────────────────────────────────────────────────────────────────
+
+server.registerTool(
+  "create_return",
+  {
+    title: "Create Return",
+    description: "Create a return request for an order.",
+    inputSchema: {
+      order_id: z.string(),
+      reason: z.string().optional(),
+    },
+  },
+  async (params) => {
+    const ret = createReturn(params);
+    return { content: [{ type: "text", text: JSON.stringify(ret, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "get_return",
+  {
+    title: "Get Return",
+    description: "Get a return by ID.",
+    inputSchema: { id: z.string() },
+  },
+  async ({ id }) => {
+    const ret = getReturn(id);
+    if (!ret) {
+      return { content: [{ type: "text", text: `Return '${id}' not found.` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(ret, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "list_returns",
+  {
+    title: "List Returns",
+    description: "List returns with optional filters.",
+    inputSchema: {
+      order_id: z.string().optional(),
+      status: z.string().optional(),
+      limit: z.number().optional(),
+    },
+  },
+  async (params) => {
+    const returns = listReturns(params);
+    return {
+      content: [
+        { type: "text", text: JSON.stringify({ returns, count: returns.length }, null, 2) },
+      ],
+    };
+  }
+);
+
+server.registerTool(
+  "update_return",
+  {
+    title: "Update Return",
+    description: "Update a return status.",
+    inputSchema: {
+      id: z.string(),
+      reason: z.string().optional(),
+      status: z.enum(["requested", "approved", "received", "refunded"]).optional(),
+    },
+  },
+  async ({ id, ...input }) => {
+    const ret = updateReturn(id, input);
+    if (!ret) {
+      return { content: [{ type: "text", text: `Return '${id}' not found.` }], isError: true };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(ret, null, 2) }] };
+  }
+);
+
+// ─── Analytics ───────────────────────────────────────────────────────────────
+
+server.registerTool(
+  "shipping_stats",
+  {
+    title: "Shipping Statistics",
+    description: "Get overall shipping statistics.",
+    inputSchema: {},
+  },
+  async () => {
+    const stats = getShippingStats();
+    return { content: [{ type: "text", text: JSON.stringify(stats, null, 2) }] };
+  }
+);
+
+server.registerTool(
+  "carrier_costs",
+  {
+    title: "Carrier Costs",
+    description: "Get shipping costs breakdown by carrier.",
+    inputSchema: {},
+  },
+  async () => {
+    const costs = getCostsByCarrier();
+    return { content: [{ type: "text", text: JSON.stringify(costs, null, 2) }] };
+  }
+);
+
+// --- Start ---
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("microservice-shipping MCP server running on stdio");
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/microservices/microservice-social/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@hasna/microservice-social",
+  "version": "0.0.1",
+  "description": "Social media management microservice with SQLite — manage accounts, posts, templates, and engagement analytics",
+  "type": "module",
+  "bin": {
+    "microservice-social": "./src/cli/index.ts",
+    "microservice-social-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"
+  }
+}