@voyant-travel/finance 0.119.5

package/dist/service-aggregates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-aggregates.d.ts","sourceRoot":"","sources":["../src/service-aggregates.ts"],"names":[],"mappings":"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"}

package/dist/service-aggregates.js

@@ -0,0 +1,294 @@
+import { and, asc, inArray, ne, sql } from "drizzle-orm";
+import { invoices, paymentSessions, payments } from "./schema.js";
+const ALL_INVOICE_STATUSES = [
+    "draft",
+    "pending_external_allocation",
+    "issued",
+    "partially_paid",
+    "paid",
+    "overdue",
+    "void",
+];
+/** Statuses where balance_due_cents > 0 is meaningful money we're owed. */
+const OUTSTANDING_STATUSES = ["issued", "partially_paid", "overdue"];
+export async function getFinanceAggregates(db, options = {}) {
+    const outstandingTopLimit = Math.max(0, Math.min(options.outstandingTopLimit ?? 5, 20));
+    const { fromDate, toDate } = resolveAggregateRange(options);
+    const rangeConditions = [];
+    // agent-quality: raw-sql reviewed -- owner: finance; dynamic SQL interpolation uses Drizzle parameter binding or vetted SQL identifiers.
+    if (fromDate)
+        rangeConditions.push(sql `${invoices.createdAt} >= ${fromDate.toISOString()}`);
+    // agent-quality: raw-sql reviewed -- owner: finance; dynamic SQL interpolation uses Drizzle parameter binding or vetted SQL identifiers.
+    if (toDate)
+        rangeConditions.push(sql `${invoices.createdAt} < ${toDate.toISOString()}`);
+    const invoiceConditions = [...rangeConditions];
+    if (options.currency?.length)
+        invoiceConditions.push(inArray(invoices.currency, options.currency));
+    if (options.invoiceType?.length) {
+        invoiceConditions.push(inArray(invoices.invoiceType, options.invoiceType));
+    }
+    if (options.status?.length)
+        invoiceConditions.push(inArray(invoices.status, options.status));
+    const rangeWhere = invoiceConditions.length ? and(...invoiceConditions) : undefined;
+    const paymentConditions = [];
+    // agent-quality: raw-sql reviewed -- owner: finance; dynamic SQL interpolation uses Drizzle parameter binding or vetted SQL identifiers.
+    if (fromDate)
+        paymentConditions.push(sql `${payments.paymentDate} >= ${dateOnly(fromDate)}`);
+    // agent-quality: raw-sql reviewed -- owner: finance; dynamic SQL interpolation uses Drizzle parameter binding or vetted SQL identifiers.
+    if (toDate)
+        paymentConditions.push(sql `${payments.paymentDate} < ${dateOnly(toDate)}`);
+    if (options.currency?.length)
+        paymentConditions.push(inArray(payments.currency, options.currency));
+    const paymentWhere = paymentConditions.length ? and(...paymentConditions) : undefined;
+    const sessionConditions = [];
+    if (fromDate)
+        // agent-quality: raw-sql reviewed -- owner: finance; dynamic SQL interpolation uses Drizzle parameter binding or vetted SQL identifiers.
+        sessionConditions.push(sql `${paymentSessions.createdAt} >= ${fromDate.toISOString()}`);
+    // agent-quality: raw-sql reviewed -- owner: finance; dynamic SQL interpolation uses Drizzle parameter binding or vetted SQL identifiers.
+    if (toDate)
+        sessionConditions.push(sql `${paymentSessions.createdAt} < ${toDate.toISOString()}`);
+    if (options.currency?.length) {
+        sessionConditions.push(inArray(paymentSessions.currency, options.currency));
+    }
+    const sessionWhere = sessionConditions.length ? and(...sessionConditions) : undefined;
+    // Outstanding + overdue always look at the whole book (not the date range),
+    // since "what are we owed right now" is a point-in-time question — bounding
+    // it by `from..to` would hide old unpaid invoices.
+    const todayUtc = new Date();
+    todayUtc.setUTCHours(0, 0, 0, 0);
+    const todayDateString = todayUtc.toISOString().slice(0, 10);
+    const outstandingWhere = and(inArray(invoices.status, [...OUTSTANDING_STATUSES]), 
+    // agent-quality: raw-sql reviewed -- owner: finance; dynamic SQL interpolation uses Drizzle parameter binding or vetted SQL identifiers.
+    sql `${invoices.balanceDueCents} > 0`);
+    const [[totalRow], statusRows, monthlyInvoiceCountsRows, monthlyRevenueRows, invoiceSummaryRows, invoiceTotalsRows, paymentTotalsRows, paymentSessionRows, outstandingRows, overdueRows, outstandingTopRows,] = await Promise.all([
+        db.select({ count: sql `count(*)::int` }).from(invoices).where(rangeWhere),
+        db
+            .select({
+            status: invoices.status,
+            count: sql `count(*)::int`,
+        })
+            .from(invoices)
+            .where(rangeWhere)
+            .groupBy(invoices.status),
+        db
+            .select({
+            yearMonth: sql `to_char(${invoices.createdAt} at time zone 'UTC', 'YYYY-MM')`,
+            count: sql `count(*)::int`,
+        })
+            .from(invoices)
+            .where(rangeWhere)
+            // agent-quality: raw-sql reviewed -- owner: finance; dynamic SQL interpolation uses Drizzle parameter binding or vetted SQL identifiers.
+            .groupBy(sql `to_char(${invoices.createdAt} at time zone 'UTC', 'YYYY-MM')`)
+            // agent-quality: raw-sql reviewed -- owner: finance; dynamic SQL interpolation uses Drizzle parameter binding or vetted SQL identifiers.
+            .orderBy(sql `to_char(${invoices.createdAt} at time zone 'UTC', 'YYYY-MM')`),
+        db
+            .select({
+            yearMonth: sql `to_char(${invoices.createdAt} at time zone 'UTC', 'YYYY-MM')`,
+            currency: invoices.currency,
+            totalCents: sql `coalesce(sum(${invoices.totalCents}), 0)::bigint`,
+        })
+            .from(invoices)
+            .where(and(...invoiceConditions, ne(invoices.status, "void")))
+            // agent-quality: raw-sql reviewed -- owner: finance; dynamic SQL interpolation uses Drizzle parameter binding or vetted SQL identifiers.
+            .groupBy(sql `to_char(${invoices.createdAt} at time zone 'UTC', 'YYYY-MM')`, invoices.currency)
+            .orderBy(
+        // agent-quality: raw-sql reviewed -- owner: finance; dynamic SQL interpolation uses Drizzle parameter binding or vetted SQL identifiers.
+        sql `to_char(${invoices.createdAt} at time zone 'UTC', 'YYYY-MM')`, invoices.currency),
+        db
+            .select({
+            invoiceType: invoices.invoiceType,
+            status: invoices.status,
+            count: sql `count(*)::int`,
+        })
+            .from(invoices)
+            .where(rangeWhere)
+            .groupBy(invoices.invoiceType, invoices.status),
+        db
+            .select({
+            currency: invoices.currency,
+            invoiced: sql `coalesce(sum(case when ${invoices.status} != 'void' then ${invoices.totalCents} else 0 end), 0)::bigint`,
+            outstanding: sql `coalesce(sum(case when ${invoices.status} not in ('paid', 'void') then ${invoices.balanceDueCents} else 0 end), 0)::bigint`,
+        })
+            .from(invoices)
+            .where(rangeWhere)
+            .groupBy(invoices.currency)
+            .orderBy(invoices.currency),
+        db
+            .select({
+            currency: payments.currency,
+            collected: sql `coalesce(sum(case when ${payments.status} = 'completed' then ${payments.amountCents} else 0 end), 0)::bigint`,
+            refunded: sql `coalesce(sum(case when ${payments.status} = 'refunded' then ${payments.amountCents} else 0 end), 0)::bigint`,
+        })
+            .from(payments)
+            .where(paymentWhere)
+            .groupBy(payments.currency)
+            .orderBy(payments.currency),
+        db
+            .select({
+            status: paymentSessions.status,
+            count: sql `count(*)::int`,
+        })
+            .from(paymentSessions)
+            .where(sessionWhere)
+            .groupBy(paymentSessions.status),
+        db
+            .select({
+            currency: invoices.currency,
+            balanceDueCents: sql `coalesce(sum(${invoices.balanceDueCents}), 0)::bigint`,
+            count: sql `count(*)::int`,
+        })
+            .from(invoices)
+            .where(outstandingWhere)
+            .groupBy(invoices.currency)
+            .orderBy(invoices.currency),
+        db
+            .select({
+            currency: invoices.currency,
+            balanceDueCents: sql `coalesce(sum(${invoices.balanceDueCents}), 0)::bigint`,
+            count: sql `count(*)::int`,
+        })
+            .from(invoices)
+            // agent-quality: raw-sql reviewed -- owner: finance; dynamic SQL interpolation uses Drizzle parameter binding or vetted SQL identifiers.
+            .where(and(outstandingWhere, sql `${invoices.dueDate} < ${todayDateString}`))
+            .groupBy(invoices.currency)
+            .orderBy(invoices.currency),
+        outstandingTopLimit === 0
+            ? Promise.resolve([])
+            : db
+                .select({
+                id: invoices.id,
+                invoiceNumber: invoices.invoiceNumber,
+                bookingId: invoices.bookingId,
+                status: invoices.status,
+                currency: invoices.currency,
+                totalCents: invoices.totalCents,
+                balanceDueCents: invoices.balanceDueCents,
+                issueDate: invoices.issueDate,
+                dueDate: invoices.dueDate,
+            })
+                .from(invoices)
+                .where(outstandingWhere)
+                // Nulls-last on dueDate so undated invoices don't pretend to be
+                // the most overdue. After that, oldest issued first.
+                .orderBy(
+            // agent-quality: raw-sql reviewed -- owner: finance; dynamic SQL interpolation uses Drizzle parameter binding or vetted SQL identifiers.
+            sql `${invoices.dueDate} IS NULL`, asc(invoices.dueDate), asc(invoices.issueDate), asc(invoices.id))
+                .limit(outstandingTopLimit),
+    ]);
+    const countsByStatusMap = new Map(statusRows.map((row) => [row.status, row.count]));
+    return {
+        total: totalRow?.count ?? 0,
+        countsByStatus: ALL_INVOICE_STATUSES.map((status) => ({
+            status,
+            count: countsByStatusMap.get(status) ?? 0,
+        })),
+        counts: financeCounts(invoiceSummaryRows, paymentSessionRows),
+        totals: financeTotals(invoiceTotalsRows, paymentTotalsRows),
+        monthlyRevenue: monthlyRevenueRows.map((row) => ({
+            yearMonth: row.yearMonth,
+            currency: row.currency,
+            totalCents: Number(row.totalCents),
+        })),
+        monthlyInvoiceCounts: monthlyInvoiceCountsRows.map((row) => ({
+            yearMonth: row.yearMonth,
+            count: row.count,
+        })),
+        outstanding: outstandingRows.map((row) => ({
+            currency: row.currency,
+            balanceDueCents: Number(row.balanceDueCents),
+            count: row.count,
+        })),
+        overdue: overdueRows.map((row) => ({
+            currency: row.currency,
+            balanceDueCents: Number(row.balanceDueCents),
+            count: row.count,
+        })),
+        outstandingTopN: outstandingTopRows.map((row) => ({
+            id: row.id,
+            invoiceNumber: row.invoiceNumber ?? null,
+            bookingId: row.bookingId ?? null,
+            status: row.status,
+            currency: row.currency,
+            totalCents: Number(row.totalCents),
+            balanceDueCents: Number(row.balanceDueCents),
+            issueDate: row.issueDate ?? null,
+            dueDate: row.dueDate ?? null,
+        })),
+    };
+}
+function resolveAggregateRange(options) {
+    if (options.from || options.to || options.range === "custom") {
+        return {
+            fromDate: options.from ? new Date(options.from) : undefined,
+            toDate: options.to ? new Date(options.to) : undefined,
+        };
+    }
+    const now = new Date();
+    const year = now.getUTCFullYear();
+    const month = now.getUTCMonth();
+    if (options.range === "this_month") {
+        return {
+            fromDate: new Date(Date.UTC(year, month, 1)),
+            toDate: new Date(Date.UTC(year, month + 1, 1)),
+        };
+    }
+    if (options.range === "last_month") {
+        return {
+            fromDate: new Date(Date.UTC(year, month - 1, 1)),
+            toDate: new Date(Date.UTC(year, month, 1)),
+        };
+    }
+    if (options.range === "year_to_date") {
+        return {
+            fromDate: new Date(Date.UTC(year, 0, 1)),
+            toDate: undefined,
+        };
+    }
+    return { fromDate: undefined, toDate: undefined };
+}
+function dateOnly(date) {
+    return date.toISOString().slice(0, 10);
+}
+function financeCounts(invoiceRows, paymentSessionRows) {
+    const invoiceCount = (invoiceType, statuses) => invoiceRows
+        .filter((row) => row.invoiceType === invoiceType && statuses.includes(row.status))
+        .reduce((sum, row) => sum + row.count, 0);
+    const sessionCount = (statuses) => paymentSessionRows
+        .filter((row) => statuses.includes(row.status))
+        .reduce((sum, row) => sum + row.count, 0);
+    return {
+        invoices: {
+            issued: invoiceCount("invoice", ["issued", "partially_paid", "overdue"]),
+            paid: invoiceCount("invoice", ["paid"]),
+            void: invoiceCount("invoice", ["void"]),
+            overdue: invoiceCount("invoice", ["overdue"]),
+        },
+        proformas: {
+            issued: invoiceCount("proforma", ["issued", "partially_paid", "overdue", "paid"]),
+            converted: invoiceCount("proforma", ["paid"]),
+            void: invoiceCount("proforma", ["void"]),
+        },
+        paymentSessions: {
+            pending: sessionCount(["pending", "requires_redirect", "processing", "authorized"]),
+            paid: sessionCount(["paid"]),
+            failed: sessionCount(["failed", "cancelled", "expired"]),
+        },
+    };
+}
+function financeTotals(invoiceRows, paymentRows) {
+    const currencies = new Set([
+        ...invoiceRows.map((row) => row.currency),
+        ...paymentRows.map((row) => row.currency),
+    ]);
+    return [...currencies].sort().map((currency) => {
+        const invoice = invoiceRows.find((row) => row.currency === currency);
+        const payment = paymentRows.find((row) => row.currency === currency);
+        return {
+            currency,
+            invoiced: Number(invoice?.invoiced ?? 0),
+            collected: Number(payment?.collected ?? 0),
+            outstanding: Number(invoice?.outstanding ?? 0),
+            refunded: Number(payment?.refunded ?? 0),
+        };
+    });
+}