@hasna/microservices 0.0.15 → 0.0.17

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

@@ -1,52 +0,0 @@
-export interface MigrationEntry {
-  id: number;
-  name: string;
-  sql: string;
-}
-
-export const MIGRATIONS: MigrationEntry[] = [
-  {
-    id: 1,
-    name: "initial_schema",
-    sql: `
-      CREATE TABLE IF NOT EXISTS accounts (
-        id TEXT PRIMARY KEY,
-        name TEXT NOT NULL,
-        type TEXT NOT NULL CHECK(type IN ('asset', 'liability', 'equity', 'revenue', 'expense')),
-        code TEXT UNIQUE,
-        description TEXT,
-        parent_id TEXT REFERENCES accounts(id) ON DELETE SET NULL,
-        balance 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 transactions (
-        id TEXT PRIMARY KEY,
-        date TEXT NOT NULL DEFAULT (date('now')),
-        description TEXT NOT NULL,
-        reference TEXT,
-        metadata TEXT NOT NULL DEFAULT '{}',
-        created_at TEXT NOT NULL DEFAULT (datetime('now'))
-      );
-
-      CREATE TABLE IF NOT EXISTS transaction_entries (
-        id TEXT PRIMARY KEY,
-        transaction_id TEXT NOT NULL REFERENCES transactions(id) ON DELETE CASCADE,
-        account_id TEXT NOT NULL REFERENCES accounts(id) ON DELETE RESTRICT,
-        debit REAL NOT NULL DEFAULT 0,
-        credit REAL NOT NULL DEFAULT 0,
-        description TEXT
-      );
-
-      CREATE INDEX IF NOT EXISTS idx_accounts_type ON accounts(type);
-      CREATE INDEX IF NOT EXISTS idx_accounts_code ON accounts(code);
-      CREATE INDEX IF NOT EXISTS idx_accounts_parent ON accounts(parent_id);
-      CREATE INDEX IF NOT EXISTS idx_transactions_date ON transactions(date);
-      CREATE INDEX IF NOT EXISTS idx_transactions_reference ON transactions(reference);
-      CREATE INDEX IF NOT EXISTS idx_transaction_entries_transaction ON transaction_entries(transaction_id);
-      CREATE INDEX IF NOT EXISTS idx_transaction_entries_account ON transaction_entries(account_id);
-    `,
-  },
-];

package/microservices/microservice-bookkeeping/src/index.ts

@@ -1,32 +0,0 @@
-/**
- * microservice-bookkeeping — Double-entry bookkeeping microservice
- */
-
-export {
-  createAccount,
-  getAccount,
-  listAccounts,
-  updateAccount,
-  deleteAccount,
-  createTransaction,
-  getTransaction,
-  listTransactions,
-  deleteTransaction,
-  getTrialBalance,
-  getAccountBalance,
-  getIncomeStatement,
-  type Account,
-  type AccountType,
-  type CreateAccountInput,
-  type UpdateAccountInput,
-  type ListAccountsOptions,
-  type Transaction,
-  type TransactionEntry,
-  type TransactionWithEntries,
-  type TransactionEntryInput,
-  type CreateTransactionInput,
-  type ListTransactionsOptions,
-  type TrialBalanceEntry,
-} from "./db/bookkeeping.js";
-
-export { getDatabase, closeDatabase } from "./db/database.js";

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

