@hasna/microservices 0.0.2 → 0.0.4

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

@@ -0,0 +1,398 @@
+#!/usr/bin/env bun
+
+import { Command } from "commander";
+import {
+  createOrder,
+  getOrder,
+  listOrders,
+  updateOrder,
+  deleteOrder,
+  searchOrders,
+  listByStatus,
+} from "../db/shipping.js";
+import {
+  createShipment,
+  getShipment,
+  getShipmentByTracking,
+  listShipments,
+  updateShipment,
+} from "../db/shipping.js";
+import {
+  createReturn,
+  listReturns,
+  updateReturn,
+} from "../db/shipping.js";
+import {
+  getShippingStats,
+  getCostsByCarrier,
+} from "../db/shipping.js";
+
+const program = new Command();
+
+program
+  .name("microservice-shipping")
+  .description("Shipping and order management microservice")
+  .version("0.0.1");
+
+// --- Orders ---
+
+const orderCmd = program.command("order").description("Order management");
+
+orderCmd
+  .command("create")
+  .description("Create a new order")
+  .requiredOption("--customer-name <name>", "Customer name")
+  .option("--customer-email <email>", "Customer email")
+  .option("--address <json>", "Address as JSON {street,city,state,zip,country}")
+  .option("--items <json>", "Items as JSON array [{name,qty,weight,value}]")
+  .option("--currency <code>", "Currency code", "USD")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const address = opts.address ? JSON.parse(opts.address) : { street: "", city: "", state: "", zip: "", country: "" };
+    const items = opts.items ? JSON.parse(opts.items) : [];
+
+    const order = createOrder({
+      customer_name: opts.customerName,
+      customer_email: opts.customerEmail,
+      address,
+      items,
+      currency: opts.currency,
+    });
+
+    if (opts.json) {
+      console.log(JSON.stringify(order, null, 2));
+    } else {
+      console.log(`Created order: ${order.id} for ${order.customer_name} ($${order.total_value} ${order.currency})`);
+    }
+  });
+
+orderCmd
+  .command("list")
+  .description("List orders")
+  .option("--status <status>", "Filter by status")
+  .option("--search <query>", "Search by customer name or email")
+  .option("--limit <n>", "Limit results")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const orders = listOrders({
+      status: opts.status,
+      search: opts.search,
+      limit: opts.limit ? parseInt(opts.limit) : undefined,
+    });
+
+    if (opts.json) {
+      console.log(JSON.stringify(orders, null, 2));
+    } else {
+      if (orders.length === 0) {
+        console.log("No orders found.");
+        return;
+      }
+      for (const o of orders) {
+        console.log(`  [${o.status}] ${o.id.slice(0, 8)}... ${o.customer_name} — $${o.total_value} ${o.currency}`);
+      }
+      console.log(`\n${orders.length} order(s)`);
+    }
+  });
+
+orderCmd
+  .command("get")
+  .description("Get an order by ID")
+  .argument("<id>", "Order ID")
+  .option("--json", "Output as JSON", false)
+  .action((id, opts) => {
+    const order = getOrder(id);
+    if (!order) {
+      console.error(`Order '${id}' not found.`);
+      process.exit(1);
+    }
+
+    if (opts.json) {
+      console.log(JSON.stringify(order, null, 2));
+    } else {
+      console.log(`Order: ${order.id}`);
+      console.log(`  Customer: ${order.customer_name}`);
+      if (order.customer_email) console.log(`  Email: ${order.customer_email}`);
+      console.log(`  Status: ${order.status}`);
+      console.log(`  Total: $${order.total_value} ${order.currency}`);
+      console.log(`  Items: ${order.items.length}`);
+      console.log(`  Address: ${order.address.street}, ${order.address.city}, ${order.address.state} ${order.address.zip}`);
+    }
+  });
+
+orderCmd
+  .command("update")
+  .description("Update an order")
+  .argument("<id>", "Order ID")
+  .option("--customer-name <name>", "Customer name")
+  .option("--customer-email <email>", "Customer email")
+  .option("--status <status>", "Order status")
+  .option("--address <json>", "Address as JSON")
+  .option("--items <json>", "Items as JSON")
+  .option("--currency <code>", "Currency code")
+  .option("--json", "Output as JSON", false)
+  .action((id, opts) => {
+    const input: Record<string, unknown> = {};
+    if (opts.customerName !== undefined) input.customer_name = opts.customerName;
+    if (opts.customerEmail !== undefined) input.customer_email = opts.customerEmail;
+    if (opts.status !== undefined) input.status = opts.status;
+    if (opts.address !== undefined) input.address = JSON.parse(opts.address);
+    if (opts.items !== undefined) input.items = JSON.parse(opts.items);
+    if (opts.currency !== undefined) input.currency = opts.currency;
+
+    const order = updateOrder(id, input);
+    if (!order) {
+      console.error(`Order '${id}' not found.`);
+      process.exit(1);
+    }
+
+    if (opts.json) {
+      console.log(JSON.stringify(order, null, 2));
+    } else {
+      console.log(`Updated order: ${order.id} [${order.status}]`);
+    }
+  });
+
+// --- Ship (create shipment) ---
+
+program
+  .command("ship")
+  .description("Create a shipment for an order")
+  .requiredOption("--order <id>", "Order ID")
+  .requiredOption("--carrier <carrier>", "Carrier (ups/fedex/usps/dhl)")
+  .option("--tracking <number>", "Tracking number")
+  .option("--service <service>", "Service level (ground/express/overnight)", "ground")
+  .option("--cost <amount>", "Shipping cost")
+  .option("--weight <kg>", "Package weight")
+  .option("--estimated-delivery <date>", "Estimated delivery date")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const shipment = createShipment({
+      order_id: opts.order,
+      carrier: opts.carrier,
+      tracking_number: opts.tracking,
+      service: opts.service,
+      cost: opts.cost ? parseFloat(opts.cost) : undefined,
+      weight: opts.weight ? parseFloat(opts.weight) : undefined,
+      estimated_delivery: opts.estimatedDelivery,
+    });
+
+    if (opts.json) {
+      console.log(JSON.stringify(shipment, null, 2));
+    } else {
+      console.log(`Created shipment: ${shipment.id} via ${shipment.carrier} (${shipment.service})`);
+      if (shipment.tracking_number) console.log(`  Tracking: ${shipment.tracking_number}`);
+    }
+  });
+
+// --- Track ---
+
+program
+  .command("track")
+  .description("Track a shipment by tracking number or shipment ID")
+  .argument("<identifier>", "Tracking number or shipment ID")
+  .option("--json", "Output as JSON", false)
+  .action((identifier, opts) => {
+    let shipment = getShipmentByTracking(identifier);
+    if (!shipment) {
+      shipment = getShipment(identifier);
+    }
+    if (!shipment) {
+      console.error(`Shipment '${identifier}' not found.`);
+      process.exit(1);
+    }
+
+    if (opts.json) {
+      console.log(JSON.stringify(shipment, null, 2));
+    } else {
+      console.log(`Shipment: ${shipment.id}`);
+      console.log(`  Carrier: ${shipment.carrier}`);
+      console.log(`  Service: ${shipment.service}`);
+      console.log(`  Status: ${shipment.status}`);
+      if (shipment.tracking_number) console.log(`  Tracking: ${shipment.tracking_number}`);
+      if (shipment.shipped_at) console.log(`  Shipped: ${shipment.shipped_at}`);
+      if (shipment.estimated_delivery) console.log(`  ETA: ${shipment.estimated_delivery}`);
+      if (shipment.delivered_at) console.log(`  Delivered: ${shipment.delivered_at}`);
+    }
+  });
+
+// --- Shipments ---
+
+const shipmentsCmd = program.command("shipments").description("Shipment management");
+
+shipmentsCmd
+  .command("list")
+  .description("List shipments")
+  .option("--order <id>", "Filter by order ID")
+  .option("--carrier <carrier>", "Filter by carrier")
+  .option("--status <status>", "Filter by status")
+  .option("--limit <n>", "Limit results")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const shipments = listShipments({
+      order_id: opts.order,
+      carrier: opts.carrier,
+      status: opts.status,
+      limit: opts.limit ? parseInt(opts.limit) : undefined,
+    });
+
+    if (opts.json) {
+      console.log(JSON.stringify(shipments, null, 2));
+    } else {
+      if (shipments.length === 0) {
+        console.log("No shipments found.");
+        return;
+      }
+      for (const s of shipments) {
+        const tracking = s.tracking_number ? ` (${s.tracking_number})` : "";
+        console.log(`  [${s.status}] ${s.id.slice(0, 8)}... ${s.carrier}/${s.service}${tracking}`);
+      }
+      console.log(`\n${shipments.length} shipment(s)`);
+    }
+  });
+
+// --- Returns ---
+
+const returnCmd = program.command("return").description("Return management");
+
+returnCmd
+  .command("create")
+  .description("Create a return request")
+  .requiredOption("--order <id>", "Order ID")
+  .option("--reason <reason>", "Return reason")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const ret = createReturn({
+      order_id: opts.order,
+      reason: opts.reason,
+    });
+
+    if (opts.json) {
+      console.log(JSON.stringify(ret, null, 2));
+    } else {
+      console.log(`Created return: ${ret.id} for order ${ret.order_id} [${ret.status}]`);
+    }
+  });
+
+returnCmd
+  .command("list")
+  .description("List returns")
+  .option("--order <id>", "Filter by order ID")
+  .option("--status <status>", "Filter by status")
+  .option("--limit <n>", "Limit results")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const returns = listReturns({
+      order_id: opts.order,
+      status: opts.status,
+      limit: opts.limit ? parseInt(opts.limit) : undefined,
+    });
+
+    if (opts.json) {
+      console.log(JSON.stringify(returns, null, 2));
+    } else {
+      if (returns.length === 0) {
+        console.log("No returns found.");
+        return;
+      }
+      for (const r of returns) {
+        const reason = r.reason ? ` — ${r.reason}` : "";
+        console.log(`  [${r.status}] ${r.id.slice(0, 8)}... order ${r.order_id.slice(0, 8)}...${reason}`);
+      }
+      console.log(`\n${returns.length} return(s)`);
+    }
+  });
+
+returnCmd
+  .command("process")
+  .description("Process a return (update status)")
+  .argument("<id>", "Return ID")
+  .requiredOption("--status <status>", "New status (approved/received/refunded)")
+  .option("--json", "Output as JSON", false)
+  .action((id, opts) => {
+    const ret = updateReturn(id, { status: opts.status });
+    if (!ret) {
+      console.error(`Return '${id}' not found.`);
+      process.exit(1);
+    }
+
+    if (opts.json) {
+      console.log(JSON.stringify(ret, null, 2));
+    } else {
+      console.log(`Updated return: ${ret.id} [${ret.status}]`);
+    }
+  });
+
+// --- Carriers ---
+
+program
+  .command("carriers")
+  .description("List supported carriers")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const carriers = [
+      { code: "ups", name: "UPS", services: ["ground", "express", "overnight"] },
+      { code: "fedex", name: "FedEx", services: ["ground", "express", "overnight"] },
+      { code: "usps", name: "USPS", services: ["ground", "express"] },
+      { code: "dhl", name: "DHL", services: ["ground", "express", "overnight"] },
+    ];
+
+    if (opts.json) {
+      console.log(JSON.stringify(carriers, null, 2));
+    } else {
+      for (const c of carriers) {
+        console.log(`  ${c.code.toUpperCase()} (${c.name}) — ${c.services.join(", ")}`);
+      }
+    }
+  });
+
+// --- Stats ---
+
+program
+  .command("stats")
+  .description("Show shipping statistics")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const stats = getShippingStats();
+
+    if (opts.json) {
+      console.log(JSON.stringify(stats, null, 2));
+    } else {
+      console.log("Shipping Statistics:");
+      console.log(`  Orders: ${stats.total_orders}`);
+      for (const [status, count] of Object.entries(stats.orders_by_status)) {
+        console.log(`    ${status}: ${count}`);
+      }
+      console.log(`  Shipments: ${stats.total_shipments}`);
+      for (const [status, count] of Object.entries(stats.shipments_by_status)) {
+        console.log(`    ${status}: ${count}`);
+      }
+      console.log(`  Returns: ${stats.total_returns}`);
+      console.log(`  Revenue: $${stats.total_revenue.toFixed(2)}`);
+      console.log(`  Shipping Cost: $${stats.total_shipping_cost.toFixed(2)}`);
+    }
+  });
+
+// --- Costs ---
+
+program
+  .command("costs")
+  .description("Show shipping costs by carrier")
+  .option("--json", "Output as JSON", false)
+  .action((opts) => {
+    const costs = getCostsByCarrier();
+
+    if (opts.json) {
+      console.log(JSON.stringify(costs, null, 2));
+    } else {
+      if (costs.length === 0) {
+        console.log("No shipping cost data.");
+        return;
+      }
+      console.log("Costs by Carrier:");
+      for (const c of costs) {
+        console.log(`  ${c.carrier.toUpperCase()}: $${c.total_cost.toFixed(2)} total, ${c.shipment_count} shipments, $${c.avg_cost.toFixed(2)} avg`);
+      }
+    }
+  });
+
+program.parse(process.argv);

