@invoicer/cli 1.1.1 → 1.1.2

package/src/core/json-store.ts

@@ -1,33 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-
-export function readJsonFile(filePath: string): unknown | undefined {
-  if (!fs.existsSync(filePath)) {
-    return undefined;
-  }
-
-  const raw = fs.readFileSync(filePath, "utf8");
-  try {
-    return JSON.parse(raw);
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`Invalid JSON in ${filePath}: ${message}`);
-  }
-}
-
-export function loadJsonFile<T>(
-  filePath: string,
-  fallback: T,
-  validate: (value: unknown) => T,
-): T {
-  const parsed = readJsonFile(filePath);
-  if (parsed === undefined) {
-    return fallback;
-  }
-  return validate(parsed);
-}
-
-export function writeJsonFile(filePath: string, value: unknown): void {
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-  fs.writeFileSync(filePath, JSON.stringify(value, null, 2));
-}

package/src/core/paths.ts

@@ -1,42 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-export interface ProjectPaths {
-  projectRoot: string;
-  configPath: string;
-  lastPath: string;
-  timesheetPath: string;
-  archivePath: string;
-  outDir: string;
-  indexHtmlPath: string;
-}
-
-export function findProjectRoot(startDir = process.cwd()): string | null {
-  let currentDir = startDir;
-  const root = path.parse(currentDir).root;
-
-  while (currentDir !== root) {
-    const configPath = path.join(currentDir, "config.json");
-    if (fs.existsSync(configPath)) {
-      return currentDir;
-    }
-    currentDir = path.dirname(currentDir);
-  }
-
-  return null;
-}
-
-export function createProjectPaths(startDir = process.cwd()): ProjectPaths {
-  const moduleRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
-  const projectRoot = findProjectRoot(startDir) ?? (fs.existsSync(path.join(moduleRoot, "config.json")) ? moduleRoot : process.cwd());
-  return {
-    projectRoot,
-    configPath: path.join(projectRoot, "config.json"),
-    lastPath: path.join(projectRoot, "data", "last.json"),
-    timesheetPath: path.join(projectRoot, "data", "timesheet.json"),
-    archivePath: path.join(projectRoot, "data", "archive.json"),
-    outDir: path.join(projectRoot, "out"),
-    indexHtmlPath: path.join(projectRoot, "index.html"),
-  };
-}

package/src/core/validators.ts

