@voyantjs/bookings-ui 0.108.0 → 0.109.0

package/dist/admin/index.d.ts

@@ -0,0 +1,197 @@
+import { type AdminExtension } from "@voyantjs/admin";
+import { z } from "zod";
+import type { BookingDetailTabValue } from "../components/booking-detail-page.js";
+import type { BookingListFiltersState } from "../components/booking-list.js";
+/**
+ * Semantic destinations the bookings admin surfaces navigate to
+ * (packaged-admin RFC §4.7). The booking pages link into routes they do not
+ * own — the CRM person/organization pages, the product editor, the finance
+ * payment/invoice pages — so instead of importing a host route tree they
+ * resolve these keys through `useAdminHref`/`useAdminNavigate` from
+ * `@voyantjs/admin`. Hosts register one resolver per key
+ * (`satisfies AdminDestinationResolvers`).
+ *
+ * `booking.detail`/`booking.list`/`booking.create` are declared here even
+ * though bookings pages are their first consumers: other domains' packaged
+ * pages navigate TO bookings through the same keys.
+ */
+declare module "@voyantjs/admin" {
+    interface AdminDestinations {
+        /** The bookings list page. */
+        "booking.list": Record<string, never>;
+        /** A booking's detail page; `tab` deep-links a specific tab. */
+        "booking.detail": {
+            bookingId: string;
+            tab?: BookingDetailTabValue;
+        };
+        /** The "New booking" entry point (product picker → unified journey). */
+        "booking.create": Record<string, never>;
+        /** A CRM person's detail page. */
+        "person.detail": {
+            personId: string;
+        };
+        /** A CRM organization's detail page. */
+        "organization.detail": {
+            organizationId: string;
+        };
+        /**
+         * The owned-product editor/detail page. Also declared by
+         * `@voyantjs/catalog-ui/admin` — interface merging requires the member
+         * shape to stay identical across packages.
+         */
+        "product.detail": {
+            productId: string;
+        };
+        /** An availability slot's detail page. */
+        "availabilitySlot.detail": {
+            slotId: string;
+        };
+        /** A payment's detail page in the finance area. */
+        "payment.detail": {
+            paymentId: string;
+        };
+        /** An invoice's full detail page in the finance area. */
+        "invoice.detail": {
+            invoiceId: string;
+        };
+        /**
+         * A legal contract's detail page. Also declared by
+         * `@voyantjs/legal-ui/admin` — interface merging requires the member
+         * shape to stay identical across packages. Declared here because the
+         * booking Documents tab links contract rows to their detail page.
+         */
+        "contract.detail": {
+            contractId: string;
+        };
+    }
+}
+export { BookingContractDialog, type BookingContractDialogProps, } from "./booking-contract-dialog.js";
+export { BookingDetailHost, type BookingDetailHostProps, type BookingDetailHostSlot, type BookingDetailHostSlotContext, type BookingDetailHostSlots, bookingDetailFinanceEndSlot, bookingDetailFinanceStartSlot, bookingDetailInvoicesTabSlot, } from "./booking-detail-host.js";
+export { BookingDetailSkeleton } from "./booking-detail-skeleton.js";
+export { BookingDocumentsTable, type BookingDocumentsTableProps, } from "./booking-documents-table.js";
+export { BookingInvoiceSheet, type BookingInvoiceSheetProps, } from "./booking-invoice-sheet.js";
+export { BookingsHost, type BookingsHostProps } from "./bookings-host.js";
+export { BookingsListSkeleton } from "./bookings-list-skeleton.js";
+export { PersonBookingsWidget, type PersonBookingsWidgetProps, } from "./person-bookings-widget.js";
+export { useBookingActionLedgerEvents } from "./use-booking-action-ledger-events.js";
+/**
+ * Search contract for the bookings list page: the URL projection of
+ * `BookingListFiltersState` (filters, sort, paging). Package-owned so the
+ * route file, the host, and the extension contribution validate the same
+ * shape. Defaults are absent from the URL — see
+ * {@link bookingsFiltersToSearch}.
+ */
+export declare const bookingsIndexSearchSchema: z.ZodObject<{
+    search: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    productId: z.ZodOptional<z.ZodString>;
+    optionId: z.ZodOptional<z.ZodString>;
+    supplierId: z.ZodOptional<z.ZodString>;
+    productCategoryId: z.ZodOptional<z.ZodString>;
+    personId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+    availabilitySlotId: z.ZodOptional<z.ZodString>;
+    dateFrom: z.ZodOptional<z.ZodString>;
+    dateTo: z.ZodOptional<z.ZodString>;
+    paxMin: z.ZodOptional<z.ZodString>;
+    paxMax: z.ZodOptional<z.ZodString>;
+    sortBy: z.ZodOptional<z.ZodEnum<{
+        createdAt: "createdAt";
+        bookingNumber: "bookingNumber";
+        status: "status";
+        sellAmount: "sellAmount";
+        pax: "pax";
+        startDate: "startDate";
+        endDate: "endDate";
+    }>>;
+    sortDir: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    offset: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type BookingsIndexSearchParams = z.infer<typeof bookingsIndexSearchSchema>;
+/** URL search params → `BookingList` initial state. Empty / `"all"` /
+ * default values are absent in the URL; we let `BookingList`'s defaults
+ * fill them in. */
+export declare function bookingsSearchToFilters(search: BookingsIndexSearchParams): Partial<BookingListFiltersState>;
+/** Project the filter snapshot back into URL search params, dropping
+ * any value that matches the component's default so the URL stays
+ * clean when the operator is viewing the unfiltered list. */
+export declare function bookingsFiltersToSearch(filters: BookingListFiltersState): BookingsIndexSearchParams;
+/** Tab values of the canonical `BookingDetailPage`, as a search-param schema. */
+export declare const bookingDetailTabSchema: z.ZodEnum<{
+    activity: "activity";
+    metadata: "metadata";
+    items: "items";
+    travelers: "travelers";
+    documents: "documents";
+    suppliers: "suppliers";
+    invoices: "invoices";
+    finance: "finance";
+}>;
+/**
+ * Search contract for the booking detail page. `productId`/`slotId` only
+ * matter for the `"new"` pseudo-id: a deep link with a product pre-chosen
+ * redirects into the unified booking journey (host route concern).
+ */
+export declare const bookingDetailSearchSchema: z.ZodObject<{
+    productId: z.ZodOptional<z.ZodString>;
+    slotId: z.ZodOptional<z.ZodString>;
+    tab: z.ZodOptional<z.ZodEnum<{
+        activity: "activity";
+        metadata: "metadata";
+        items: "items";
+        travelers: "travelers";
+        documents: "documents";
+        suppliers: "suppliers";
+        invoices: "invoices";
+        finance: "finance";
+    }>>;
+}, z.core.$strip>;
+export type BookingDetailSearchParams = z.infer<typeof bookingDetailSearchSchema>;
+export interface CreateBookingsAdminExtensionOptions {
+    /** Mount path of the bookings pages inside the admin workspace. Default `/bookings`. */
+    basePath?: string;
+    /** Localized page titles. Defaults are the English operator nav labels. */
+    labels?: {
+        bookings?: string;
+    };
+}
+/**
+ * The bookings admin contribution (packaged-admin RFC Phase 3,
+ * `@voyantjs/<domain>-ui/admin` convention).
+ *
+ * NAVIGATION: deliberately none. The Bookings nav item is part of the BASE
+ * operator navigation — see `createOperatorAdminNavigation` in
+ * `@voyantjs/admin` — so contributing nav entries here would duplicate it.
+ * If the base nav ever drops the bookings item, this extension is where the
+ * entry moves.
+ *
+ * ROUTES: contributions are metadata + the package-owned search contracts
+ * ({@link bookingsIndexSearchSchema} for the list,
+ * {@link bookingDetailSearchSchema} for the detail page). The PAGES are
+ * package-owned too: {@link BookingsHost} and {@link BookingDetailHost}
+ * bind the canonical bookings pages to their data wiring (bookings/finance
+ * provider context) and resolve every cross-route link through the semantic
+ * destinations declared above — no app RPC client, no host route tree.
+ *
+ * `component:` is intentionally NOT attached to these contributions yet:
+ * the contribution contract renders zero-prop pages (route components read
+ * params via the router, per RFC §4.2), while both bookings hosts take
+ * route params/search state as props. Host route files stay the thin
+ * binding layer (`Route.useParams()`/`Route.useSearch()` → host props)
+ * until the §4.2 code-based route assembly gives packaged pages a
+ * router-agnostic way to read route state.
+ *
+ * WIDGETS: the crm-ui ↔ bookings-ui cycle resolution (RFC §4.7). The CRM
+ * person detail page mounts a Bookings tab, but this package depends on
+ * `@voyantjs/crm-ui`, so crm-ui's host cannot import the bookings-owned
+ * card. Instead this extension contributes {@link PersonBookingsWidget} on
+ * the `person.details.bookings-tab` slot crm-ui's `PersonDetailHost`
+ * exposes; the host mounts its Bookings tab whenever a contribution targets
+ * that slot and hands the widget its typed slot context
+ * (`PersonDetailBookingsTabContext`) as props.
+ */
+export declare function createBookingsAdminExtension(options?: CreateBookingsAdminExtensionOptions): 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":"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"}

package/dist/admin/index.js

@@ -0,0 +1,187 @@
+import { defineAdminExtension, } from "@voyantjs/admin";
+// Importing the slot id also binds the crm-ui `AdminDestinations`
+// augmentation (`person.list`, `organization.list`, ...) into this program;
+// this package already peer-depends on `@voyantjs/crm-ui`.
+import { personDetailBookingsTabSlot } from "@voyantjs/crm-ui/admin";
+import { z } from "zod";
+import { PersonBookingsWidget } from "./person-bookings-widget.js";
+// Packaged admin hosts (packaged-admin RFC Phase 3): the bookings pages
+// bound to their data wiring + semantic-destination navigation. Host route
+// files only bind route params/search state onto these.
+export { BookingContractDialog, } from "./booking-contract-dialog.js";
+export { BookingDetailHost, bookingDetailFinanceEndSlot, bookingDetailFinanceStartSlot, bookingDetailInvoicesTabSlot, } from "./booking-detail-host.js";
+export { BookingDetailSkeleton } from "./booking-detail-skeleton.js";
+export { BookingDocumentsTable, } from "./booking-documents-table.js";
+export { BookingInvoiceSheet, } from "./booking-invoice-sheet.js";
+export { BookingsHost } from "./bookings-host.js";
+export { BookingsListSkeleton } from "./bookings-list-skeleton.js";
+export { PersonBookingsWidget, } from "./person-bookings-widget.js";
+export { useBookingActionLedgerEvents } from "./use-booking-action-ledger-events.js";
+const bookingsListSortBySchema = z.enum([
+    "bookingNumber",
+    "status",
+    "sellAmount",
+    "pax",
+    "startDate",
+    "endDate",
+    "createdAt",
+]);
+const bookingsListSortDirSchema = z.enum(["asc", "desc"]);
+/**
+ * Search contract for the bookings list page: the URL projection of
+ * `BookingListFiltersState` (filters, sort, paging). Package-owned so the
+ * route file, the host, and the extension contribution validate the same
+ * shape. Defaults are absent from the URL — see
+ * {@link bookingsFiltersToSearch}.
+ */
+export const bookingsIndexSearchSchema = z.object({
+    search: z.string().optional(),
+    status: z.string().optional(),
+    productId: z.string().optional(),
+    optionId: z.string().optional(),
+    supplierId: z.string().optional(),
+    productCategoryId: z.string().optional(),
+    personId: z.string().optional(),
+    organizationId: z.string().optional(),
+    availabilitySlotId: z.string().optional(),
+    dateFrom: z.string().optional(),
+    dateTo: z.string().optional(),
+    paxMin: z.string().optional(),
+    paxMax: z.string().optional(),
+    sortBy: bookingsListSortBySchema.optional(),
+    sortDir: bookingsListSortDirSchema.optional(),
+    offset: z.coerce.number().int().min(0).optional(),
+});
+/** URL search params → `BookingList` initial state. Empty / `"all"` /
+ * default values are absent in the URL; we let `BookingList`'s defaults
+ * fill them in. */
+export function bookingsSearchToFilters(search) {
+    return {
+        search: search.search,
+        status: search.status,
+        productId: search.productId ?? null,
+        optionId: search.optionId ?? null,
+        supplierId: search.supplierId ?? null,
+        productCategoryId: search.productCategoryId ?? null,
+        personId: search.personId ?? null,
+        organizationId: search.organizationId ?? null,
+        availabilitySlotId: search.availabilitySlotId ?? null,
+        dateFrom: search.dateFrom ?? null,
+        dateTo: search.dateTo ?? null,
+        paxMin: search.paxMin,
+        paxMax: search.paxMax,
+        sortBy: search.sortBy,
+        sortDir: search.sortDir,
+        offset: search.offset,
+    };
+}
+/** Project the filter snapshot back into URL search params, dropping
+ * any value that matches the component's default so the URL stays
+ * clean when the operator is viewing the unfiltered list. */
+export function bookingsFiltersToSearch(filters) {
+    return {
+        search: filters.search || undefined,
+        status: filters.status === "all" ? undefined : filters.status,
+        productId: filters.productId ?? undefined,
+        optionId: filters.optionId ?? undefined,
+        supplierId: filters.supplierId ?? undefined,
+        productCategoryId: filters.productCategoryId ?? undefined,
+        personId: filters.personId ?? undefined,
+        organizationId: filters.organizationId ?? undefined,
+        availabilitySlotId: filters.availabilitySlotId ?? undefined,
+        dateFrom: filters.dateFrom ?? undefined,
+        dateTo: filters.dateTo ?? undefined,
+        paxMin: filters.paxMin || undefined,
+        paxMax: filters.paxMax || undefined,
+        sortBy: filters.sortBy === "createdAt" ? undefined : filters.sortBy,
+        sortDir: filters.sortDir === "desc" ? undefined : filters.sortDir,
+        offset: filters.offset === 0 ? undefined : filters.offset,
+    };
+}
+/** Tab values of the canonical `BookingDetailPage`, as a search-param schema. */
+export const bookingDetailTabSchema = z.enum([
+    "items",
+    "travelers",
+    "finance",
+    "invoices",
+    "documents",
+    "suppliers",
+    "activity",
+    "metadata",
+]);
+/**
+ * Search contract for the booking detail page. `productId`/`slotId` only
+ * matter for the `"new"` pseudo-id: a deep link with a product pre-chosen
+ * redirects into the unified booking journey (host route concern).
+ */
+export const bookingDetailSearchSchema = z.object({
+    productId: z.string().optional(),
+    slotId: z.string().optional(),
+    tab: bookingDetailTabSchema.optional(),
+});
+/**
+ * The bookings admin contribution (packaged-admin RFC Phase 3,
+ * `@voyantjs/<domain>-ui/admin` convention).
+ *
+ * NAVIGATION: deliberately none. The Bookings nav item is part of the BASE
+ * operator navigation — see `createOperatorAdminNavigation` in
+ * `@voyantjs/admin` — so contributing nav entries here would duplicate it.
+ * If the base nav ever drops the bookings item, this extension is where the
+ * entry moves.
+ *
+ * ROUTES: contributions are metadata + the package-owned search contracts
+ * ({@link bookingsIndexSearchSchema} for the list,
+ * {@link bookingDetailSearchSchema} for the detail page). The PAGES are
+ * package-owned too: {@link BookingsHost} and {@link BookingDetailHost}
+ * bind the canonical bookings pages to their data wiring (bookings/finance
+ * provider context) and resolve every cross-route link through the semantic
+ * destinations declared above — no app RPC client, no host route tree.
+ *
+ * `component:` is intentionally NOT attached to these contributions yet:
+ * the contribution contract renders zero-prop pages (route components read
+ * params via the router, per RFC §4.2), while both bookings hosts take
+ * route params/search state as props. Host route files stay the thin
+ * binding layer (`Route.useParams()`/`Route.useSearch()` → host props)
+ * until the §4.2 code-based route assembly gives packaged pages a
+ * router-agnostic way to read route state.
+ *
+ * WIDGETS: the crm-ui ↔ bookings-ui cycle resolution (RFC §4.7). The CRM
+ * person detail page mounts a Bookings tab, but this package depends on
+ * `@voyantjs/crm-ui`, so crm-ui's host cannot import the bookings-owned
+ * card. Instead this extension contributes {@link PersonBookingsWidget} on
+ * the `person.details.bookings-tab` slot crm-ui's `PersonDetailHost`
+ * exposes; the host mounts its Bookings tab whenever a contribution targets
+ * that slot and hands the widget its typed slot context
+ * (`PersonDetailBookingsTabContext`) as props.
+ */
+export function createBookingsAdminExtension(options = {}) {
+    const { basePath = "/bookings", labels = {} } = options;
+    const { bookings = "Bookings" } = labels;
+    return defineAdminExtension({
+        id: "bookings",
+        routes: [
+            {
+                id: "bookings-index",
+                path: basePath,
+                title: bookings,
+                validateSearch: (search) => bookingsIndexSearchSchema.parse(search),
+            },
+            {
+                id: "bookings-detail",
+                path: `${basePath}/$id`,
+                title: bookings,
+                validateSearch: (search) => bookingDetailSearchSchema.parse(search),
+            },
+        ],
+        widgets: [
+            {
+                id: "bookings-person-bookings",
+                slot: personDetailBookingsTabSlot,
+                // The widget registry is untyped (`Record<string, unknown>` props);
+                // the typed contract is `PersonDetailBookingsTabContext`, which
+                // crm-ui's person detail host passes verbatim to this slot's widgets.
+                component: PersonBookingsWidget,
+            },
+        ],
+    });
+}

package/dist/admin/person-bookings-widget.d.ts

@@ -0,0 +1,13 @@
+import type { PersonDetailBookingsTabContext } from "@voyantjs/crm-ui/admin";
+export type PersonBookingsWidgetProps = PersonDetailBookingsTabContext;
+/**
+ * The person detail page's Bookings tab, contributed as a widget on
+ * crm-ui's `person.details.bookings-tab` slot (packaged-admin RFC §4.7
+ * cycle resolution): this package depends on `@voyantjs/crm-ui`, so the
+ * person detail host cannot import this card — the contribution travels
+ * the widget seam instead. Receives the slot's typed context
+ * (`PersonDetailBookingsTabContext`) as props and opens rows through the
+ * semantic `booking.detail` destination.
+ */
+export declare function PersonBookingsWidget({ personId }: PersonBookingsWidgetProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=person-bookings-widget.d.ts.map

package/dist/admin/person-bookings-widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"person-bookings-widget.d.ts","sourceRoot":"","sources":["../../src/admin/person-bookings-widget.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAA;AAY5E,MAAM,MAAM,yBAAyB,GAAG,8BAA8B,CAAA;AAEtE;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,EAAE,yBAAyB,2CAmF3E"}

package/dist/admin/person-bookings-widget.js

@@ -0,0 +1,48 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useAdminNavigate, useOperatorAdminMessages } from "@voyantjs/admin";
+import { bookingStatusBadgeVariant, useBookings } from "@voyantjs/bookings-react";
+import { Badge } from "@voyantjs/ui/components/badge";
+import { Skeleton } from "@voyantjs/ui/components/skeleton";
+import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow, } from "@voyantjs/ui/components/table";
+/**
+ * The person detail page's Bookings tab, contributed as a widget on
+ * crm-ui's `person.details.bookings-tab` slot (packaged-admin RFC §4.7
+ * cycle resolution): this package depends on `@voyantjs/crm-ui`, so the
+ * person detail host cannot import this card — the contribution travels
+ * the widget seam instead. Receives the slot's typed context
+ * (`PersonDetailBookingsTabContext`) as props and opens rows through the
+ * semantic `booking.detail` destination.
+ */
+export function PersonBookingsWidget({ personId }) {
+    const adminMessages = useOperatorAdminMessages();
+    const messages = adminMessages.bookings.list;
+    const navigateTo = useAdminNavigate();
+    const bookingsQuery = useBookings({ personId, limit: 50 });
+    const bookings = bookingsQuery.data?.data ?? [];
+    if (bookingsQuery.isPending) {
+        return (_jsxs("div", { className: "space-y-2 p-4", children: [_jsx(Skeleton, { className: "h-10 w-full" }), _jsx(Skeleton, { className: "h-10 w-full" }), _jsx(Skeleton, { className: "h-10 w-full" })] }));
+    }
+    if (bookingsQuery.isError) {
+        return (_jsx("div", { className: "p-6 text-center text-destructive text-sm", children: adminMessages.crm.personDetail.notFound }));
+    }
+    if (bookings.length === 0) {
+        return (_jsx("div", { className: "p-6 text-center text-muted-foreground text-sm", children: messages.relatedEmpty }));
+    }
+    return (_jsx("div", { className: "rounded-md border", children: _jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: messages.tableBookingNumber }), _jsx(TableHead, { children: messages.tableItems }), _jsx(TableHead, { children: messages.tableStatus }), _jsx(TableHead, { children: messages.tableSellAmount }), _jsx(TableHead, { children: messages.tablePax }), _jsx(TableHead, { children: messages.tableStartDate })] }) }), _jsx(TableBody, { children: bookings.map((booking) => {
+                        const firstItem = booking.items?.[0];
+                        const itemLabel = firstItem?.productName ?? firstItem?.title ?? "—";
+                        const extraItems = Math.max((booking.items?.length ?? 0) - 1, 0);
+                        return (_jsxs(TableRow, { onClick: () => navigateTo("booking.detail", { bookingId: booking.id }), className: "cursor-pointer", children: [_jsx(TableCell, { className: "font-medium", children: booking.bookingNumber }), _jsx(TableCell, { children: _jsxs("div", { className: "max-w-[280px] truncate", title: itemLabel, children: [itemLabel, extraItems > 0 ? (_jsxs("span", { className: "ml-1 text-muted-foreground text-xs", children: ["+", extraItems] })) : null] }) }), _jsx(TableCell, { children: _jsx(Badge, { variant: bookingStatusBadgeVariant[booking.status], children: booking.status }) }), _jsx(TableCell, { children: booking.sellAmountCents == null
+                                        ? "—"
+                                        : `${(booking.sellAmountCents / 100).toFixed(2)} ${booking.sellCurrency}` }), _jsx(TableCell, { children: booking.pax ?? "—" }), _jsx(TableCell, { children: formatBookingDate(booking.startsAt ?? booking.startDate) })] }, booking.id));
+                    }) })] }) }));
+}
+function formatBookingDate(value) {
+    if (!value)
+        return "—";
+    const date = new Date(/^\d{4}-\d{2}-\d{2}$/.test(value) ? `${value}T00:00:00` : value);
+    if (Number.isNaN(date.getTime()))
+        return "—";
+    return date.toLocaleDateString();
+}