package/microservices/microservice-shipping/src/db/database.ts

@@ -0,0 +1,93 @@
+/**
+ * Database connection for microservice-shipping
+ */
+
+import { Database } from "bun:sqlite";
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { MIGRATIONS } from "./migrations.js";
+
+let _db: Database | null = null;
+
+function getDbPath(): string {
+  // Environment variable override
+  if (process.env["MICROSERVICES_DIR"]) {
+    return join(process.env["MICROSERVICES_DIR"], "microservice-shipping", "data.db");
+  }
+
+  // Check for .microservices in current or parent directories
+  let dir = resolve(process.cwd());
+  while (true) {
+    const candidate = join(dir, ".microservices", "microservice-shipping", "data.db");
+    const msDir = join(dir, ".microservices");
+    if (existsSync(msDir)) return candidate;
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+
+  // Global fallback
+  const home = process.env["HOME"] || process.env["USERPROFILE"] || "~";
+  return join(home, ".microservices", "microservice-shipping", "data.db");
+}
+
+function ensureDir(filePath: string): void {
+  const dir = dirname(resolve(filePath));
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+
+export function getDatabase(): Database {
+  if (_db) return _db;
+
+  const dbPath = getDbPath();
+  ensureDir(dbPath);
+
+  _db = new Database(dbPath);
+  _db.exec("PRAGMA journal_mode = WAL");
+  _db.exec("PRAGMA foreign_keys = ON");
+
+  // Create migrations table
+  _db.exec(`
+    CREATE TABLE IF NOT EXISTS _migrations (
+      id INTEGER PRIMARY KEY,
+      name TEXT NOT NULL,
+      applied_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+
+  // Apply pending migrations
+  const applied = _db
+    .query("SELECT id FROM _migrations ORDER BY id")
+    .all() as { id: number }[];
+  const appliedIds = new Set(applied.map((r) => r.id));
+
+  for (const migration of MIGRATIONS) {
+    if (appliedIds.has(migration.id)) continue;
+
+    _db.exec("BEGIN");
+    try {
+      _db.exec(migration.sql);
+      _db.prepare("INSERT INTO _migrations (id, name) VALUES (?, ?)").run(
+        migration.id,
+        migration.name
+      );
+      _db.exec("COMMIT");
+    } catch (error) {
+      _db.exec("ROLLBACK");
+      throw new Error(
+        `Migration ${migration.id} (${migration.name}) failed: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+
+  return _db;
+}
+
+export function closeDatabase(): void {
+  if (_db) {
+    _db.close();
+    _db = null;
+  }
+}

package/microservices/microservice-shipping/src/db/migrations.ts

@@ -0,0 +1,61 @@
+export interface MigrationEntry {
+  id: number;
+  name: string;
+  sql: string;
+}
+
+export const MIGRATIONS: MigrationEntry[] = [
+  {
+    id: 1,
+    name: "initial_schema",
+    sql: `
+      CREATE TABLE IF NOT EXISTS orders (
+        id TEXT PRIMARY KEY,
+        customer_name TEXT NOT NULL,
+        customer_email TEXT,
+        address TEXT NOT NULL DEFAULT '{}',
+        items TEXT NOT NULL DEFAULT '[]',
+        status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending','processing','shipped','delivered','returned')),
+        total_value REAL NOT NULL DEFAULT 0,
+        currency TEXT NOT NULL DEFAULT 'USD',
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+
+      CREATE TABLE IF NOT EXISTS shipments (
+        id TEXT PRIMARY KEY,
+        order_id TEXT NOT NULL REFERENCES orders(id) ON DELETE CASCADE,
+        carrier TEXT NOT NULL CHECK(carrier IN ('ups','fedex','usps','dhl')),
+        tracking_number TEXT,
+        service TEXT NOT NULL DEFAULT 'ground' CHECK(service IN ('ground','express','overnight')),
+        status TEXT NOT NULL DEFAULT 'label_created' CHECK(status IN ('label_created','in_transit','out_for_delivery','delivered','exception')),
+        shipped_at TEXT,
+        estimated_delivery TEXT,
+        delivered_at TEXT,
+        cost REAL,
+        weight REAL,
+        dimensions TEXT,
+        created_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+
+      CREATE TABLE IF NOT EXISTS returns (
+        id TEXT PRIMARY KEY,
+        order_id TEXT NOT NULL REFERENCES orders(id) ON DELETE CASCADE,
+        reason TEXT,
+        status TEXT NOT NULL DEFAULT 'requested' CHECK(status IN ('requested','approved','received','refunded')),
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_orders_status ON orders(status);
+      CREATE INDEX IF NOT EXISTS idx_orders_customer_email ON orders(customer_email);
+      CREATE INDEX IF NOT EXISTS idx_orders_customer_name ON orders(customer_name);
+      CREATE INDEX IF NOT EXISTS idx_shipments_order ON shipments(order_id);
+      CREATE INDEX IF NOT EXISTS idx_shipments_carrier ON shipments(carrier);
+      CREATE INDEX IF NOT EXISTS idx_shipments_tracking ON shipments(tracking_number);
+      CREATE INDEX IF NOT EXISTS idx_shipments_status ON shipments(status);
+      CREATE INDEX IF NOT EXISTS idx_returns_order ON returns(order_id);
+      CREATE INDEX IF NOT EXISTS idx_returns_status ON returns(status);
+    `,
+  },
+];