@@ -1,168 +0,0 @@
-import {
-  type ArchiveData,
-  type ArchivedEntry,
-  type ClientConfig,
-  type ClientHistory,
-  type Config,
-  type LastState,
-  type TimesheetData,
-  type TimesheetEntry,
-} from "../domain/types.js";
-
-function ensureObject(value: unknown, label: string): Record<string, unknown> {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    throw new Error(`${label} must be an object`);
-  }
-  return value as Record<string, unknown>;
-}
-
-function ensureString(value: unknown, label: string, fallback = ""): string {
-  if (value === undefined || value === null) {
-    return fallback;
-  }
-  if (typeof value !== "string") {
-    throw new Error(`${label} must be a string`);
-  }
-  return value;
-}
-
-function ensureNumber(value: unknown, label: string): number {
-  if (typeof value !== "number" || Number.isNaN(value)) {
-    throw new Error(`${label} must be a number`);
-  }
-  return value;
-}
-
-function ensureOptionalNumber(value: unknown, label: string, fallback: number): number {
-  if (value === undefined || value === null || value === "") {
-    return fallback;
-  }
-  if (typeof value === "string") {
-    const parsed = Number(value);
-    if (!Number.isFinite(parsed)) {
-      throw new Error(`${label} must be numeric`);
-    }
-    return parsed;
-  }
-  return ensureNumber(value, label);
-}
-
-export function validateClientConfig(value: unknown, indexLabel = "client"): ClientConfig {
-  const client = ensureObject(value, indexLabel);
-
-  return {
-    name: ensureString(client.name, `${indexLabel}.name`).trim(),
-    email: ensureString(client.email, `${indexLabel}.email`, "").trim(),
-    address: ensureString(client.address, `${indexLabel}.address`, "").trim(),
-    currency: ensureString(client.currency, `${indexLabel}.currency`, "USD") || "USD",
-    defaultRate: ensureOptionalNumber(client.defaultRate, `${indexLabel}.defaultRate`, 0),
-    payPeriodType: ensureString(client.payPeriodType, `${indexLabel}.payPeriodType`, "").trim(),
-  };
-}
-
-export function validateConfig(value: unknown): Config {
-  const obj = ensureObject(value, "config");
-  const clientsRaw = obj.client;
-
-  if (!Array.isArray(clientsRaw)) {
-    throw new Error("config.client must be an array");
-  }
-
-  const fromRaw = obj.from === undefined ? {} : ensureObject(obj.from, "config.from");
-
-  return {
-    client: clientsRaw.map((client, index) => validateClientConfig(client, `config.client[${index}]`)),
-    defaultDescription: ensureString(obj.defaultDescription, "config.defaultDescription", ""),
-    from: {
-      name: ensureString(fromRaw.name, "config.from.name", ""),
-      email: ensureString(fromRaw.email, "config.from.email", ""),
-      address: ensureString(fromRaw.address, "config.from.address", ""),
-    },
-    invoicePrefix: ensureString(obj.invoicePrefix, "config.invoicePrefix", "INV"),
-    note: ensureString(obj.note, "config.note", ""),
-  };
-}
-
-function validateClientHistory(value: unknown, label: string): ClientHistory {
-  const obj = ensureObject(value, label);
-  const seqByMonthRaw = obj.seqByMonth === undefined ? {} : ensureObject(obj.seqByMonth, `${label}.seqByMonth`);
-
-  const seqByMonth = Object.entries(seqByMonthRaw).reduce<Record<string, number>>((acc, [month, seq]) => {
-    acc[month] = ensureOptionalNumber(seq, `${label}.seqByMonth.${month}`, 0);
-    return acc;
-  }, {});
-
-  return {
-    lastHours: ensureOptionalNumber(obj.lastHours, `${label}.lastHours`, 160),
-    lastRate: ensureOptionalNumber(obj.lastRate, `${label}.lastRate`, 0),
-    seqByMonth,
-  };
-}
-
-export function validateLastState(value: unknown): LastState {
-  const obj = ensureObject(value, "last");
-  const clientsRaw = obj.clients === undefined ? {} : ensureObject(obj.clients, "last.clients");
-
-  const clients = Object.entries(clientsRaw).reduce<Record<string, ClientHistory>>((acc, [name, history]) => {
-    acc[name] = validateClientHistory(history, `last.clients.${name}`);
-    return acc;
-  }, {});
-
-  return { clients };
-}
-
-function validateTimesheetEntry(value: unknown, label: string): TimesheetEntry {
-  const obj = ensureObject(value, label);
-
-  return {
-    id: ensureOptionalNumber(obj.id, `${label}.id`, Date.now()),
-    client: ensureString(obj.client, `${label}.client`),
-    date: ensureString(obj.date, `${label}.date`),
-    hours: ensureOptionalNumber(obj.hours, `${label}.hours`, 0),
-    description: ensureString(obj.description, `${label}.description`, ""),
-    rate: ensureOptionalNumber(obj.rate, `${label}.rate`, 0),
-    amount: ensureOptionalNumber(obj.amount, `${label}.amount`, 0),
-    createdAt: ensureString(obj.createdAt, `${label}.createdAt`, ""),
-  };
-}
-
-export function validateTimesheetData(value: unknown): TimesheetData {
-  const obj = ensureObject(value, "timesheet");
-  const entriesRaw = obj.entries === undefined ? [] : obj.entries;
-
-  if (!Array.isArray(entriesRaw)) {
-    throw new Error("timesheet.entries must be an array");
-  }
-
-  return {
-    entries: entriesRaw.map((entry, index) => validateTimesheetEntry(entry, `timesheet.entries[${index}]`)),
-  };
-}
-
-function validateArchivedEntry(value: unknown, label: string): ArchivedEntry {
-  const entry = validateTimesheetEntry(value, label);
-  const obj = ensureObject(value, label);
-
-  return {
-    ...entry,
-    archivedAt: ensureString(obj.archivedAt, `${label}.archivedAt`),
-    archivedReason: ensureString(obj.archivedReason, `${label}.archivedReason`, "invoiced"),
-    invoiceNumber: ensureString(obj.invoiceNumber, `${label}.invoiceNumber`),
-    invoiceMonth: ensureString(obj.invoiceMonth, `${label}.invoiceMonth`),
-  };
-}
-
-export function validateArchiveData(value: unknown): ArchiveData {
-  const obj = ensureObject(value, "archive");
-  const archivedRaw = obj.archivedEntries === undefined ? [] : obj.archivedEntries;
-
-  if (!Array.isArray(archivedRaw)) {
-    throw new Error("archive.archivedEntries must be an array");
-  }
-
-  return {
-    archivedEntries: archivedRaw.map((entry, index) =>
-      validateArchivedEntry(entry, `archive.archivedEntries[${index}]`),
-    ),
-  };
-}

package/src/domain/types.ts

