@voyant-travel/finance-react 0.119.5

package/dist/admin/booking-payment-policy-widget.js

@@ -0,0 +1,128 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useQueryClient } from "@tanstack/react-query";
+import { useOperatorAdminMessages } from "@voyant-travel/admin";
+import { bookingsQueryKeys, useBookingActivity } from "@voyant-travel/bookings-react";
+import { formatMessage } from "@voyant-travel/i18n";
+import { Badge, Button, Collapsible, CollapsibleContent, CollapsibleTrigger, Dialog, DialogBody, DialogContent, DialogFooter, DialogHeader, DialogTitle, } from "@voyant-travel/ui/components";
+import { ChevronDown, History, Loader2 } from "lucide-react";
+import { useEffect, useMemo, useState } from "react";
+import { toast } from "sonner";
+import { PaymentPolicyForm, PaymentPolicyPreview } from "../components/payment-policy-form.js";
+import { useBookingPaymentScheduleRegenerateMutation } from "../index.js";
+/**
+ * Booking detail → Finance tab → Payment-policy card, delivered as a
+ * widget contribution on `booking.details.finance-end` (packaged-admin RFC
+ * §4.7 cycle resolution: this package depends on `@voyant-travel/bookings-react/ui`,
+ * so the bookings host cannot import the card — finance contributes it).
+ *
+ * Surfaces the cascade trace (which layer's policy applied to this
+ * booking's schedule) and lets ops override the policy + regenerate the
+ * schedule. Mounted below the schedule list, collapsed by default, so the
+ * operator sees both the rule and the generated installments together.
+ */
+export function BookingPaymentPolicyWidget({ booking }) {
+    const t = useOperatorAdminMessages().bookings.detail.paymentPolicyCard;
+    return (_jsxs(Collapsible, { children: [_jsxs(CollapsibleTrigger, { className: "group flex w-full items-center justify-between rounded-md border bg-background px-4 py-3 text-sm font-semibold hover:bg-muted/30", children: [t.title, _jsx(ChevronDown, { className: "h-4 w-4 transition-transform group-data-panel-open:rotate-180" })] }), _jsx(CollapsibleContent, { className: "mt-3", children: _jsx(BookingPaymentPolicyCard, { booking: booking, messages: t }) })] }));
+}
+function BookingPaymentPolicyCard({ booking, messages: t, }) {
+    const queryClient = useQueryClient();
+    const persisted = booking.customerPaymentPolicy ?? null;
+    const [draft, setDraft] = useState(persisted);
+    const [dialogOpen, setDialogOpen] = useState(false);
+    const [resolvedSource, setResolvedSource] = useState(null);
+    // Read the current cascade source from the booking's
+    // internalNotes marker (stamped by the schedule subscriber). This
+    // is best-effort — if the booking hasn't been confirmed yet, no
+    // marker exists and the badge falls back to "(not yet computed)".
+    const initialSource = useMemo(() => {
+        return readSourceFromNotes(booking.internalNotes ?? "") ?? null;
+    }, [booking.internalNotes]);
+    useEffect(() => {
+        setResolvedSource(initialSource);
+    }, [initialSource]);
+    useEffect(() => {
+        setDraft(persisted);
+    }, [persisted]);
+    const regenerate = useBookingPaymentScheduleRegenerateMutation(booking.id);
+    const submitPolicy = (policy) => {
+        regenerate.mutate({ customerPaymentPolicy: policy ?? null }, {
+            onSuccess: ({ cascadeSource }) => {
+                setResolvedSource(cascadeSource);
+                toast.success(t.regenerateSucceeded);
+                // The hook already refreshes the schedule list; the booking
+                // record carries the persisted override, so refresh it too.
+                void queryClient.invalidateQueries({
+                    queryKey: bookingsQueryKeys.booking(booking.id),
+                });
+                setDialogOpen(false);
+            },
+            onError: (err) => {
+                toast.error(err instanceof Error ? err.message : t.regenerateFailed);
+            },
+        });
+    };
+    const policySourceLabel = (source) => {
+        if (!source)
+            return t.sourceLabels.unknown;
+        return t.sourceLabels[source] ?? source;
+    };
+    const persistedHasOverride = persisted !== null;
+    return (_jsxs("div", { "data-slot": "booking-payment-policy", className: "flex flex-col gap-4", children: [_jsxs("div", { className: "flex items-start justify-between gap-3", children: [_jsx("p", { className: "text-sm text-muted-foreground", children: t.description }), _jsx(Badge, { variant: persistedHasOverride ? "default" : "outline", children: persistedHasOverride
+                            ? t.sourceLabels.booking
+                            : formatMessage(t.cascadePrefix, { source: policySourceLabel(resolvedSource) }) })] }), _jsx("div", { className: "rounded-md border p-4", children: persistedHasOverride ? (_jsx(PaymentPolicyPreview, { policy: persisted, currency: booking.sellCurrency ?? "EUR", sampleTotalCents: booking.sellAmountCents ?? 100_000 })) : (_jsx("p", { className: "text-muted-foreground text-sm", children: formatMessage(t.noOverrideHint, {
+                        source: policySourceLabel(resolvedSource).toLowerCase(),
+                    }) })) }), _jsxs("div", { className: "flex justify-end gap-2", children: [persistedHasOverride ? (_jsxs(Button, { variant: "outline", size: "sm", disabled: regenerate.isPending, onClick: () => submitPolicy(null), children: [regenerate.isPending ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : null, t.clearOverride] })) : null, _jsx(Button, { variant: "outline", size: "sm", onClick: () => setDialogOpen(true), children: persistedHasOverride ? t.editOverride : t.addOverride })] }), _jsx(PaymentPolicyHistory, { bookingId: booking.id, messages: t }), _jsx(Dialog, { open: dialogOpen, onOpenChange: setDialogOpen, children: _jsxs(DialogContent, { size: "lg", children: [_jsx(DialogHeader, { children: _jsx(DialogTitle, { children: t.dialogTitle }) }), _jsxs(DialogBody, { className: "grid gap-6 lg:grid-cols-[2fr_1fr]", children: [_jsx(PaymentPolicyForm, { value: draft, onChange: setDraft, inheritable: false, currency: booking.sellCurrency ?? "EUR", disabled: regenerate.isPending }), _jsx(PaymentPolicyPreview, { policy: draft, currency: booking.sellCurrency ?? "EUR", sampleTotalCents: booking.sellAmountCents ?? 100_000 })] }), _jsxs(DialogFooter, { children: [_jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: () => setDialogOpen(false), disabled: regenerate.isPending, children: t.cancel }), _jsxs(Button, { type: "button", size: "sm", disabled: regenerate.isPending || draft === null, onClick: () => submitPolicy(draft), children: [regenerate.isPending ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : null, t.saveAndRegenerate] })] })] }) })] }));
+}
+/**
+ * Inline history of payment-schedule regenerations for this booking.
+ *
+ * Reads the `booking_activity_log` table (filtered to entries the
+ * scheduler tagged with `metadata.kind === "payment_schedule_regenerated"`)
+ * and renders the most recent ten entries — operator sees the
+ * cascade-source chain over time and can spot when the schedule was
+ * last regenerated.
+ *
+ * The Activity tab on the booking page already shows the full
+ * timeline; this card-local view is just the policy slice for
+ * convenience.
+ */
+function PaymentPolicyHistory({ bookingId, messages, }) {
+    const { data, isLoading } = useBookingActivity(bookingId);
+    const rows = Array.isArray(data) ? data : (data?.data ?? []);
+    const policyRows = rows
+        .filter((row) => row.activityType === "system_action" &&
+        row.metadata?.kind === "payment_schedule_regenerated")
+        .slice(0, 10);
+    if (isLoading) {
+        return _jsx("div", { className: "text-muted-foreground text-xs", children: messages.historyLoading });
+    }
+    if (policyRows.length === 0) {
+        return (_jsxs("div", { className: "rounded-md border border-dashed p-3 text-muted-foreground text-xs", children: [_jsx(History, { className: "mr-1 inline-block h-3 w-3" }), messages.historyEmpty] }));
+    }
+    return (_jsxs("div", { className: "rounded-md border bg-muted/10 p-3", children: [_jsxs("div", { className: "mb-2 flex items-center gap-2 text-xs font-medium", children: [_jsx(History, { className: "h-3 w-3" }), messages.historyTitle] }), _jsx("ul", { className: "space-y-2 text-xs", children: policyRows.map((row) => {
+                    const meta = row.metadata ?? {};
+                    const source = String(meta.policySource ?? "operator_default");
+                    const entries = Array.isArray(meta.entries) ? meta.entries : [];
+                    const sourceLabel = messages.sourceLabels[source] ?? source;
+                    const template = entries.length === 1 ? messages.historyRowSingular : messages.historyRowPlural;
+                    return (_jsxs("li", { className: "flex flex-col gap-0.5", children: [_jsxs("div", { className: "flex items-center justify-between gap-2", children: [_jsx("span", { className: "font-medium", children: formatMessage(template, { source: sourceLabel, count: entries.length }) }), _jsx("span", { className: "font-mono text-muted-foreground", children: new Date(row.createdAt).toLocaleString() })] }), _jsx("span", { className: "text-muted-foreground", children: row.description })] }, row.id));
+                }) })] }));
+}
+const POLICY_SOURCE_MARKER_PREFIX = "__payment_policy_source__:";
+function readSourceFromNotes(notes) {
+    for (const line of notes.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith(POLICY_SOURCE_MARKER_PREFIX)) {
+            const value = trimmed.slice(POLICY_SOURCE_MARKER_PREFIX.length).trim();
+            if (value === "booking" ||
+                value === "listing" ||
+                value === "category" ||
+                value === "supplier" ||
+                value === "operator_default") {
+                return value;
+            }
+        }
+    }
+    return null;
+}