@@ -1,284 +0,0 @@
-#!/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 {
-  createAccount,
-  getAccount,
-  listAccounts,
-  updateAccount,
-  deleteAccount,
-  createTransaction,
-  getTransaction,
-  listTransactions,
-  deleteTransaction,
-  getTrialBalance,
-  getAccountBalance,
-  getIncomeStatement,
-} from "../db/bookkeeping.js";
-
-const server = new McpServer({
-  name: "microservice-bookkeeping",
-  version: "0.0.1",
-});
-
-// --- Accounts ---
-
-server.registerTool(
-  "create_account",
-  {
-    title: "Create Account",
-    description: "Create a new chart-of-accounts entry.",
-    inputSchema: {
-      name: z.string(),
-      type: z.enum(["asset", "liability", "equity", "revenue", "expense"]),
-      code: z.string().optional(),
-      description: z.string().optional(),
-      parent_id: z.string().optional(),
-      currency: z.string().optional(),
-    },
-  },
-  async (params) => {
-    const account = createAccount(params);
-    return { content: [{ type: "text", text: JSON.stringify(account, null, 2) }] };
-  }
-);
-
-server.registerTool(
-  "get_account",
-  {
-    title: "Get Account",
-    description: "Get an account by ID or code.",
-    inputSchema: { id: z.string() },
-  },
-  async ({ id }) => {
-    const account = getAccount(id);
-    if (!account) {
-      return { content: [{ type: "text", text: `Account '${id}' not found.` }], isError: true };
-    }
-    return { content: [{ type: "text", text: JSON.stringify(account, null, 2) }] };
-  }
-);
-
-server.registerTool(
-  "list_accounts",
-  {
-    title: "List Accounts",
-    description: "List accounts with optional filters.",
-    inputSchema: {
-      type: z.enum(["asset", "liability", "equity", "revenue", "expense"]).optional(),
-      search: z.string().optional(),
-      parent_id: z.string().optional(),
-      currency: z.string().optional(),
-      limit: z.number().optional(),
-    },
-  },
-  async (params) => {
-    const accounts = listAccounts(params);
-    return {
-      content: [
-        { type: "text", text: JSON.stringify({ accounts, count: accounts.length }, null, 2) },
-      ],
-    };
-  }
-);
-
-server.registerTool(
-  "update_account",
-  {
-    title: "Update Account",
-    description: "Update an existing account.",
-    inputSchema: {
-      id: z.string(),
-      name: z.string().optional(),
-      type: z.enum(["asset", "liability", "equity", "revenue", "expense"]).optional(),
-      code: z.string().optional(),
-      description: z.string().optional(),
-      parent_id: z.string().optional(),
-      currency: z.string().optional(),
-    },
-  },
-  async ({ id, ...input }) => {
-    const account = updateAccount(id, input);
-    if (!account) {
-      return { content: [{ type: "text", text: `Account '${id}' not found.` }], isError: true };
-    }
-    return { content: [{ type: "text", text: JSON.stringify(account, null, 2) }] };
-  }
-);
-
-server.registerTool(
-  "delete_account",
-  {
-    title: "Delete Account",
-    description: "Delete an account. Fails if account has transaction entries.",
-    inputSchema: { id: z.string() },
-  },
-  async ({ id }) => {
-    try {
-      const deleted = deleteAccount(id);
-      return { content: [{ type: "text", text: JSON.stringify({ id, deleted }) }] };
-    } catch (error) {
-      return {
-        content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }],
-        isError: true,
-      };
-    }
-  }
-);
-
-// --- Transactions ---
-
-const entrySchema = z.object({
-  account_id: z.string(),
-  debit: z.number().optional(),
-  credit: z.number().optional(),
-  description: z.string().optional(),
-});
-
-server.registerTool(
-  "create_transaction",
-  {
-    title: "Create Transaction",
-    description:
-      "Record a double-entry transaction. Entries must balance (total debits = total credits). Requires at least two entries.",
-    inputSchema: {
-      description: z.string(),
-      date: z.string().optional(),
-      reference: z.string().optional(),
-      metadata: z.record(z.unknown()).optional(),
-      entries: z.array(entrySchema),
-    },
-  },
-  async (params) => {
-    try {
-      const txn = createTransaction(params);
-      return { content: [{ type: "text", text: JSON.stringify(txn, null, 2) }] };
-    } catch (error) {
-      return {
-        content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }],
-        isError: true,
-      };
-    }
-  }
-);
-
-server.registerTool(
-  "get_transaction",
-  {
-    title: "Get Transaction",
-    description: "Get a transaction with its entries by ID or reference.",
-    inputSchema: { id: z.string() },
-  },
-  async ({ id }) => {
-    const txn = getTransaction(id);
-    if (!txn) {
-      return { content: [{ type: "text", text: `Transaction '${id}' not found.` }], isError: true };
-    }
-    return { content: [{ type: "text", text: JSON.stringify(txn, null, 2) }] };
-  }
-);
-
-server.registerTool(
-  "list_transactions",
-  {
-    title: "List Transactions",
-    description: "List transactions with optional filters.",
-    inputSchema: {
-      from_date: z.string().optional(),
-      to_date: z.string().optional(),
-      account_id: z.string().optional(),
-      reference: z.string().optional(),
-      search: z.string().optional(),
-      limit: z.number().optional(),
-    },
-  },
-  async (params) => {
-    const transactions = listTransactions(params);
-    return {
-      content: [
-        { type: "text", text: JSON.stringify({ transactions, count: transactions.length }, null, 2) },
-      ],
-    };
-  }
-);
-
-server.registerTool(
-  "delete_transaction",
-  {
-    title: "Delete Transaction",
-    description: "Delete a transaction and reverse all account balance changes.",
-    inputSchema: { id: z.string() },
-  },
-  async ({ id }) => {
-    try {
-      const deleted = deleteTransaction(id);
-      return { content: [{ type: "text", text: JSON.stringify({ id, deleted }) }] };
-    } catch (error) {
-      return {
-        content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }],
-        isError: true,
-      };
-    }
-  }
-);
-
-// --- Reports ---
-
-server.registerTool(
-  "trial_balance",
-  {
-    title: "Trial Balance",
-    description: "Get the trial balance report. Shows all accounts with their total debits and credits.",
-    inputSchema: {},
-  },
-  async () => {
-    const tb = getTrialBalance();
-    return { content: [{ type: "text", text: JSON.stringify(tb, null, 2) }] };
-  }
-);
-
-server.registerTool(
-  "account_balance",
-  {
-    title: "Account Balance",
-    description: "Get detailed balance information for a specific account.",
-    inputSchema: { id: z.string() },
-  },
-  async ({ id }) => {
-    const result = getAccountBalance(id);
-    if (!result) {
-      return { content: [{ type: "text", text: `Account '${id}' not found.` }], isError: true };
-    }
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-  }
-);
-
-server.registerTool(
-  "income_statement",
-  {
-    title: "Income Statement",
-    description: "Get the income statement (revenue minus expenses). Optionally filter by date range.",
-    inputSchema: {
-      from_date: z.string().optional(),
-      to_date: z.string().optional(),
-    },
-  },
-  async (params) => {
-    const result = getIncomeStatement(params);
-    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
-  }
-);
-
-// --- Start ---
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  console.error("microservice-bookkeeping MCP server running on stdio");
-}
-
-main().catch((error) => {
-  console.error("Fatal error:", error);
-  process.exit(1);
-});

