npm - @hasna/microservices - Versions diffs - 0.0.16 → 0.0.17 - Mend

@hasna/microservices 0.0.16 → 0.0.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (293) hide show

package/microservices/microservice-invoices/dashboard/index.html DELETED Viewed

@@ -1,12 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Invoices</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>

package/microservices/microservice-invoices/dashboard/package.json DELETED Viewed

@@ -1,29 +0,0 @@
-{
-  "name": "microservice-invoices-dashboard",
-  "private": true,
-  "version": "0.0.1",
-  "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build",
-    "preview": "vite preview"
-  },
-  "dependencies": {
-    "class-variance-authority": "^0.7.1",
-    "clsx": "^2.1.1",
-    "lucide-react": "^0.468.0",
-    "radix-ui": "^1.4.2",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "tailwind-merge": "^3.0.2"
-  },
-  "devDependencies": {
-    "@tailwindcss/vite": "^4.1.4",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "@vitejs/plugin-react": "^4.4.1",
-    "tailwindcss": "^4.1.4",
-    "typescript": "^5.7.0",
-    "vite": "^6.3.0"
-  }
-}

package/microservices/microservice-invoices/dashboard/tsconfig.json DELETED Viewed

@@ -1,14 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "jsx": "react-jsx",
-    "strict": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "paths": { "@/*": ["./src/*"] }
-  },
-  "include": ["src"]
-}

package/microservices/microservice-invoices/dashboard/vite.config.ts DELETED Viewed

@@ -1,15 +0,0 @@
-import { defineConfig } from "vite";
-import react from "@vitejs/plugin-react";
-import tailwindcss from "@tailwindcss/vite";
-export default defineConfig({
-  plugins: [react(), tailwindcss()],
-  server: {
-    proxy: {
-      "/api": "http://localhost:19500",
-    },
-  },
-  build: {
-    outDir: "dist",
-  },
-});

package/microservices/microservice-invoices/package.json DELETED Viewed