package/dist/admin/booking-pending-payment-sessions-widget.d.ts

@@ -0,0 +1,24 @@
+import type { BookingDetailHostSlotContext } from "@voyant-travel/bookings-react/admin";
+import * as React from "react";
+/**
+ * Props of the pending payment-sessions widget: exactly the slot context
+ * the bookings detail host hands to `booking.details.finance-start` widget
+ * contributions (see `bookingDetailFinanceStartSlot` in
+ * `@voyant-travel/bookings-react/admin`).
+ */
+export type BookingPendingPaymentSessionsWidgetProps = BookingDetailHostSlotContext;
+/**
+ * Finance-owned payment-links card for the booking detail page's Finance
+ * tab, delivered as a widget contribution on `booking.details.finance-start`
+ * (packaged-admin RFC §4.7 cycle resolution: this package depends on
+ * `@voyant-travel/bookings-react/ui`, so the bookings host cannot import the card —
+ * finance contributes it instead). Lists the booking's pending payment
+ * sessions and lets ops copy the public payment link, mark a session paid
+ * (manual bank-transfer capture) or cancel it.
+ *
+ * The copy action resolves the public checkout origin from the
+ * starter-level `/v1/public/payment-link-config` route through the shared
+ * finance provider context, falling back to the dashboard origin.
+ */
+export declare function BookingPendingPaymentSessionsWidget({ booking, fullyPaidReason, onGenerateLink, }: BookingPendingPaymentSessionsWidgetProps): React.ReactElement;
+//# sourceMappingURL=booking-pending-payment-sessions-widget.d.ts.map