package/dist/admin/use-booking-action-ledger-events.d.ts

@@ -0,0 +1,15 @@
+import type { TimelineEvent } from "../components/booking-activity-timeline.js";
+/**
+ * Fetch the booking's central action-ledger entries and map them into
+ * `TimelineEvent`s so they can be merged into `BookingActivityTimeline`.
+ * Replaces the standalone Ledger tab — operators see one chronological
+ * activity feed instead of two sibling tabs.
+ *
+ * Returns a "Load more" `footer` element when the cursor pager hasn't
+ * exhausted yet so the timeline can render it below the event list.
+ */
+export declare function useBookingActionLedgerEvents(bookingId: string): {
+    events: TimelineEvent[];
+    footer: React.ReactNode | null;
+};
+//# sourceMappingURL=use-booking-action-ledger-events.d.ts.map

package/dist/admin/use-booking-action-ledger-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-booking-action-ledger-events.d.ts","sourceRoot":"","sources":["../../src/admin/use-booking-action-ledger-events.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAA;AAE/E;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG;IAC/D,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,MAAM,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAA;CAC/B,CAgDA"}

package/dist/admin/use-booking-action-ledger-events.js

@@ -0,0 +1,66 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useOperatorAdminMessages } from "@voyantjs/admin";
+import { useBookingActionLedger, } from "@voyantjs/bookings-react";
+import { Button } from "@voyantjs/ui/components/button";
+import { ScrollText } from "lucide-react";
+import { useMemo } from "react";
+/**
+ * Fetch the booking's central action-ledger entries and map them into
+ * `TimelineEvent`s so they can be merged into `BookingActivityTimeline`.
+ * Replaces the standalone Ledger tab — operators see one chronological
+ * activity feed instead of two sibling tabs.
+ *
+ * Returns a "Load more" `footer` element when the cursor pager hasn't
+ * exhausted yet so the timeline can render it below the event list.
+ */
+export function useBookingActionLedgerEvents(bookingId) {
+    const t = useOperatorAdminMessages().bookings.detail.actionLedger;
+    const ledgerQuery = useBookingActionLedger(bookingId);
+    const pages = useMemo(() => ledgerQuery.data?.pages ?? [], [ledgerQuery.data]);
+    const travelers = pages[0]?.travelers ?? [];
+    const travelersById = useMemo(() => new Map(travelers.map((traveler) => [traveler.id, traveler])), [travelers]);
+    const events = useMemo(() => {
+        const all = [];
+        for (const page of pages) {
+            for (const entry of page.data) {
+                const traveler = travelersById.get(entry.targetId) ?? null;
+                all.push({
+                    id: `action:${entry.id}`,
+                    source: "action",
+                    title: formatActionName(entry.actionName),
+                    description: formatLedgerDescription(entry, traveler, t.travelerFallback, t.targetBooking),
+                    actorId: entry.principalId,
+                    timestamp: entry.occurredAt,
+                    icon: ScrollText,
+                });
+            }
+        }
+        return all;
+    }, [pages, travelersById, t.targetBooking, t.travelerFallback]);
+    const footer = ledgerQuery.hasNextPage ? (_jsx(Button, { type: "button", variant: "outline", size: "sm", disabled: ledgerQuery.isFetchingNextPage, onClick: () => void ledgerQuery.fetchNextPage(), children: ledgerQuery.isFetchingNextPage ? t.loadingMore : t.loadMore })) : null;
+    return { events, footer };
+}
+function formatActionName(value) {
+    return value.replaceAll(".", " / ").replaceAll("_", " ");
+}
+function formatTarget(entry, traveler, travelerFallback, bookingFallback) {
+    if (traveler) {
+        return [traveler.firstName, traveler.lastName].filter(Boolean).join(" ") || travelerFallback;
+    }
+    if (entry.targetType === "booking")
+        return bookingFallback;
+    return entry.targetType.replaceAll("_", " ");
+}
+function formatLedgerDescription(entry, traveler, travelerFallback, bookingFallback) {
+    // status / target / risk are machine-readable enum strings the
+    // ledger ships unmodified (matches the standalone panel behaviour).
+    const parts = [
+        entry.status,
+        formatTarget(entry, traveler, travelerFallback, bookingFallback),
+        entry.evaluatedRisk,
+    ];
+    if (entry.routeOrToolName)
+        parts.push(entry.routeOrToolName);
+    return parts.join(" · ");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/bookings-ui",
-  "version": "0.108.0",
+  "version": "0.109.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -38,6 +38,11 @@
       "import": "./dist/journey/index.js",
       "default": "./dist/journey/index.js"
     },