@@ -1,129 +0,0 @@
-export interface FreelancerProfile {
-  name?: string;
-  email?: string;
-  address?: string;
-}
-
-export interface ClientConfig {
-  name: string;
-  email?: string;
-  address?: string;
-  currency?: string;
-  defaultRate: number;
-  payPeriodType?: string;
-}
-
-export interface Config {
-  client: ClientConfig[];
-  defaultDescription?: string;
-  from: FreelancerProfile;
-  invoicePrefix?: string;
-  note?: string;
-}
-
-export interface ClientHistory {
-  lastHours: number;
-  lastRate: number;
-  seqByMonth: Record<string, number>;
-}
-
-export interface LastState {
-  clients: Record<string, ClientHistory>;
-}
-
-export interface TimesheetEntry {
-  id: number;
-  client: string;
-  date: string;
-  hours: number;
-  description: string;
-  rate: number;
-  amount: number;
-  createdAt?: string;
-}
-
-export interface TimesheetData {
-  entries: TimesheetEntry[];
-}
-
-export interface ArchivedEntry extends TimesheetEntry {
-  archivedAt: string;
-  archivedReason: string;
-  invoiceNumber: string;
-  invoiceMonth: string;
-}
-
-export interface ArchiveData {
-  archivedEntries: ArchivedEntry[];
-}
-
-export interface AggregatedTimesheetGroup {
-  description: string;
-  hours: number;
-  rate: number;
-  amount: number;
-  periodFrom: string;
-  periodTo: string;
-  rateVariance: boolean;
-  minRate: number;
-  maxRate: number;
-  entryIds: number[];
-}
-
-export interface LineItem {
-  description: string;
-  hours: number;
-  rate: number;
-  amount: number;
-  periodFrom?: string;
-  periodTo?: string;
-}
-
-export interface GenerateOptions {
-  fromTimesheet?: boolean;
-  client?: string;
-  month?: string;
-  hours?: string;
-  rate?: string;
-  desc?: string;
-  invoice?: string;
-}
-
-export interface ClientsOptions {
-  list?: boolean;
-  add?: boolean;
-  edit?: string;
-  delete?: string;
-}
-
-export interface TimesheetOptions {
-  export?: string;
-  client?: string;
-  month?: string;
-  archive?: boolean;
-}
-
-export interface InvoicePayload {
-  from: FreelancerProfile;
-  client: ClientConfig;
-  currency: string;
-  invoiceNumber: string;
-  invoiceDate: string;
-  periodFrom: string;
-  periodTo: string;
-  lineItems: LineItem[];
-  paymentTerms?: string;
-  note?: string;
-}
-
-export interface SendInvoiceEmailInput {
-  outPath: string;
-  invoiceNumber: string;
-  clientName: string;
-  clientEmail: string;
-  currency: string;
-  total: number;
-  periodFrom: string;
-  periodTo: string;
-  senderName?: string;
-}

package/src/services/email.ts

@@ -1,40 +0,0 @@
-import path from "node:path";
-import nodemailer from "nodemailer";
-import { type SendInvoiceEmailInput } from "../domain/types.js";
-
-export function hasSmtpConfig(env: NodeJS.ProcessEnv = process.env): boolean {
-  return Boolean(env.SMTP_HOST && env.SMTP_USER && env.SMTP_PASS);
-}
-
-export async function sendInvoiceEmail(
-  input: SendInvoiceEmailInput,
-  env: NodeJS.ProcessEnv = process.env,
-): Promise<void> {
-  const smtpPort = Number(env.SMTP_PORT || 465);
-
-  const transporter = nodemailer.createTransport({
-    host: env.SMTP_HOST,
-    port: smtpPort,
-    secure: smtpPort === 465,
-    auth: {
-      user: env.SMTP_USER,
-      pass: env.SMTP_PASS,
-    },
-  });
-
-  const emailSubject = `Invoice ${input.invoiceNumber} - ${input.clientName}`;
-  const emailBody = `Dear ${input.clientName},\n\nPlease find attached invoice ${input.invoiceNumber}.\n\nInvoice Details:\n- Period: ${input.periodFrom} to ${input.periodTo}\n- Amount Due: ${input.currency} ${input.total.toFixed(2)}\n\nThank you for your business!\n\nBest regards,\n${input.senderName || ""}`;
-
-  await transporter.sendMail({
-    from: env.INVOICE_FROM || env.SMTP_USER,
-    to: input.clientEmail,
-    subject: emailSubject,
-    text: emailBody,
-    attachments: [
-      {
-        filename: path.basename(input.outPath),
-        path: input.outPath,
-      },
-    ],
-  });
-}

package/src/services/invoice-number.ts