package/dist/admin/booking-pending-payment-sessions-widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"booking-pending-payment-sessions-widget.d.ts","sourceRoot":"","sources":["../../src/admin/booking-pending-payment-sessions-widget.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAA;AAqBvF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAc9B;;;;;GAKG;AACH,MAAM,MAAM,wCAAwC,GAAG,4BAA4B,CAAA;AAEnF;;;;;;;;;;;;GAYG;AACH,wBAAgB,mCAAmC,CAAC,EAClD,OAAO,EACP,eAAe,EACf,cAAc,GACf,EAAE,wCAAwC,GAAG,KAAK,CAAC,YAAY,CA0M/D"}

package/dist/admin/booking-pending-payment-sessions-widget.js

@@ -0,0 +1,139 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useQuery, useQueryClient } from "@tanstack/react-query";
+import { useOperatorAdminMessages } from "@voyant-travel/admin";
+import { bookingsQueryKeys } from "@voyant-travel/bookings-react";
+import { IconActionButton, StatusBadge, useBookingsUiI18nOrDefault, } from "@voyant-travel/bookings-react/ui";
+import { buildPaymentLinkUrl } from "@voyant-travel/finance/payment-link";
+import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, } from "@voyant-travel/ui/components";
+import { Button } from "@voyant-travel/ui/components/button";
+import { DataTable } from "@voyant-travel/ui/components/data-table";
+import { Tooltip, TooltipContent, TooltipTrigger } from "@voyant-travel/ui/components/tooltip";
+import { Check, Copy, Loader2, Plus, Trash2, Wallet } from "lucide-react";
+import * as React from "react";
+import { toast } from "sonner";
+import { financeQueryKeys, usePaymentSessionMutation, usePaymentSessions, useVoyantFinanceContext, } from "../index.js";
+/**
+ * Finance-owned payment-links card for the booking detail page's Finance
+ * tab, delivered as a widget contribution on `booking.details.finance-start`
+ * (packaged-admin RFC §4.7 cycle resolution: this package depends on
+ * `@voyant-travel/bookings-react/ui`, so the bookings host cannot import the card —
+ * finance contributes it instead). Lists the booking's pending payment
+ * sessions and lets ops copy the public payment link, mark a session paid
+ * (manual bank-transfer capture) or cancel it.
+ *
+ * The copy action resolves the public checkout origin from the
+ * starter-level `/v1/public/payment-link-config` route through the shared
+ * finance provider context, falling back to the dashboard origin.
+ */
+export function BookingPendingPaymentSessionsWidget({ booking, fullyPaidReason, onGenerateLink, }) {
+    const t = useOperatorAdminMessages().bookings.detail.paymentSessions;
+    const { formatDateTime } = useBookingsUiI18nOrDefault();
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const queryClient = useQueryClient();
+    const bookingId = booking.id;
+    const [cancelTarget, setCancelTarget] = React.useState(null);
+    const { data } = usePaymentSessions({ bookingId, status: "pending", limit: 10 });
+    // Shares the cache entry with `useCheckoutPaymentLinkConfig` from
+    // Finance checkout collection uses the same endpoint and query key.
+    const { data: paymentLinkConfig } = useQuery({
+        queryKey: ["checkout-payment-link-config"],
+        queryFn: async () => {
+            const response = await fetcher(`${baseUrl}/v1/public/payment-link-config`, {
+                headers: { Accept: "application/json" },
+            });
+            if (!response.ok)
+                throw new Error(`config fetch failed: ${response.status}`);
+            const body = (await response.json());
+            return body.data;
+        },
+        staleTime: 5 * 60 * 1000,
+    });
+    const { complete, cancel } = usePaymentSessionMutation();
+    // The mutation hook already refreshes finance-owned session/payment/
+    // invoice lists; refresh the booking-scoped surfaces here.
+    const invalidateBookingSurroundings = React.useCallback(() => {
+        void queryClient.invalidateQueries({
+            queryKey: financeQueryKeys.adminBookingPayments(bookingId),
+        });
+        void queryClient.invalidateQueries({ queryKey: bookingsQueryKeys.booking(bookingId) });
+        void queryClient.invalidateQueries({ queryKey: bookingsQueryKeys.actionLedger(bookingId) });
+    }, [queryClient, bookingId]);
+    const completeMutate = complete.mutate;
+    const markReceived = React.useCallback((sessionId) => {
+        const now = new Date().toISOString();
+        completeMutate({
+            id: sessionId,
+            input: {
+                status: "paid",
+                captureMode: "manual",
+                paymentMethod: "bank_transfer",
+                paymentDate: now,
+                authorizedAt: now,
+                capturedAt: now,
+            },
+        }, { onSuccess: invalidateBookingSurroundings });
+    }, [completeMutate, invalidateBookingSurroundings]);
+    const cancelSession = (sessionId) => {
+        cancel.mutate({ id: sessionId }, {
+            onSuccess: () => {
+                invalidateBookingSurroundings();
+                setCancelTarget(null);
+            },
+        });
+    };
+    const sessions = data?.data ?? [];
+    const columns = React.useMemo(() => [
+        {
+            accessorKey: "createdAt",
+            header: t.columnDate,
+            cell: ({ row }) => formatDateTime(row.original.createdAt),
+        },
+        {
+            accessorKey: "amountCents",
+            header: t.columnAmount,
+            cell: ({ row }) => (_jsx("span", { className: "font-mono font-medium", children: formatMoney(row.original.amountCents, row.original.currency) })),
+        },
+        {
+            accessorKey: "status",
+            header: t.columnStatus,
+            cell: ({ row }) => (_jsx(StatusBadge, { status: row.original.status, children: t.statusLabels[row.original.status] ??
+                    row.original.status })),
+        },
+        {
+            id: "actions",
+            header: "",
+            cell: ({ row }) => {
+                const session = row.original;
+                const isMarkingThis = complete.isPending && complete.variables?.id === session.id;
+                return (_jsxs("div", { className: "flex items-center justify-end gap-1", children: [_jsx(IconActionButton, { label: t.copyPaymentLink, icon: _jsx(Copy, { className: "h-3.5 w-3.5" }), onClick: () => void copyPaymentLink(session.id, paymentLinkConfig?.publicCheckoutBaseUrl, t) }), _jsx(IconActionButton, { label: t.markReceived, icon: isMarkingThis ? (_jsx(Loader2, { className: "h-3.5 w-3.5 animate-spin" })) : (_jsx(Check, { className: "h-3.5 w-3.5" })), disabled: complete.isPending, onClick: () => markReceived(session.id) }), _jsx(IconActionButton, { label: t.cancelPaymentLink, icon: _jsx(Trash2, { className: "h-3.5 w-3.5" }), className: "text-muted-foreground hover:bg-destructive/10 hover:text-destructive", onClick: () => setCancelTarget(session) })] }));
+            },
+        },
+    ], [formatDateTime, complete.isPending, complete.variables, markReceived, paymentLinkConfig, t]);
+    return (_jsxs("div", { "data-slot": "booking-payment-links", className: "flex flex-col gap-3", children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsxs("h2", { className: "flex items-center gap-2 text-base font-semibold", children: [_jsx(Wallet, { className: "h-4 w-4" }), t.pendingTitle] }), onGenerateLink ? (fullyPaidReason ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { render: _jsx("span", { tabIndex: 0, className: "inline-block" }), children: _jsxs(Button, { variant: "outline", size: "sm", disabled: true, className: "pointer-events-none", children: [_jsx(Plus, { className: "mr-2 h-4 w-4" }), t.generatePaymentLink] }) }), _jsx(TooltipContent, { children: fullyPaidReason })] })) : (_jsxs(Button, { variant: "outline", size: "sm", onClick: onGenerateLink, children: [_jsx(Plus, { className: "mr-2 h-4 w-4" }), t.generatePaymentLink] }))) : null] }), _jsx(DataTable, { columns: columns, data: sessions, emptyMessage: t.empty, showPagination: false }), complete.error ? (_jsx("p", { className: "text-destructive text-xs", children: complete.error instanceof Error ? complete.error.message : t.markReceivedFailed })) : null, _jsx(AlertDialog, { open: Boolean(cancelTarget), onOpenChange: (next) => {
+                    if (!next && !cancel.isPending)
+                        setCancelTarget(null);
+                }, children: _jsxs(AlertDialogContent, { size: "sm", children: [_jsxs(AlertDialogHeader, { children: [_jsx(AlertDialogTitle, { children: t.cancelConfirmTitle }), _jsx(AlertDialogDescription, { children: t.cancelConfirmDescription })] }), _jsxs(AlertDialogFooter, { children: [_jsx(AlertDialogCancel, { disabled: cancel.isPending, children: t.cancelConfirmCancel }), _jsx(AlertDialogAction, { variant: "destructive", disabled: cancel.isPending, onClick: () => cancelTarget && cancelSession(cancelTarget.id), children: t.cancelConfirmConfirm })] })] }) })] }));
+}
+async function copyPaymentLink(paymentSessionId, publicCheckoutBaseUrl, messages) {
+    if (typeof window === "undefined")
+        return;
+    const url = buildPaymentLinkUrl(paymentSessionId, {
+        baseUrl: publicCheckoutBaseUrl ?? window.location.origin,
+    });
+    try {
+        await navigator.clipboard.writeText(url);
+        toast.success(messages.paymentLinkCopied);
+    }
+    catch {
+        toast.error(messages.paymentLinkCopyFailed);
+    }
+}
+function formatMoney(cents, currency) {
+    try {
+        return new Intl.NumberFormat(undefined, { style: "currency", currency }).format(cents / 100);
+    }
+    catch {
+        return `${(cents / 100).toFixed(2)} ${currency}`;
+    }
+}