@@ -1,31 +0,0 @@
-{
-  "name": "@hasna/microservice-invoices",
-  "version": "0.0.1",
-  "description": "Invoice management microservice with SQLite — create, track, and manage invoices",
-  "type": "module",
-  "bin": {
-    "microservice-invoices": "./src/cli/index.ts",
-    "microservice-invoices-mcp": "./src/mcp/index.ts",
-    "microservice-invoices-serve": "./src/server/index.ts"
-  },
-  "exports": {
-    ".": "./src/index.ts"
-  },
-  "scripts": {
-    "dev": "bun run ./src/cli/index.ts",
-    "serve": "bun run ./src/server/index.ts",
-    "build:dashboard": "cd dashboard && bun run build",
-    "test": "bun test"
-  },
-  "dependencies": {
-    "@hasna/cloud": "^0.1.24",
-    "@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-invoices/src/cli/index.ts DELETED Viewed

@@ -1,308 +0,0 @@
-#!/usr/bin/env bun
-import { Command } from "commander";
-import {
-  createInvoice,
-  getInvoiceWithItems,
-  listInvoices,
-  updateInvoiceStatus,
-  deleteInvoice,
-  addLineItem,
-  removeLineItem,
-  recordPayment,
-  getInvoiceSummary,
-} from "../db/invoices.js";
-import {
-  createClient,
-  getClient,
-  listClients,
-  updateClient,
-  deleteClient,
-} from "../db/clients.js";
-const program = new Command();
-program
-  .name("microservice-invoices")
-  .description("Invoice management microservice")
-  .version("0.0.1");
-// --- Invoices ---
-program
-  .command("create")
-  .description("Create a new invoice")
-  .option("--client <id>", "Client ID")
-  .option("--due <date>", "Due date (YYYY-MM-DD)")
-  .option("--currency <code>", "Currency code", "USD")
-  .option("--tax-rate <rate>", "Tax rate percentage", "0")
-  .option("--discount <amount>", "Discount amount", "0")
-  .option("--notes <notes>", "Invoice notes")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const invoice = createInvoice({
-      client_id: opts.client,
-      due_date: opts.due,
-      currency: opts.currency,
-      tax_rate: parseFloat(opts.taxRate),
-      discount: parseFloat(opts.discount),
-      notes: opts.notes,
-    });
-    if (opts.json) {
-      console.log(JSON.stringify(invoice, null, 2));
-    } else {
-      console.log(`Created invoice: ${invoice.invoice_number} (${invoice.id})`);
-    }
-  });
-program
-  .command("get")
-  .description("Get an invoice with line items")
-  .argument("<id>", "Invoice ID or number")
-  .option("--json", "Output as JSON", false)
-  .action((id, opts) => {
-    const invoice = getInvoiceWithItems(id);
-    if (!invoice) {
-      console.error(`Invoice '${id}' not found.`);
-      process.exit(1);
-    }
-    if (opts.json) {
-      console.log(JSON.stringify(invoice, null, 2));
-    } else {
-      console.log(`Invoice: ${invoice.invoice_number}`);
-      console.log(`  Status:   ${invoice.status}`);
-      console.log(`  Date:     ${invoice.issue_date}`);
-      if (invoice.due_date) console.log(`  Due:      ${invoice.due_date}`);
-      console.log(`  Currency: ${invoice.currency}`);
-      if (invoice.line_items.length > 0) {
-        console.log(`  Items:`);
-        for (const item of invoice.line_items) {
-          console.log(`    - ${item.description}: ${item.quantity} x ${item.unit_price} = ${item.amount}`);
-        }
-      }
-      console.log(`  Subtotal: ${invoice.subtotal}`);
-      if (invoice.discount > 0) console.log(`  Discount: -${invoice.discount}`);
-      if (invoice.tax_rate > 0) console.log(`  Tax (${invoice.tax_rate}%): ${invoice.tax_amount}`);
-      console.log(`  Total:    ${invoice.total}`);
-      if (invoice.payments.length > 0) {
-        console.log(`  Payments:`);
-        for (const p of invoice.payments) {
-          console.log(`    - ${p.amount} (${p.method || "unknown"}) on ${p.paid_at}`);
-        }
-      }
-    }
-  });
-program
-  .command("list")
-  .description("List invoices")
-  .option("--status <status>", "Filter by status")
-  .option("--client <id>", "Filter by client")
-  .option("--from <date>", "From date")
-  .option("--to <date>", "To date")
-  .option("--limit <n>", "Limit results")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const invoices = listInvoices({
-      status: opts.status,
-      client_id: opts.client,
-      from_date: opts.from,
-      to_date: opts.to,
-      limit: opts.limit ? parseInt(opts.limit) : undefined,
-    });
-    if (opts.json) {
-      console.log(JSON.stringify(invoices, null, 2));
-    } else {
-      if (invoices.length === 0) {
-        console.log("No invoices found.");
-        return;
-      }
-      for (const inv of invoices) {
-        const status = inv.status.toUpperCase().padEnd(10);
-        console.log(`  ${inv.invoice_number}  ${status}  ${inv.currency} ${inv.total.toFixed(2)}  ${inv.issue_date}`);
-      }
-      console.log(`\n${invoices.length} invoice(s)`);
-    }
-  });
-program
-  .command("mark")
-  .description("Update invoice status")
-  .argument("<id>", "Invoice ID or number")
-  .argument("<status>", "New status: draft|sent|paid|overdue|cancelled|refunded")
-  .action((id, status) => {
-    const invoice = updateInvoiceStatus(id, status);
-    if (!invoice) {
-      console.error(`Invoice '${id}' not found.`);
-      process.exit(1);
-    }
-    console.log(`Invoice ${invoice.invoice_number} marked as ${status}.`);
-  });
-program
-  .command("delete")
-  .description("Delete an invoice")
-  .argument("<id>", "Invoice ID")
-  .action((id) => {
-    const deleted = deleteInvoice(id);
-    if (deleted) {
-      console.log(`Deleted invoice ${id}`);
-    } else {
-      console.error(`Invoice '${id}' not found.`);
-      process.exit(1);
-    }
-  });
-program
-  .command("add-item")
-  .description("Add a line item to an invoice")
-  .requiredOption("--invoice <id>", "Invoice ID")
-  .requiredOption("--description <text>", "Item description")
-  .requiredOption("--price <amount>", "Unit price")
-  .option("--quantity <n>", "Quantity", "1")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const item = addLineItem({
-      invoice_id: opts.invoice,
-      description: opts.description,
-      unit_price: parseFloat(opts.price),
-      quantity: parseFloat(opts.quantity),
-    });
-    if (opts.json) {
-      console.log(JSON.stringify(item, null, 2));
-    } else {
-      console.log(`Added: ${item.description} (${item.quantity} x ${item.unit_price} = ${item.amount})`);
-    }
-  });
-program
-  .command("remove-item")
-  .description("Remove a line item")
-  .argument("<id>", "Line item ID")
-  .action((id) => {
-    const removed = removeLineItem(id);
-    if (removed) {
-      console.log(`Removed line item ${id}`);
-    } else {
-      console.error(`Line item '${id}' not found.`);
-      process.exit(1);
-    }
-  });
-program
-  .command("pay")
-  .description("Record a payment")
-  .requiredOption("--invoice <id>", "Invoice ID")
-  .requiredOption("--amount <amount>", "Payment amount")
-  .option("--method <method>", "Payment method")
-  .option("--reference <ref>", "Payment reference")
-  .option("--notes <notes>", "Notes")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const payment = recordPayment({
-      invoice_id: opts.invoice,
-      amount: parseFloat(opts.amount),
-      method: opts.method,
-      reference: opts.reference,
-      notes: opts.notes,
-    });
-    if (opts.json) {
-      console.log(JSON.stringify(payment, null, 2));
-    } else {
-      console.log(`Payment recorded: ${payment.amount} (${payment.method || "unknown"})`);
-    }
-  });
-program
-  .command("summary")
-  .description("Show invoice summary")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const summary = getInvoiceSummary();
-    if (opts.json) {
-      console.log(JSON.stringify(summary, null, 2));
-    } else {
-      console.log("\n  Invoice Summary");
-      console.log(`  Total:       ${summary.total_invoices}`);
-      console.log(`  Draft:       ${summary.draft}`);
-      console.log(`  Sent:        ${summary.sent}`);
-      console.log(`  Paid:        ${summary.paid}`);
-      console.log(`  Overdue:     ${summary.overdue}`);
-      console.log(`  Outstanding: $${summary.total_outstanding.toFixed(2)}`);
-      console.log(`  Collected:   $${summary.total_paid.toFixed(2)}`);
-      console.log();
-    }
-  });
-// --- Clients ---
-const clientCmd = program.command("client").description("Client management");
-clientCmd
-  .command("add")
-  .description("Add a client")
-  .requiredOption("--name <name>", "Client name")
-  .option("--email <email>", "Email")
-  .option("--phone <phone>", "Phone")
-  .option("--address <address>", "Address")
-  .option("--tax-id <id>", "Tax ID")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const client = createClient({
-      name: opts.name,
-      email: opts.email,
-      phone: opts.phone,
-      address: opts.address,
-      tax_id: opts.taxId,
-    });
-    if (opts.json) {
-      console.log(JSON.stringify(client, null, 2));
-    } else {
-      console.log(`Created client: ${client.name} (${client.id})`);
-    }
-  });
-clientCmd
-  .command("list")
-  .description("List clients")
-  .option("--search <query>", "Search")
-  .option("--json", "Output as JSON", false)
-  .action((opts) => {
-    const clients = listClients(opts.search);
-    if (opts.json) {
-      console.log(JSON.stringify(clients, null, 2));
-    } else {
-      if (clients.length === 0) {
-        console.log("No clients found.");
-        return;
-      }
-      for (const c of clients) {
-        const email = c.email ? ` <${c.email}>` : "";
-        console.log(`  ${c.name}${email}`);
-      }
-    }
-  });
-clientCmd
-  .command("delete")
-  .description("Delete a client")
-  .argument("<id>", "Client ID")
-  .action((id) => {
-    const deleted = deleteClient(id);
-    if (deleted) {
-      console.log(`Deleted client ${id}`);
-    } else {
-      console.error(`Client '${id}' not found.`);
-      process.exit(1);
-    }
-  });
-program.parse(process.argv);

