@invoicer/cli 1.1.0

package/logo.svg

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" width="200" height="200">
+  <!-- Background -->
+  <rect width="200" height="200" rx="40" fill="#1e293b"/>
+  
+  <!-- "IN" Text -->
+  <text 
+    x="100" 
+    y="140" 
+    font-family="Arial, Helvetica, sans-serif" 
+    font-size="96" 
+    font-weight="900" 
+    fill="#ffffff" 
+    text-anchor="middle" 
+    letter-spacing="-8">IN</text>
+</svg>
+

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@invoicer/cli",
+  "version": "1.1.0",
+  "description": "Professional invoice generator with timesheet integration and CLI support",
+  "type": "module",
+  "preferGlobal": true,
+  "bin": {
+    "invoicer": "./scripts/invoice.mjs"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "invoice": "npm run build && node scripts/invoice.mjs",
+    "invoice:month": "npm run build && node scripts/invoice.mjs generate --month=$(date +%Y-%m)",
+    "test": "npm run build && node --test --experimental-strip-types test/**/*.test.ts"
+  },
+  "keywords": [
+    "invoice",
+    "billing",
+    "timesheet",
+    "cli",
+    "automation",
+    "pdf"
+  ],
+  "author": "Milad Fahmy <milad@inbrief.sh>",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^14.0.3",
+    "dotenv": "^16.4.5",
+    "inquirer": "^9.2.20",
+    "nodemailer": "^8.0.1",
+    "puppeteer": "^22.15.0"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^22.10.2",
+    "@types/nodemailer": "^7.0.9",
+    "typescript": "^5.7.2"
+  }
+}

package/scripts/invoice.mjs

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const currentFilePath = fileURLToPath(import.meta.url);
+const projectRoot = path.resolve(path.dirname(currentFilePath), "..");
+const distCliPath = path.join(projectRoot, "dist", "cli.js");
+
+if (!fs.existsSync(distCliPath)) {
+  console.error("❌ Missing compiled CLI: dist/cli.js");
+  console.error("   Run: npm run build");
+  process.exit(1);
+}
+
+const cliModule = await import(pathToFileURL(distCliPath).href);
+
+if (typeof cliModule.runCli !== "function") {
+  console.error("❌ Failed to load CLI runtime from dist/cli.js");
+  process.exit(1);
+}
+
+await cliModule.runCli(process.argv);

package/src/cli.ts

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { Command } from "commander";
+import { pathToFileURL } from "node:url";
+import { createProjectPaths, type ProjectPaths } from "./core/paths.js";
+import { registerGenerateCommand } from "./commands/generate.js";
+import { registerClientsCommand } from "./commands/clients.js";
+import { registerTimesheetCommand } from "./commands/timesheet.js";
+
+export function createProgram(paths: ProjectPaths = createProjectPaths()): Command {
+  const program = new Command();
+
+  program
+    .name("invoicer")
+    .description("Professional invoice generator with timesheet integration")
+    .version("1.0.0");
+
+  registerGenerateCommand(program, paths);
+  registerClientsCommand(program, paths);
+  registerTimesheetCommand(program, paths);
+
+  return program;
+}
+
+export async function runCli(argv = process.argv, paths: ProjectPaths = createProjectPaths()): Promise<void> {
+  const program = createProgram(paths);
+  await program.parseAsync(argv);
+}
+
+function isMainModule(): boolean {
+  const entry = process.argv[1];
+  if (!entry) {
+    return false;
+  }
+  return import.meta.url === pathToFileURL(entry).href;
+}
+
+if (isMainModule()) {
+  runCli().catch((error: unknown) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`❌ ${message}`);
+    process.exit(1);
+  });
+}

package/src/commands/clients.ts