+    "./admin": {
+      "types": "./dist/admin/index.d.ts",
+      "import": "./dist/admin/index.js",
+      "default": "./dist/admin/index.js"
+    },
     "./components/*": {
       "types": "./dist/components/*.d.ts",
       "import": "./dist/components/*.js",
@@ -52,21 +57,22 @@
     "react-dom": "^19.0.0",
     "react-hook-form": "^7.60.0",
     "zod": "^4.3.6",
-    "@voyantjs/availability-react": "^0.105.2",
-    "@voyantjs/bookings": "^0.108.0",
-    "@voyantjs/bookings-react": "^0.108.0",
-    "@voyantjs/catalog": "^0.106.0",
-    "@voyantjs/catalog-react": "^0.106.0",
-    "@voyantjs/crm-react": "^0.108.0",
-    "@voyantjs/crm-ui": "^0.108.0",
-    "@voyantjs/extras-react": "^0.108.0",
-    "@voyantjs/finance-react": "^0.108.0",
-    "@voyantjs/identity-react": "^0.108.0",
-    "@voyantjs/legal-react": "^0.108.0",
-    "@voyantjs/pricing-react": "^0.108.0",
-    "@voyantjs/products-react": "^0.108.0",
-    "@voyantjs/suppliers-react": "^0.105.2",
-    "@voyantjs/ui": "^0.105.1"
+    "@voyantjs/admin": "^0.106.0",
+    "@voyantjs/availability-react": "^0.106.0",
+    "@voyantjs/bookings": "^0.109.0",
+    "@voyantjs/bookings-react": "^0.109.0",
+    "@voyantjs/catalog": "^0.107.0",
+    "@voyantjs/catalog-react": "^0.107.0",
+    "@voyantjs/crm-react": "^0.109.0",
+    "@voyantjs/crm-ui": "^0.109.0",
+    "@voyantjs/extras-react": "^0.109.0",
+    "@voyantjs/finance-react": "^0.109.0",
+    "@voyantjs/identity-react": "^0.109.0",
+    "@voyantjs/legal-react": "^0.109.0",
+    "@voyantjs/pricing-react": "^0.109.0",
+    "@voyantjs/products-react": "^0.109.0",
+    "@voyantjs/suppliers-react": "^0.106.0",
+    "@voyantjs/ui": "^0.106.0"
   },
   "dependencies": {
     "sonner": "^2.0.7",
@@ -85,21 +91,22 @@
     "typescript": "^6.0.2",
     "vitest": "^4.1.2",
     "zod": "^4.3.6",
-    "@voyantjs/availability-react": "^0.105.2",
-    "@voyantjs/bookings": "^0.108.0",
-    "@voyantjs/bookings-react": "^0.108.0",
-    "@voyantjs/catalog": "^0.106.0",
-    "@voyantjs/catalog-react": "^0.106.0",
-    "@voyantjs/crm-react": "^0.108.0",
-    "@voyantjs/crm-ui": "^0.108.0",
-    "@voyantjs/extras-react": "^0.108.0",
-    "@voyantjs/finance-react": "^0.108.0",
-    "@voyantjs/identity-react": "^0.108.0",
-    "@voyantjs/legal-react": "^0.108.0",
-    "@voyantjs/pricing-react": "^0.108.0",
-    "@voyantjs/products-react": "^0.108.0",
-    "@voyantjs/suppliers-react": "^0.105.2",
-    "@voyantjs/ui": "^0.105.1",
+    "@voyantjs/admin": "^0.106.0",
+    "@voyantjs/availability-react": "^0.106.0",
+    "@voyantjs/bookings": "^0.109.0",
+    "@voyantjs/bookings-react": "^0.109.0",
+    "@voyantjs/catalog": "^0.107.0",
+    "@voyantjs/catalog-react": "^0.107.0",
+    "@voyantjs/crm-react": "^0.109.0",
+    "@voyantjs/crm-ui": "^0.109.0",
+    "@voyantjs/finance-react": "^0.109.0",
+    "@voyantjs/identity-react": "^0.109.0",
+    "@voyantjs/legal-react": "^0.109.0",
+    "@voyantjs/pricing-react": "^0.109.0",
+    "@voyantjs/products-react": "^0.109.0",
+    "@voyantjs/suppliers-react": "^0.106.0",
+    "@voyantjs/extras-react": "^0.109.0",
+    "@voyantjs/ui": "^0.106.0",
     "@voyantjs/voyant-typescript-config": "^0.1.0"
   },
   "files": [