package/dist/admin/credit-note-dialog.d.ts

@@ -0,0 +1,9 @@
+export interface CreditNoteDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    invoiceId: string;
+    invoiceCurrency: string;
+    onSuccess?: () => void;
+}
+export declare function CreditNoteDialog({ open, onOpenChange, invoiceId, invoiceCurrency, onSuccess, }: CreditNoteDialogProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=credit-note-dialog.d.ts.map

package/dist/admin/credit-note-dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-note-dialog.d.ts","sourceRoot":"","sources":["../../src/admin/credit-note-dialog.tsx"],"names":[],"mappings":"AAuCA,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB;AASD,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,YAAY,EACZ,SAAS,EACT,eAAe,EACf,SAAS,GACV,EAAE,qBAAqB,2CAsHvB"}

package/dist/admin/credit-note-dialog.js

@@ -0,0 +1,70 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useOperatorAdminMessages } from "@voyant-travel/admin";
+import { Button, Dialog, DialogBody, DialogContent, DialogFooter, DialogHeader, DialogTitle, Input, Label, Textarea, } from "@voyant-travel/ui/components";
+import { CurrencyCombobox } from "@voyant-travel/ui/components/currency-combobox";
+import { zodResolver } from "@voyant-travel/ui/lib/zod-resolver";
+import { Loader2 } from "lucide-react";
+import { useEffect, useMemo } from "react";
+import { useForm } from "react-hook-form";
+import { z } from "zod/v4";
+import { useInvoiceCreditNoteMutation } from "../index.js";
+function getCreditNoteFormSchema(messages) {
+    return z.object({
+        creditNoteNumber: z.string().min(1, messages.finance.creditNoteDialog.validationNumberRequired),
+        amountCents: z.coerce
+            .number()
+            .int()
+            .min(1, messages.finance.creditNoteDialog.validationAmountMin),
+        currency: z.string().min(3).max(3),
+        reason: z.string().min(1, messages.finance.creditNoteDialog.validationReasonRequired),
+        notes: z.string().optional().nullable(),
+    });
+}
+function generateCreditNoteNumber() {
+    const now = new Date();
+    const y = now.getFullYear();
+    const seq = String(Math.floor(Math.random() * 9000) + 1000);
+    return `CN-${y}-${seq}`;
+}
+export function CreditNoteDialog({ open, onOpenChange, invoiceId, invoiceCurrency, onSuccess, }) {
+    const messages = useOperatorAdminMessages();
+    const { create } = useInvoiceCreditNoteMutation(invoiceId);
+    const creditNoteFormSchema = useMemo(() => getCreditNoteFormSchema(messages), [messages]);
+    const form = useForm({
+        resolver: zodResolver(creditNoteFormSchema),
+        defaultValues: {
+            creditNoteNumber: "",
+            amountCents: 0,
+            currency: invoiceCurrency,
+            reason: "",
+            notes: "",
+        },
+    });
+    useEffect(() => {
+        if (open) {
+            form.reset({
+                creditNoteNumber: generateCreditNoteNumber(),
+                amountCents: 0,
+                currency: invoiceCurrency,
+                reason: "",
+                notes: "",
+            });
+        }
+    }, [open, invoiceCurrency, form]);
+    const onSubmit = async (values) => {
+        await create.mutateAsync({
+            creditNoteNumber: values.creditNoteNumber,
+            amountCents: values.amountCents,
+            currency: values.currency,
+            reason: values.reason,
+            notes: values.notes || null,
+        });
+        onOpenChange(false);
+        onSuccess?.();
+    };
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { children: [_jsx(DialogHeader, { children: _jsx(DialogTitle, { children: messages.finance.creditNoteDialog.title }) }), _jsxs("form", { onSubmit: form.handleSubmit(onSubmit), children: [_jsxs(DialogBody, { className: "grid gap-4", children: [_jsxs("div", { className: "grid grid-cols-2 gap-4", children: [_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Label, { children: messages.finance.creditNoteDialog.numberLabel }), _jsx(Input, { ...form.register("creditNoteNumber"), placeholder: messages.finance.creditNoteDialog.numberPlaceholder }), form.formState.errors.creditNoteNumber ? (_jsx("p", { className: "text-xs text-destructive", children: form.formState.errors.creditNoteNumber.message })) : null] }), _jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Label, { children: messages.finance.creditNoteDialog.currencyLabel }), _jsx(CurrencyCombobox, { value: form.watch("currency") || null, onChange: (next) => form.setValue("currency", next ?? "EUR", {
+                                                        shouldValidate: true,
+                                                        shouldDirty: true,
+                                                    }) })] })] }), _jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Label, { children: messages.finance.creditNoteDialog.amountLabel }), _jsx(Input, { ...form.register("amountCents"), type: "number", min: "1" }), form.formState.errors.amountCents ? (_jsx("p", { className: "text-xs text-destructive", children: form.formState.errors.amountCents.message })) : null] }), _jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Label, { children: messages.finance.creditNoteDialog.reasonLabel }), _jsx(Textarea, { ...form.register("reason"), placeholder: messages.finance.creditNoteDialog.reasonPlaceholder }), form.formState.errors.reason ? (_jsx("p", { className: "text-xs text-destructive", children: form.formState.errors.reason.message })) : null] }), _jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Label, { children: messages.finance.creditNoteDialog.notesLabel }), _jsx(Textarea, { ...form.register("notes"), placeholder: messages.finance.creditNoteDialog.notesPlaceholder })] })] }), _jsxs(DialogFooter, { children: [_jsx(Button, { type: "button", variant: "ghost", onClick: () => onOpenChange(false), children: messages.finance.creditNoteDialog.cancel }), _jsxs(Button, { type: "submit", disabled: create.isPending, children: [create.isPending ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : null, messages.finance.creditNoteDialog.submit] })] })] })] }) }));
+}