package/microservices/microservice-calendar/package.json

@@ -1,27 +0,0 @@
-{
-  "name": "@hasna/microservice-calendar",
-  "version": "0.0.1",
-  "description": "Calendar management microservice with SQLite — manage events, reminders, and schedules",
-  "type": "module",
-  "bin": {
-    "microservice-calendar": "./src/cli/index.ts",
-    "microservice-calendar-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"
-  }
-}

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

@@ -1,287 +0,0 @@
-#!/usr/bin/env bun
-
-import { Command } from "commander";
-import {
-  createEvent,
-  getEvent,
-  listEvents,
-  updateEvent,
-  deleteEvent,
-  getUpcoming,
-  getToday,
-  createReminder,
-  listPendingReminders,
-  markReminderSent,
-} from "../db/calendar.js";
-
-const program = new Command();
-
-program
-  .name("microservice-calendar")
-  .description("Calendar management microservice")
-  .version("0.0.1");
-
-// --- Events ---
-
-program
-  .command("add")
-  .description("Add a new event")
-  .requiredOption("--title <title>", "Event title")
-  .requiredOption("--start <datetime>", "Start date/time (ISO 8601)")
-  .option("--end <datetime>", "End date/time (ISO 8601)")
-  .option("--all-day", "Mark as all-day event")
-  .option("--location <location>", "Location")
-  .option("--calendar <name>", "Calendar name", "default")
-  .option("--status <status>", "Status: confirmed|tentative|cancelled", "confirmed")
-  .option("--recurrence <rule>", "Recurrence rule (e.g. RRULE:FREQ=WEEKLY)")
-  .option("--reminder <minutes>", "Reminder minutes before event")
-  .option("--description <text>", "Event description")
-  .option("--tags <tags>", "Comma-separated tags")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const event = createEvent({
-      title: opts.title,
-      start_at: opts.start,
-      end_at: opts.end,
-      all_day: opts.allDay || false,
-      location: opts.location,
-      calendar: opts.calendar,
-      status: opts.status,
-      recurrence_rule: opts.recurrence,
-      reminder_minutes: opts.reminder ? parseInt(opts.reminder) : undefined,
-      description: opts.description,
-      tags: opts.tags ? opts.tags.split(",").map((t: string) => t.trim()) : undefined,
-    });
-
-    if (opts.json) {
-      console.log(JSON.stringify(event, null, 2));
-    } else {
-      console.log(`Created event: ${event.title} (${event.id})`);
-      console.log(`  Start: ${event.start_at}`);
-      if (event.end_at) console.log(`  End:   ${event.end_at}`);
-    }
-  });
-
-program
-  .command("get")
-  .description("Get an event by ID")
-  .argument("<id>", "Event ID")
-  .option("--json", "Output as JSON", false)
-  .action((id, opts) => {
-    const event = getEvent(id);
-    if (!event) {
-      console.error(`Event '${id}' not found.`);
-      process.exit(1);
-    }
-
-    if (opts.json) {
-      console.log(JSON.stringify(event, null, 2));
-    } else {
-      console.log(`${event.title}`);
-      console.log(`  Start:    ${event.start_at}`);
-      if (event.end_at) console.log(`  End:      ${event.end_at}`);
-      console.log(`  Calendar: ${event.calendar}`);
-      console.log(`  Status:   ${event.status}`);
-      if (event.all_day) console.log(`  All day:  yes`);
-      if (event.location) console.log(`  Location: ${event.location}`);
-      if (event.description) console.log(`  Description: ${event.description}`);
-      if (event.tags.length) console.log(`  Tags: ${event.tags.join(", ")}`);
-      if (event.recurrence_rule) console.log(`  Recurrence: ${event.recurrence_rule}`);
-      if (event.reminder_minutes != null) console.log(`  Reminder: ${event.reminder_minutes} min before`);
-    }
-  });
-
-program
-  .command("list")
-  .description("List events")
-  .option("--from <date>", "From date/time")
-  .option("--to <date>", "To date/time")
-  .option("--calendar <name>", "Filter by calendar")
-  .option("--status <status>", "Filter by status")
-  .option("--limit <n>", "Limit results")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const events = listEvents({
-      from: opts.from,
-      to: opts.to,
-      calendar: opts.calendar,
-      status: opts.status,
-      limit: opts.limit ? parseInt(opts.limit) : undefined,
-    });
-
-    if (opts.json) {
-      console.log(JSON.stringify(events, null, 2));
-    } else {
-      if (events.length === 0) {
-        console.log("No events found.");
-        return;
-      }
-      for (const e of events) {
-        const loc = e.location ? ` @ ${e.location}` : "";
-        const tags = e.tags.length ? ` [${e.tags.join(", ")}]` : "";
-        console.log(`  ${e.start_at}  ${e.title}${loc}${tags}  (${e.status})`);
-      }
-      console.log(`\n${events.length} event(s)`);
-    }
-  });
-
-program
-  .command("update")
-  .description("Update an event")
-  .argument("<id>", "Event ID")
-  .option("--title <title>", "Title")
-  .option("--start <datetime>", "Start date/time")
-  .option("--end <datetime>", "End date/time")
-  .option("--all-day", "Mark as all-day")
-  .option("--location <location>", "Location")
-  .option("--calendar <name>", "Calendar name")
-  .option("--status <status>", "Status")
-  .option("--recurrence <rule>", "Recurrence rule")
-  .option("--reminder <minutes>", "Reminder minutes")
-  .option("--description <text>", "Description")
-  .option("--tags <tags>", "Comma-separated tags")
-  .option("--json", "Output as JSON", false)
-  .action((id, opts) => {
-    const input: Record<string, unknown> = {};
-    if (opts.title !== undefined) input.title = opts.title;
-    if (opts.start !== undefined) input.start_at = opts.start;
-    if (opts.end !== undefined) input.end_at = opts.end;
-    if (opts.allDay !== undefined) input.all_day = opts.allDay;
-    if (opts.location !== undefined) input.location = opts.location;
-    if (opts.calendar !== undefined) input.calendar = opts.calendar;
-    if (opts.status !== undefined) input.status = opts.status;
-    if (opts.recurrence !== undefined) input.recurrence_rule = opts.recurrence;
-    if (opts.reminder !== undefined) input.reminder_minutes = parseInt(opts.reminder);
-    if (opts.description !== undefined) input.description = opts.description;
-    if (opts.tags !== undefined) input.tags = opts.tags.split(",").map((t: string) => t.trim());
-
-    const event = updateEvent(id, input);
-    if (!event) {
-      console.error(`Event '${id}' not found.`);
-      process.exit(1);
-    }
-
-    if (opts.json) {
-      console.log(JSON.stringify(event, null, 2));
-    } else {
-      console.log(`Updated: ${event.title}`);
-    }
-  });
-
-program
-  .command("delete")
-  .description("Delete an event")
-  .argument("<id>", "Event ID")
-  .action((id) => {
-    const deleted = deleteEvent(id);
-    if (deleted) {
-      console.log(`Deleted event ${id}`);
-    } else {
-      console.error(`Event '${id}' not found.`);
-      process.exit(1);
-    }
-  });
-
-program
-  .command("upcoming")
-  .description("Show upcoming events")
-  .option("--limit <n>", "Number of events", "10")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const events = getUpcoming(parseInt(opts.limit));
-
-    if (opts.json) {
-      console.log(JSON.stringify(events, null, 2));
-    } else {
-      if (events.length === 0) {
-        console.log("No upcoming events.");
-        return;
-      }
-      for (const e of events) {
-        const loc = e.location ? ` @ ${e.location}` : "";
-        console.log(`  ${e.start_at}  ${e.title}${loc}`);
-      }
-    }
-  });
-
-program
-  .command("today")
-  .description("Show today's events")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const events = getToday();
-
-    if (opts.json) {
-      console.log(JSON.stringify(events, null, 2));
-    } else {
-      if (events.length === 0) {
-        console.log("No events today.");
-        return;
-      }
-      for (const e of events) {
-        const loc = e.location ? ` @ ${e.location}` : "";
-        console.log(`  ${e.start_at}  ${e.title}${loc}`);
-      }
-    }
-  });
-
-// --- Reminders ---
-
-const reminderCmd = program
-  .command("reminder")
-  .description("Reminder management");
-
-reminderCmd
-  .command("add")
-  .description("Add a reminder for an event")
-  .requiredOption("--event <id>", "Event ID")
-  .requiredOption("--at <datetime>", "Remind at date/time (ISO 8601)")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const reminder = createReminder({
-      event_id: opts.event,
-      remind_at: opts.at,
-    });
-
-    if (opts.json) {
-      console.log(JSON.stringify(reminder, null, 2));
-    } else {
-      console.log(`Created reminder: ${reminder.id} for event ${reminder.event_id} at ${reminder.remind_at}`);
-    }
-  });
-
-reminderCmd
-  .command("pending")
-  .description("List pending reminders")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const reminders = listPendingReminders();
-
-    if (opts.json) {
-      console.log(JSON.stringify(reminders, null, 2));
-    } else {
-      if (reminders.length === 0) {
-        console.log("No pending reminders.");
-        return;
-      }
-      for (const r of reminders) {
-        console.log(`  ${r.remind_at}  event:${r.event_id}  (${r.id})`);
-      }
-    }
-  });
-
-reminderCmd
-  .command("sent")
-  .description("Mark a reminder as sent")
-  .argument("<id>", "Reminder ID")
-  .action((id) => {
-    const marked = markReminderSent(id);
-    if (marked) {
-      console.log(`Marked reminder ${id} as sent.`);
-    } else {
-      console.error(`Reminder '${id}' not found.`);
-      process.exit(1);
-    }
-  });
-
-program.parse(process.argv);