package/microservices/microservice-invoices/src/db/business.ts DELETED Viewed

@@ -1,241 +0,0 @@
-/**
- * Business profiles and tax rules
- */
-import { getDatabase } from "./database.js";
-// --- Business Profiles ---
-export interface BusinessProfile {
-  id: string;
-  name: string;
-  address_line1: string | null;
-  address_line2: string | null;
-  city: string | null;
-  state: string | null;
-  postal_code: string | null;
-  country: string;
-  tax_id: string | null;
-  vat_number: string | null;
-  registration_number: string | null;
-  email: string | null;
-  phone: string | null;
-  website: string | null;
-  bank_name: string | null;
-  bank_iban: string | null;
-  bank_swift: string | null;
-  bank_account: string | null;
-  logo_url: string | null;
-  is_default: boolean;
-  metadata: Record<string, unknown>;
-  created_at: string;
-  updated_at: string;
-}
-interface BusinessRow extends Omit<BusinessProfile, "is_default" | "metadata"> {
-  is_default: number;
-  metadata: string;
-}
-function rowToBusiness(row: BusinessRow): BusinessProfile {
-  return {
-    ...row,
-    is_default: row.is_default === 1,
-    metadata: JSON.parse(row.metadata || "{}"),
-  };
-}
-export interface CreateBusinessInput {
-  name: string;
-  address_line1?: string;
-  address_line2?: string;
-  city?: string;
-  state?: string;
-  postal_code?: string;
-  country?: string;
-  tax_id?: string;
-  vat_number?: string;
-  registration_number?: string;
-  email?: string;
-  phone?: string;
-  website?: string;
-  bank_name?: string;
-  bank_iban?: string;
-  bank_swift?: string;
-  bank_account?: string;
-  logo_url?: string;
-  is_default?: boolean;
-}
-export function createBusinessProfile(input: CreateBusinessInput): BusinessProfile {
-  const db = getDatabase();
-  const id = crypto.randomUUID();
-  // If setting as default, clear other defaults
-  if (input.is_default) {
-    db.prepare("UPDATE business_profiles SET is_default = 0").run();
-  }
-  db.prepare(
-    `INSERT INTO business_profiles (id, name, address_line1, address_line2, city, state, postal_code, country, tax_id, vat_number, registration_number, email, phone, website, bank_name, bank_iban, bank_swift, bank_account, logo_url, is_default)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
-  ).run(
-    id, input.name,
-    input.address_line1 || null, input.address_line2 || null,
-    input.city || null, input.state || null, input.postal_code || null,
-    input.country || "US",
-    input.tax_id || null, input.vat_number || null, input.registration_number || null,
-    input.email || null, input.phone || null, input.website || null,
-    input.bank_name || null, input.bank_iban || null, input.bank_swift || null, input.bank_account || null,
-    input.logo_url || null,
-    input.is_default ? 1 : 0
-  );
-  return getBusinessProfile(id)!;
-}
-export function getBusinessProfile(id: string): BusinessProfile | null {
-  const db = getDatabase();
-  const row = db.prepare("SELECT * FROM business_profiles WHERE id = ?").get(id) as BusinessRow | null;
-  return row ? rowToBusiness(row) : null;
-}
-export function getDefaultBusinessProfile(): BusinessProfile | null {
-  const db = getDatabase();
-  const row = db.prepare("SELECT * FROM business_profiles WHERE is_default = 1").get() as BusinessRow | null;
-  return row ? rowToBusiness(row) : null;
-}
-export function listBusinessProfiles(): BusinessProfile[] {
-  const db = getDatabase();
-  return (db.prepare("SELECT * FROM business_profiles ORDER BY is_default DESC, name").all() as BusinessRow[]).map(rowToBusiness);
-}
-export function updateBusinessProfile(id: string, input: Partial<CreateBusinessInput>): BusinessProfile | null {
-  const db = getDatabase();
-  if (!getBusinessProfile(id)) return null;
-  const sets: string[] = [];
-  const params: unknown[] = [];
-  for (const [key, value] of Object.entries(input)) {
-    if (value === undefined) continue;
-    if (key === "is_default") {
-      if (value) db.prepare("UPDATE business_profiles SET is_default = 0").run();
-      sets.push("is_default = ?");
-      params.push(value ? 1 : 0);
-    } else {
-      sets.push(`${key} = ?`);
-      params.push(value);
-    }
-  }
-  if (sets.length === 0) return getBusinessProfile(id);
-  sets.push("updated_at = datetime('now')");
-  params.push(id);
-  db.prepare(`UPDATE business_profiles SET ${sets.join(", ")} WHERE id = ?`).run(...params);
-  return getBusinessProfile(id);
-}
-export function deleteBusinessProfile(id: string): boolean {
-  return getDatabase().prepare("DELETE FROM business_profiles WHERE id = ?").run(id).changes > 0;
-}
-// --- Tax Rules ---
-export interface TaxRule {
-  id: string;
-  country: string;
-  region: string | null;
-  tax_name: string;
-  rate: number;
-  type: "vat" | "sales_tax" | "gst" | "other";
-  is_default: boolean;
-  reverse_charge: boolean;
-  description: string | null;
-  created_at: string;
-}
-interface TaxRuleRow extends Omit<TaxRule, "is_default" | "reverse_charge"> {
-  is_default: number;
-  reverse_charge: number;
-}
-function rowToTaxRule(row: TaxRuleRow): TaxRule {
-  return { ...row, is_default: row.is_default === 1, reverse_charge: row.reverse_charge === 1 } as TaxRule;
-}
-export function getTaxRulesForCountry(country: string): TaxRule[] {
-  const db = getDatabase();
-  return (db.prepare("SELECT * FROM tax_rules WHERE country = ? ORDER BY is_default DESC, rate DESC").all(country) as TaxRuleRow[]).map(rowToTaxRule);
-}
-export function getDefaultTaxRule(country: string): TaxRule | null {
-  const db = getDatabase();
-  const row = db.prepare("SELECT * FROM tax_rules WHERE country = ? AND is_default = 1").get(country) as TaxRuleRow | null;
-  return row ? rowToTaxRule(row) : null;
-}
-export function getTaxRule(id: string): TaxRule | null {
-  const db = getDatabase();
-  const row = db.prepare("SELECT * FROM tax_rules WHERE id = ?").get(id) as TaxRuleRow | null;
-  return row ? rowToTaxRule(row) : null;
-}
-export function listAllTaxRules(): TaxRule[] {
-  const db = getDatabase();
-  return (db.prepare("SELECT * FROM tax_rules ORDER BY country, is_default DESC, rate DESC").all() as TaxRuleRow[]).map(rowToTaxRule);
-}
-export interface CreateTaxRuleInput {
-  country: string;
-  region?: string;
-  tax_name: string;
-  rate: number;
-  type?: "vat" | "sales_tax" | "gst" | "other";
-  is_default?: boolean;
-  reverse_charge?: boolean;
-  description?: string;
-}
-export function createTaxRule(input: CreateTaxRuleInput): TaxRule {
-  const db = getDatabase();
-  const id = crypto.randomUUID();
-  db.prepare(
-    `INSERT INTO tax_rules (id, country, region, tax_name, rate, type, is_default, reverse_charge, description)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`
-  ).run(id, input.country, input.region || null, input.tax_name, input.rate, input.type || "vat", input.is_default ? 1 : 0, input.reverse_charge ? 1 : 0, input.description || null);
-  return getTaxRule(id)!;
-}
-export function deleteTaxRule(id: string): boolean {
-  return getDatabase().prepare("DELETE FROM tax_rules WHERE id = ?").run(id).changes > 0;
-}
-/**
- * Determine tax for an invoice based on issuer and client countries.
- * Applies EU reverse charge when both parties are in EU and client has VAT number.
- */
-export function determineTax(issuerCountry: string, clientCountry: string, clientVatNumber?: string | null): {
-  tax_rate: number;
-  tax_name: string;
-  reverse_charge: boolean;
-} {
-  const EU_COUNTRIES = ["AT", "BE", "BG", "HR", "CY", "CZ", "DK", "EE", "FI", "FR", "DE", "GR", "HU", "IE", "IT", "LV", "LT", "LU", "MT", "NL", "PL", "PT", "RO", "SK", "SI", "ES", "SE"];
-  const issuerInEU = EU_COUNTRIES.includes(issuerCountry);
-  const clientInEU = EU_COUNTRIES.includes(clientCountry);
-  // EU B2B reverse charge: different EU countries, client has VAT number
-  if (issuerInEU && clientInEU && issuerCountry !== clientCountry && clientVatNumber) {
-    return { tax_rate: 0, tax_name: "Reverse Charge", reverse_charge: true };
-  }
-  // Same country or non-EU: use issuer's default tax
-  const defaultRule = getDefaultTaxRule(issuerCountry);
-  if (defaultRule) {
-    return { tax_rate: defaultRule.rate, tax_name: defaultRule.tax_name, reverse_charge: false };
-  }
-  return { tax_rate: 0, tax_name: "Tax", reverse_charge: false };
-}