package/dist/admin/finance-shared.d.ts

@@ -0,0 +1,7 @@
+export type { CreditNoteRecord as CreditNoteRow, FinanceNoteRecord as FinanceNote, InvoiceRecord as InvoiceDetail, LineItemRecord as LineItem, PaymentRecord as PaymentRow, } from "../index.js";
+export declare const invoiceStatusVariant: Record<string, "default" | "secondary" | "outline" | "destructive">;
+export declare const paymentStatusVariant: Record<string, "default" | "secondary" | "outline" | "destructive">;
+export declare const creditNoteStatusVariant: Record<string, "default" | "secondary" | "outline" | "destructive">;
+export declare function formatAmount(cents: number, currency: string): string;
+export declare function formatMethod(method: string): string;
+//# sourceMappingURL=finance-shared.d.ts.map

package/dist/admin/finance-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finance-shared.d.ts","sourceRoot":"","sources":["../../src/admin/finance-shared.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,gBAAgB,IAAI,aAAa,EACjC,iBAAiB,IAAI,WAAW,EAChC,aAAa,IAAI,aAAa,EAC9B,cAAc,IAAI,QAAQ,EAC1B,aAAa,IAAI,UAAU,GAC5B,MAAM,aAAa,CAAA;AAEpB,eAAO,MAAM,oBAAoB,EAAE,MAAM,CACvC,MAAM,EACN,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,CASpD,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,MAAM,CACvC,MAAM,EACN,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,CAMpD,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAC1C,MAAM,EACN,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,CAKpD,CAAA;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/admin/finance-shared.js