@@ -0,0 +1,221 @@
+import inquirer from "inquirer";
+import type { Command } from "commander";
+import { loadJsonFile, writeJsonFile } from "../core/json-store.js";
+import { type ProjectPaths } from "../core/paths.js";
+import { validateConfig } from "../core/validators.js";
+import { type ClientsOptions, type Config } from "../domain/types.js";
+
+function loadConfig(paths: ProjectPaths): Config {
+  return loadJsonFile(paths.configPath, { client: [], from: {} }, validateConfig);
+}
+
+export function registerClientsCommand(program: Command, paths: ProjectPaths): void {
+  program
+    .command("clients")
+    .description("Manage clients")
+    .option("--list", "List all configured clients", false)
+    .option("--add", "Add a new client interactively", false)
+    .option("--edit <name>", "Edit a client by name")
+    .option("--delete <name>", "Delete a client by name")
+    .action(async (options: ClientsOptions) => {
+      const cfg = loadConfig(paths);
+
+      if (options.list) {
+        if (cfg.client.length === 0) {
+          console.log("No clients configured.");
+          process.exit(0);
+        }
+
+        console.log("\n📋 Configured Clients:\n");
+        cfg.client.forEach((client, index) => {
+          console.log(`${index + 1}. ${client.name}`);
+          console.log(`   Currency: ${client.currency || "USD"}`);
+          console.log(`   Rate: ${client.defaultRate}/hr`);
+          console.log(`   Email: ${client.email || "—"}`);
+          if (client.address) console.log(`   Address: ${client.address}`);
+          if (client.payPeriodType) console.log(`   Terms: ${client.payPeriodType}`);
+          console.log();
+        });
+
+        process.exit(0);
+      }
+
+      if (options.add) {
+        const answers = await inquirer.prompt<{
+          name: string;
+          email: string;
+          address: string;
+          currency: string;
+          defaultRate: number;
+          payPeriodType: string;
+        }>([
+          {
+            type: "input",
+            name: "name",
+            message: "Client name:",
+            validate: (value: string) => value.trim().length > 0 || "Name is required",
+          },
+          {
+            type: "input",
+            name: "email",
+            message: "Email address:",
+            default: "",
+            validate: (value: string) =>
+              !value || /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value) || "Enter valid email",
+          },
+          {
+            type: "input",
+            name: "address",
+            message: "Address (optional):",
+            default: "",
+          },
+          {
+            type: "list",
+            name: "currency",
+            message: "Currency:",
+            choices: ["USD", "EUR", "GBP", "JPY"],
+            default: "USD",
+          },
+          {
+            type: "number",
+            name: "defaultRate",
+            message: "Default rate per hour:",
+            default: 50,
+            validate: (value: number) => value > 0 || "Rate must be positive",
+          },
+          {
+            type: "input",
+            name: "payPeriodType",
+            message: "Payment terms (e.g., Net 30, Due on Receipt):",
+            default: "Due on Receipt",
+          },
+        ]);
+
+        const newClient = {
+          name: answers.name.trim(),
+          email: answers.email.trim(),
+          address: answers.address.trim(),
+          currency: answers.currency,
+          defaultRate: Number(answers.defaultRate),
+          payPeriodType: answers.payPeriodType.trim(),
+        };
+
+        if (cfg.client.some((client) => client.name === newClient.name)) {
+          console.error(`❌ Client "${newClient.name}" already exists`);
+          process.exit(1);
+        }
+
+        cfg.client.push(newClient);
+        writeJsonFile(paths.configPath, cfg);
+        console.log(`✅ Client "${newClient.name}" added successfully`);
+        process.exit(0);
+      }
+
+      if (options.edit) {
+        const clientName = options.edit.trim();
+        const clientIndex = cfg.client.findIndex((client) => client.name === clientName);
+
+        if (clientIndex === -1) {
+          console.error(`❌ Client "${clientName}" not found`);
+          process.exit(1);
+        }
+
+        const current = cfg.client[clientIndex];
+
+        const answers = await inquirer.prompt<{
+          name: string;
+          email: string;
+          address: string;
+          currency: string;
+          defaultRate: number;
+          payPeriodType: string;
+        }>([
+          {
+            type: "input",
+            name: "name",
+            message: "Client name:",
+            default: current.name,
+            validate: (value: string) => value.trim().length > 0 || "Name is required",
+          },
+          {
+            type: "input",
+            name: "email",
+            message: "Email:",
+            default: current.email || "",
+            validate: (value: string) =>
+              !value || /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value) || "Enter valid email",
+          },
+          {
+            type: "input",
+            name: "address",
+            message: "Address:",
+            default: current.address || "",
+          },
+          {
+            type: "list",
+            name: "currency",
+            message: "Currency:",
+            choices: ["USD", "EUR", "GBP", "JPY"],
+            default: current.currency || "USD",
+          },
+          {
+            type: "number",
+            name: "defaultRate",
+            message: "Default rate per hour:",
+            default: current.defaultRate || 50,
+            validate: (value: number) => value > 0 || "Rate must be positive",
+          },
+          {
+            type: "input",
+            name: "payPeriodType",
+            message: "Payment terms:",
+            default: current.payPeriodType || "Due on Receipt",
+          },
+        ]);
+
+        cfg.client[clientIndex] = {
+          name: answers.name.trim(),
+          email: answers.email.trim(),
+          address: answers.address.trim(),
+          currency: answers.currency,
+          defaultRate: Number(answers.defaultRate),
+          payPeriodType: answers.payPeriodType.trim(),
+        };
+
+        writeJsonFile(paths.configPath, cfg);
+        console.log(`✅ Client "${answers.name}" updated successfully`);
+        process.exit(0);
+      }
+
+      if (options.delete) {
+        const clientName = options.delete.trim();
+        const clientIndex = cfg.client.findIndex((client) => client.name === clientName);
+
+        if (clientIndex === -1) {
+          console.error(`❌ Client "${clientName}" not found`);
+          process.exit(1);
+        }
+
+        const answer = await inquirer.prompt<{ confirm: boolean }>([
+          {
+            type: "confirm",
+            name: "confirm",
+            message: `Delete client "${clientName}"? This cannot be undone.`,
+            default: false,
+          },
+        ]);
+
+        if (!answer.confirm) {
+          console.log("Cancelled.");
+          process.exit(0);
+        }
+
+        cfg.client.splice(clientIndex, 1);
+        writeJsonFile(paths.configPath, cfg);
+        console.log(`✅ Client "${clientName}" deleted`);
+        process.exit(0);
+      }
+
+      console.log("Usage: invoicer clients [--list | --add | --edit <name> | --delete <name>]");
+    });
+}