@@ -1,46 +0,0 @@
-export function getDefaultMonth(now = new Date()): string {
-  return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}`;
-}
-
-export function validateMonth(month: string): boolean {
-  return /^\d{4}-\d{2}$/.test(month);
-}
-
-export function resolveInvoiceNumber(params: {
-  month: string;
-  invoicePrefix?: string;
-  overrideInvoice?: string;
-  seqByMonth: Record<string, number>;
-}): string {
-  const { month, invoicePrefix, overrideInvoice, seqByMonth } = params;
-  const trimmedOverride = overrideInvoice?.trim();
-
-  if (trimmedOverride) {
-    return trimmedOverride;
-  }
-
-  if (!seqByMonth[month]) {
-    seqByMonth[month] = 0;
-  }
-
-  seqByMonth[month] += 1;
-  const yyyymm = month.replace("-", "");
-  const prefix = invoicePrefix?.trim() || "INV";
-
-  return `${prefix}-${yyyymm}-${String(seqByMonth[month]).padStart(3, "0")}`;
-}
-
-export function getInvoicePeriod(month: string): { periodFrom: string; periodTo: string } {
-  const year = Number(month.slice(0, 4));
-  const monthNumber = Number(month.slice(5, 7));
-  const monthEnd = new Date(year, monthNumber, 0);
-
-  return {
-    periodFrom: `${month}-01`,
-    periodTo: `${month}-${String(monthEnd.getDate()).padStart(2, "0")}`,
-  };
-}
-
-export function getInvoiceDate(today = new Date()): string {
-  return today.toISOString().slice(0, 10);
-}

package/src/services/pdf-render.ts

@@ -1,95 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { pathToFileURL } from "node:url";
-import puppeteer from "puppeteer";
-import { type ProjectPaths } from "../core/paths.js";
-import { type InvoicePayload } from "../domain/types.js";
-import { sanitizePathSegment } from "../utils/sanitize.js";
-
-export async function renderInvoicePdf(
-  paths: ProjectPaths,
-  payload: InvoicePayload,
-  month: string,
-): Promise<string> {
-  const clientOutDir = path.join(paths.outDir, sanitizePathSegment(payload.client.name, "client"));
-  fs.mkdirSync(clientOutDir, { recursive: true });
-
-  const fileUrl = pathToFileURL(paths.indexHtmlPath).toString();
-
-  const browser = await puppeteer.launch({ headless: true });
-
-  try {
-    const page = await browser.newPage();
-    await page.goto(fileUrl, { waitUntil: "networkidle0" });
-
-    await page.evaluate((browserPayload) => {
-      const setVal = (id: string, value: string | number | undefined) => {
-        const el = document.getElementById(id) as HTMLInputElement | HTMLTextAreaElement | null;
-        if (!el) return;
-        el.value = String(value ?? "");
-        el.dispatchEvent(new Event("input", { bubbles: true }));
-        el.dispatchEvent(new Event("change", { bubbles: true }));
-      };
-
-      setVal("in_freelancer", browserPayload.from.name);
-      setVal("in_email", browserPayload.from.email);
-      setVal("in_freelancer_address", browserPayload.from.address);
-
-      setVal("in_client", browserPayload.client.name);
-      setVal("in_client_address", browserPayload.client.address);
-
-      setVal("in_currency", browserPayload.currency);
-      setVal("in_number", browserPayload.invoiceNumber);
-      setVal("in_date", browserPayload.invoiceDate);
-
-      setVal("in_payment_terms", browserPayload.paymentTerms || "");
-      setVal("in_note", browserPayload.note || "");
-
-      type InvoicerWindow = Window & {
-        __invoicer?: {
-          state?: { lineItems: Array<Record<string, unknown>> };
-          builder?: { renderLineItemsUI: () => void; buildPreview: () => void };
-        };
-      };
-
-      const win = window as InvoicerWindow;
-
-      if (win.__invoicer?.state && win.__invoicer.builder) {
-        win.__invoicer.state.lineItems = browserPayload.lineItems.map((item) => ({
-          description: item.description,
-          periodFrom: browserPayload.periodFrom,
-          periodTo: browserPayload.periodTo,
-          days: "",
-          hoursPerDay: "",
-          quantity: String(item.hours),
-          rate: Number(item.rate),
-          amount: Number(item.amount),
-        }));
-
-        win.__invoicer.builder.renderLineItemsUI();
-        win.__invoicer.builder.buildPreview();
-      }
-
-      const preview = document.querySelector("#preview") as HTMLElement | null;
-      if (preview) {
-        preview.style.display = "block";
-        document.body.innerHTML = "";
-        document.body.appendChild(preview);
-      }
-    }, payload);
-
-    const safeInvoiceNumber = sanitizePathSegment(payload.invoiceNumber, "invoice");
-    const outPath = path.join(clientOutDir, `invoice-${month}-${safeInvoiceNumber}.pdf`);
-
-    await page.pdf({
-      path: outPath,
-      format: "A4",
-      printBackground: true,
-      margin: { top: "12mm", right: "12mm", bottom: "12mm", left: "12mm" },
-    });
-
-    return outPath;
-  } finally {
-    await browser.close();
-  }
-}