@@ -0,0 +1,30 @@
+// Shared bits of the packaged finance admin pages: status → badge-variant
+// maps and the compact amount/method formatters the operator-grade detail
+// pages use. Kept admin-local — the canonical `InvoiceDetailPage` in
+// `../components` exports its own variants for the embeddable surface.
+export const invoiceStatusVariant = {
+    draft: "outline",
+    pending_external_allocation: "outline",
+    issued: "secondary",
+    partially_paid: "secondary",
+    paid: "default",
+    overdue: "destructive",
+    void: "destructive",
+};
+export const paymentStatusVariant = {
+    pending: "outline",
+    completed: "default",
+    failed: "destructive",
+    refunded: "secondary",
+};
+export const creditNoteStatusVariant = {
+    draft: "outline",
+    issued: "default",
+    applied: "secondary",
+};
+export function formatAmount(cents, currency) {
+    return `${(cents / 100).toFixed(2)} ${currency}`;
+}
+export function formatMethod(method) {
+    return method.replace(/_/g, " ");
+}

package/dist/admin/index.d.ts

@@ -0,0 +1,99 @@
+import { type AdminExtension } from "@voyant-travel/admin";
+/**
+ * Semantic destinations the finance admin surfaces navigate to
+ * (packaged-admin RFC §4.7). Keys shared with other domains
+ * (`invoice.detail`, `booking.detail`, `person.detail`,
+ * `organization.detail`, `payment.detail`) come from the bookings-ui
+ * augmentation bound above; declared here are the finance-owned list
+ * targets plus `supplier.detail`, re-declared shape-locked — also declared
+ * by `@voyant-travel/catalog-react/admin`, and interface merging requires the
+ * member shape to stay identical across packages.
+ */
+declare module "@voyant-travel/admin" {
+    interface AdminDestinations {
+        /** The invoices list page (the finance area's landing surface). */
+        "invoice.list": Record<string, never>;
+        /** The payments list page. */
+        "payment.list": Record<string, never>;
+        /** A supplier's detail page. */
+        "supplier.detail": {
+            supplierId: string;
+        };
+        /** The supplier-invoices (accounts payable) list page. */
+        "supplierInvoice.list": Record<string, never>;
+        /** A supplier invoice's detail page. */
+        "supplierInvoice.detail": {
+            supplierInvoiceId: string;
+        };
+    }
+}
+export type { BookingInvoicesWidgetProps } from "./booking-invoices-widget.js";
+export type { BookingPaymentPolicyWidgetProps } from "./booking-payment-policy-widget.js";
+export type { BookingPendingPaymentSessionsWidgetProps } from "./booking-pending-payment-sessions-widget.js";
+export type { CreditNoteDialogProps } from "./credit-note-dialog.js";
+export type { InvoiceDetailHostProps } from "./invoice-detail-host.js";
+export { InvoiceDetailSkeleton } from "./invoice-detail-skeleton.js";
+export type { LineItemDialogProps } from "./line-item-dialog.js";
+export type { PaymentDetailHostProps } from "./payment-detail-host.js";
+export { PaymentDetailSkeleton } from "./payment-detail-skeleton.js";
+export type { PaymentDialogProps } from "./payment-dialog.js";
+export type { RecordPaymentDialogProps } from "./record-payment-dialog.js";
+export type { SupplierPaymentPolicyWidgetProps } from "./supplier-payment-policy-widget.js";
+export type { SupplierPicker } from "./use-supplier-picker.js";
+export interface CreateFinanceAdminExtensionOptions {
+    /** Mount path of the finance pages inside the admin workspace. Default `/finance`. */
+    basePath?: string;
+    /** Localized page titles. Defaults are the English operator nav labels. */
+    labels?: {
+        invoices?: string;
+        invoiceNumberSeries?: string;
+        payments?: string;
+        supplierInvoices?: string;
+        profitability?: string;
+    };
+}
+/**
+ * The finance admin contribution (packaged-admin RFC Phase 3,
+ * `@voyant-travel/<domain>-ui/admin` convention).
+ *
+ * NAVIGATION: deliberately none. The Finance nav group (invoices, number
+ * series, payments, supplier invoices, profitability) is part of the BASE
+ * operator navigation — see `createOperatorAdminNavigation` in
+ * `@voyant-travel/admin` — so contributing nav entries here would duplicate them.
+ * If the base nav ever drops the finance group, this extension is where the
+ * entries move.
+ *
+ * ROUTES: all eight contributions carry the FULL route implementation
+ * (packaged-admin RFC §4.8 endgame) — a lazy `page` module loader, a data
+ * loader fed by the host runtime (`baseUrl` + cookie-forwarding fetcher),
+ * `ssr: "data-only"`, and the pending skeleton where the operator route had
+ * one — so the host needs no per-route files for them. Pages stay
+ * code-split: this factory never references a page component statically;
+ * each `page:` dynamically imports its specific module (never a barrel), and
+ * param-taking pages read the matched `$id` off `AdminRoutePageProps` and
+ * bind it onto {@link InvoiceDetailHost} / {@link PaymentDetailHost}.
+ * Cross-route links resolve through the semantic destinations declared
+ * above. The supplier-invoices pages carry their previously app-owned wiring
+ * package-side now: attachment uploads post to the starter-level
+ * `/v1/uploads` route through the shared finance provider context (the
+ * `BookingInvoicesWidget` precedent), inline supplier creation rides the
+ * suppliers package's `useSupplierMutation`, and the allocation dialog's
+ * cross-domain target search composes the bookings / products /
+ * availability packages' query options through the same context client.
+ *
+ * WIDGETS: the cycle-resolution piece (RFC §4.7). The booking detail page
+ * needs the finance-owned invoices card, but this package peer-depends on
+ * `@voyant-travel/bookings-react/ui`, so the bookings host cannot import it. Instead
+ * this extension contributes {@link BookingInvoicesWidget} on the
+ * `booking.details.invoices-tab` slot the bookings host exposes; the host
+ * mounts its Invoices tab whenever a contribution targets that slot and
+ * hands the widget its typed slot context as props. The Finance tab's
+ * payment-links card ({@link BookingPendingPaymentSessionsWidget}) and
+ * payment-policy override card ({@link BookingPaymentPolicyWidget}) travel
+ * the same way on `booking.details.finance-start` / `…finance-end`. The
+ * same pattern resolves the finance-ui ↔ suppliers-ui cycle: the supplier detail page's
+ * customer-payment-policy card ships as {@link SupplierPaymentPolicyWidget}
+ * on the `supplier.details.payment-policy` slot the supplier host exposes.
+ */
+export declare function createFinanceAdminExtension(options?: CreateFinanceAdminExtensionOptions): AdminExtension;
+//# sourceMappingURL=index.d.ts.map

package/dist/admin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EAKpB,MAAM,sBAAsB,CAAA;AA0F7B;;;;;;;;;GASG;AACH,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,iBAAiB;QACzB,mEAAmE;QACnE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACrC,8BAA8B;QAC9B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QACrC,gCAAgC;QAChC,iBAAiB,EAAE;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE,CAAA;QACzC,0DAA0D;QAC1D,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAC7C,wCAAwC;QACxC,wBAAwB,EAAE;YAAE,iBAAiB,EAAE,MAAM,CAAA;SAAE,CAAA;KACxD;CACF;AAUD,YAAY,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAA;AAC9E,YAAY,EAAE,+BAA+B,EAAE,MAAM,oCAAoC,CAAA;AACzF,YAAY,EAAE,wCAAwC,EAAE,MAAM,8CAA8C,CAAA;AAC5G,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AACpE,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,YAAY,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AAC1E,YAAY,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAA;AAC3F,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE9D,MAAM,WAAW,kCAAkC;IACjD,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2EAA2E;IAC3E,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,mBAAmB,CAAC,EAAE,MAAM,CAAA;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,gBAAgB,CAAC,EAAE,MAAM,CAAA;QACzB,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB,CAAA;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,kCAAuC,GAC/C,cAAc,CAiNhB"}