@voyant-travel/plugin-smartbill 0.119.2

package/dist/invoice-ui-data.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+export const smartbillInvoiceExternalRefSchema = z.object({
+    id: z.string(),
+    invoiceId: z.string(),
+    provider: z.string(),
+    externalId: z.string().nullable(),
+    externalNumber: z.string().nullable(),
+    externalUrl: z.string().nullable(),
+    status: z.string().nullable(),
+    metadata: z.record(z.string(), z.unknown()).nullable(),
+    syncedAt: z.union([z.string(), z.date()]).nullable(),
+    syncError: z.string().nullable(),
+    createdAt: z.union([z.string(), z.date()]).nullable(),
+    updatedAt: z.union([z.string(), z.date()]).nullable(),
+});
+export const smartbillInvoiceExternalRefsResponseSchema = z.object({
+    data: z.array(smartbillInvoiceExternalRefSchema),
+});
+export function selectSmartbillInvoiceRef(refs) {
+    return refs.find((ref) => ref.provider === "smartbill") ?? null;
+}
+export function resolveSmartbillInvoiceReferenceParts(ref) {
+    const metadata = coerceMetadata(ref?.metadata);
+    return {
+        companyVatCode: readMetadataString(metadata, "companyVatCode", "vatCode"),
+        seriesName: readMetadataString(metadata, "seriesName", "series"),
+        number: readMetadataString(metadata, "number", "invoiceNumber") ??
+            ref?.externalNumber ??
+            ref?.externalId ??
+            null,
+        documentType: readMetadataString(metadata, "documentType"),
+    };
+}
+export function getSmartbillInvoiceDocumentLinks(ref) {
+    const metadata = coerceMetadata(ref?.metadata);
+    const candidates = [
+        { label: "SmartBill document", href: ref?.externalUrl },
+        { label: "SmartBill PDF", href: readMetadataString(metadata, "pdfUrl", "downloadUrl") },
+        { label: "SmartBill invoice", href: readMetadataString(metadata, "invoiceUrl", "documentUrl") },
+    ];
+    const seen = new Set();
+    return candidates.flatMap((candidate) => {
+        const href = candidate.href?.trim();
+        if (!href || seen.has(href))
+            return [];
+        seen.add(href);
+        return [{ label: candidate.label, href }];
+    });
+}
+function coerceMetadata(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function readMetadataString(metadata, ...keys) {
+    for (const key of keys) {
+        const value = metadata?.[key];
+        if (typeof value === "string" && value.trim())
+            return value.trim();
+    }
+    return null;
+}

package/dist/invoice-ui.d.ts

@@ -0,0 +1,438 @@
+import type { ReactNode } from "react";
+import { type SmartbillInvoiceExternalRef } from "./invoice-ui-data.js";
+export { getSmartbillInvoiceDocumentLinks, resolveSmartbillInvoiceReferenceParts, type SmartbillInvoiceDocumentLink, type SmartbillInvoiceExternalRef, type SmartbillInvoiceReferenceParts, selectSmartbillInvoiceRef, } from "./invoice-ui-data.js";
+export interface UseSmartbillInvoiceRefsOptions {
+    enabled?: boolean;
+}
+export interface SmartbillInvoiceAction {
+    label?: string;
+    pending?: boolean;
+    disabled?: boolean;
+    onClick: () => void | Promise<void>;
+}
+export interface SmartbillInvoicePanelProps {
+    invoiceId: string;
+    externalRef?: SmartbillInvoiceExternalRef | null;
+    title?: ReactNode;
+    className?: string;
+    hideWhenEmpty?: boolean;
+    sendAction?: SmartbillInvoiceAction;
+    retryAction?: SmartbillInvoiceAction;
+    convertProformaAction?: SmartbillInvoiceAction;
+    extraActions?: ReactNode;
+}
+export declare function useSmartbillInvoiceRefs(invoiceId: string | null | undefined, options?: UseSmartbillInvoiceRefsOptions): import("@tanstack/react-query").UseQueryResult<{
+    id: string;
+    invoiceId: string;
+    provider: string;
+    externalId: string | null;
+    externalNumber: string | null;
+    externalUrl: string | null;
+    status: string | null;
+    metadata: Record<string, unknown> | null;
+    syncedAt: string | Date | null;
+    syncError: string | null;
+    createdAt: string | Date | null;
+    updatedAt: string | Date | null;
+}[], Error>;
+export declare function useSmartbillInvoiceRef(invoiceId: string | null | undefined, options?: UseSmartbillInvoiceRefsOptions): {
+    data: {
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    } | null | undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<{
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    }[], Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<{
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    }[]>;
+} | {
+    data: {
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    } | null | undefined;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<{
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    }[], Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<{
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    }[]>;
+} | {
+    data: {
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    } | null | undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<{
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    }[], Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<{
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    }[]>;
+} | {
+    data: {
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    } | null | undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<{
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    }[], Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<{
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    }[]>;
+} | {
+    data: {
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    } | null | undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<{
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    }[], Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<{
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    }[]>;
+} | {
+    data: {
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    } | null | undefined;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<{
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    }[], Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+    promise: Promise<{
+        id: string;
+        invoiceId: string;
+        provider: string;
+        externalId: string | null;
+        externalNumber: string | null;
+        externalUrl: string | null;
+        status: string | null;
+        metadata: Record<string, unknown> | null;
+        syncedAt: string | Date | null;
+        syncError: string | null;
+        createdAt: string | Date | null;
+        updatedAt: string | Date | null;
+    }[]>;
+};
+export declare function SmartbillInvoicePanel({ invoiceId, externalRef, title, className, hideWhenEmpty, sendAction, retryAction, convertProformaAction, extraActions, }: SmartbillInvoicePanelProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function useSmartbillInvoiceSyncAction(invoiceId: string): SmartbillInvoiceAction;
+export declare function useSmartbillConvertProformaAction(invoiceId: string): SmartbillInvoiceAction;
+//# sourceMappingURL=invoice-ui.d.ts.map

package/dist/invoice-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-ui.d.ts","sourceRoot":"","sources":["../src/invoice-ui.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,EAGL,KAAK,2BAA2B,EAGjC,MAAM,sBAAsB,CAAA;AAI7B,OAAO,EACL,gCAAgC,EAChC,qCAAqC,EACrC,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,yBAAyB,GAC1B,MAAM,sBAAsB,CAAA;AAE7B,MAAM,WAAW,8BAA8B;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAA;IAChD,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,UAAU,CAAC,EAAE,sBAAsB,CAAA;IACnC,WAAW,CAAC,EAAE,sBAAsB,CAAA;IACpC,qBAAqB,CAAC,EAAE,sBAAsB,CAAA;IAC9C,YAAY,CAAC,EAAE,SAAS,CAAA;CACzB;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,GAAE,8BAAmC;;;;;;;;;;;;;YAiB7C;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,GAAE,8BAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO7C;AAED,wBAAgB,qBAAqB,CAAC,EACpC,SAAS,EACT,WAAW,EACX,KAAmB,EACnB,SAAS,EACT,aAAqB,EACrB,UAAU,EACV,WAAW,EACX,qBAAqB,EACrB,YAAY,GACb,EAAE,0BAA0B,kDAuG5B;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,CAuBvF;AAED,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,CAuB3F"}

package/dist/invoice-ui.js

@@ -0,0 +1,97 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { fetchWithValidation, useVoyantFinanceContext } from "@voyant-travel/finance-react";
+import { Badge, Button, buttonVariants, Card, CardAction, CardContent, CardHeader, CardTitle, } from "@voyant-travel/ui/components";
+import { cn } from "@voyant-travel/ui/lib/utils";
+import { ArrowRightLeft, ExternalLink, FileText, Loader2, RefreshCw, Send } from "lucide-react";
+import { z } from "zod";
+import { getSmartbillInvoiceDocumentLinks, resolveSmartbillInvoiceReferenceParts, selectSmartbillInvoiceRef, smartbillInvoiceExternalRefsResponseSchema, } from "./invoice-ui-data.js";
+const actionResponseSchema = z.object({ data: z.unknown().optional() });
+export { getSmartbillInvoiceDocumentLinks, resolveSmartbillInvoiceReferenceParts, selectSmartbillInvoiceRef, } from "./invoice-ui-data.js";
+export function useSmartbillInvoiceRefs(invoiceId, options = {}) {
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const { enabled = true } = options;
+    return useQuery({
+        queryKey: ["voyant", "smartbill", "invoice", invoiceId, "external-refs"],
+        queryFn: async () => {
+            const response = await fetchWithValidation(`/v1/finance/invoices/${encodeURIComponent(invoiceId ?? "")}/external-refs`, smartbillInvoiceExternalRefsResponseSchema, { baseUrl, fetcher });
+            return response.data.filter((ref) => ref.provider === "smartbill");
+        },
+        enabled: enabled && Boolean(invoiceId),
+    });
+}
+export function useSmartbillInvoiceRef(invoiceId, options = {}) {
+    const query = useSmartbillInvoiceRefs(invoiceId, options);
+    return {
+        ...query,
+        data: query.data ? selectSmartbillInvoiceRef(query.data) : undefined,
+    };
+}
+export function SmartbillInvoicePanel({ invoiceId, externalRef, title = "SmartBill", className, hideWhenEmpty = false, sendAction, retryAction, convertProformaAction, extraActions, }) {
+    const query = useSmartbillInvoiceRef(invoiceId, { enabled: externalRef === undefined });
+    const defaultSyncAction = useSmartbillInvoiceSyncAction(invoiceId);
+    const defaultConvertProformaAction = useSmartbillConvertProformaAction(invoiceId);
+    const ref = externalRef === undefined ? query.data : externalRef;
+    const isLoading = externalRef === undefined && query.isPending;
+    const isError = externalRef === undefined && query.isError;
+    if (hideWhenEmpty && !isLoading && !isError && !ref) {
+        return null;
+    }
+    const reference = resolveSmartbillInvoiceReferenceParts(ref);
+    const documentLinks = getSmartbillInvoiceDocumentLinks(ref);
+    const status = ref?.syncError ? "error" : (ref?.status ?? null);
+    const effectiveSendAction = sendAction ?? defaultSyncAction;
+    const effectiveRetryAction = retryAction ?? (ref ? defaultSyncAction : undefined);
+    const effectiveConvertProformaAction = convertProformaAction ?? defaultConvertProformaAction;
+    const canConvertProforma = reference.documentType === "proforma" && Boolean(effectiveConvertProformaAction);
+    return (_jsxs(Card, { "data-slot": "smartbill-invoice-panel", size: "sm", className: className, children: [_jsxs(CardHeader, { children: [_jsxs(CardTitle, { className: "flex min-w-0 items-center gap-2", children: [_jsx(FileText, { className: "size-4 text-muted-foreground", "aria-hidden": "true" }), _jsx("span", { className: "truncate", children: title })] }), _jsx(CardAction, { children: status ? (_jsx(Badge, { variant: status === "error" ? "destructive" : "outline", children: status })) : null })] }), _jsxs(CardContent, { className: "grid gap-4", children: [isLoading ? (_jsxs("div", { className: "flex items-center gap-2 text-muted-foreground text-sm", children: [_jsx(Loader2, { className: "size-4 animate-spin", "aria-hidden": "true" }), "Loading SmartBill state"] })) : isError ? (_jsx("p", { className: "text-destructive text-sm", children: "SmartBill state could not be loaded." })) : ref ? (_jsxs("div", { className: "grid gap-3 text-sm", children: [_jsxs("dl", { className: "grid gap-2 sm:grid-cols-2", children: [_jsx(SmartbillField, { label: "Series", children: reference.seriesName ?? "-" }), _jsx(SmartbillField, { label: "Number", children: reference.number ?? "-" }), _jsx(SmartbillField, { label: "Type", children: reference.documentType ?? "-" }), _jsx(SmartbillField, { label: "Synced", children: formatDateTime(ref.syncedAt) ?? "-" })] }), ref.syncError ? (_jsx("p", { className: "rounded-md border border-destructive/20 bg-destructive/5 p-2 text-destructive", children: ref.syncError })) : null, documentLinks.length > 0 ? (_jsx("div", { className: "flex flex-wrap gap-2", children: documentLinks.map((link) => (_jsxs("a", { href: link.href, target: "_blank", rel: "noreferrer", className: buttonVariants({ variant: "outline", size: "sm" }), children: [_jsx(ExternalLink, { className: "size-4", "aria-hidden": "true" }), link.label] }, link.href))) })) : null] })) : (_jsx("p", { className: "text-muted-foreground text-sm", children: "No SmartBill reference is linked yet." })), _jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [!ref && !isLoading && !isError ? (_jsx(SmartbillActionButton, { action: effectiveSendAction, icon: _jsx(Send, { className: "size-4" }), children: effectiveSendAction.label ?? "Send to SmartBill" })) : null, effectiveRetryAction ? (_jsx(SmartbillActionButton, { action: effectiveRetryAction, icon: _jsx(RefreshCw, { className: "size-4" }), children: effectiveRetryAction.label ?? "Retry sync" })) : null, canConvertProforma && effectiveConvertProformaAction ? (_jsx(SmartbillActionButton, { action: effectiveConvertProformaAction, icon: _jsx(ArrowRightLeft, { className: "size-4" }), children: effectiveConvertProformaAction.label ?? "Convert proforma" })) : null, extraActions] })] })] }));
+}
+export function useSmartbillInvoiceSyncAction(invoiceId) {
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const queryClient = useQueryClient();
+    const mutation = useMutation({
+        mutationFn: async () => fetchWithValidation(`/v1/admin/smartbill/invoices/${encodeURIComponent(invoiceId)}/sync`, actionResponseSchema, { baseUrl, fetcher }, { method: "POST" }),
+        onSuccess: async () => {
+            await queryClient.invalidateQueries({ queryKey: ["voyant"] });
+        },
+    });
+    return {
+        pending: mutation.isPending,
+        disabled: !invoiceId,
+        onClick: async () => {
+            await mutation.mutateAsync();
+        },
+    };
+}
+export function useSmartbillConvertProformaAction(invoiceId) {
+    const { baseUrl, fetcher } = useVoyantFinanceContext();
+    const queryClient = useQueryClient();
+    const mutation = useMutation({
+        mutationFn: async () => fetchWithValidation(`/v1/finance/invoices/${encodeURIComponent(invoiceId)}/convert-to-invoice`, actionResponseSchema, { baseUrl, fetcher }, { method: "POST", body: JSON.stringify({}) }),
+        onSuccess: async () => {
+            await queryClient.invalidateQueries({ queryKey: ["voyant"] });
+        },
+    });
+    return {
+        pending: mutation.isPending,
+        disabled: !invoiceId,
+        onClick: async () => {
+            await mutation.mutateAsync();
+        },
+    };
+}
+function SmartbillField({ label, children }) {
+    return (_jsxs("div", { className: "grid gap-1", children: [_jsx("dt", { className: "text-muted-foreground text-xs uppercase", children: label }), _jsx("dd", { className: "break-words font-medium", children: children })] }));
+}
+function SmartbillActionButton({ action, icon, children, }) {
+    return (_jsxs(Button, { type: "button", variant: "outline", size: "sm", disabled: action.disabled || action.pending, onClick: () => void action.onClick(), children: [_jsx("span", { className: cn(action.pending && "animate-spin"), children: action.pending ? _jsx(Loader2, { className: "size-4", "aria-hidden": "true" }) : icon }), children] }));
+}
+function formatDateTime(value) {
+    if (!value)
+        return null;
+    const date = value instanceof Date ? value : new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return null;
+    return new Intl.DateTimeFormat(undefined, { dateStyle: "medium", timeStyle: "short" }).format(date);
+}

package/dist/mapping.d.ts

@@ -0,0 +1,50 @@
+import type { SmartbillClient, SmartbillInvoiceBody, SmartbillProduct, VoyantInvoiceEvent } from "./types.js";
+export type SmartbillMaybePromise<T> = T | Promise<T>;
+export type SmartbillEventValue<T> = T | ((event: VoyantInvoiceEvent) => SmartbillMaybePromise<T>);
+/**
+ * Options for the default invoice mapper.
+ */
+export interface SmartbillMappingOptions {
+    /** Romanian company VAT code (e.g. `"RO12345678"`). */
+    companyVatCode: string;
+    /** SmartBill invoice series name (e.g. `"A"`), or an event-specific resolver. */
+    seriesName: SmartbillEventValue<string>;
+    /** Invoice language. Defaults to `"RO"`. */
+    language?: string;
+    /** Whether VAT is included in line item prices. Defaults to `true`. */
+    isTaxIncluded?: boolean;
+    /** SmartBill product unit name. Defaults to `"buc"`. */
+    measuringUnitName?: SmartbillEventValue<string | null | undefined>;
+    /** Whether to use Art. 311 special regime (margin scheme for travel). */
+    art311SpecialRegime?: boolean;
+    /** Text appended to mentions when Art. 311 special regime is enabled. */
+    art311SpecialRegimeText?: string;
+    /** SmartBill mentions override, or an event-specific resolver. Defaults to event.mentions. */
+    mentions?: SmartbillEventValue<string | null | undefined>;
+    /** SmartBill observations override, or an event-specific resolver. Defaults to event.observations. */
+    observations?: SmartbillEventValue<string | null | undefined>;
+}
+/**
+ * Extract the SmartBill client block from a Voyant invoice event.
+ * Falls back to SmartBill-parseable defaults for fields the API treats as required.
+ */
+export declare function mapClient(event: VoyantInvoiceEvent): SmartbillClient;
+/**
+ * Extract SmartBill product lines from a Voyant invoice event.
+ * Expects `event.lineItems` to be an array of objects with at minimum
+ * `description`/`name`, `quantity`, `unitPrice`, `currency`.
+ */
+export declare function mapLineItems(event: VoyantInvoiceEvent, options: Pick<SmartbillMappingOptions, "isTaxIncluded"> & {
+    measuringUnitName?: string;
+}): SmartbillProduct[];
+/**
+ * Map a full Voyant invoice event to a SmartBill invoice body.
+ */
+export declare function mapVoyantInvoiceToSmartbill(event: VoyantInvoiceEvent, options: SmartbillMappingOptions): SmartbillInvoiceBody;
+/**
+ * Async variant of the default mapper. Use this when mapping options include
+ * promise-returning callbacks such as `seriesName`, `mentions`, or
+ * `observations`.
+ */
+export declare function mapVoyantInvoiceToSmartbillAsync(event: VoyantInvoiceEvent, options: SmartbillMappingOptions): Promise<SmartbillInvoiceBody>;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAEnB,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAErD,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,kBAAkB,KAAK,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAA;AASlG;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAA;IACtB,iFAAiF;IACjF,UAAU,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAA;IACvC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uEAAuE;IACvE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;IAClE,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,yEAAyE;IACzE,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,mBAAmB,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;IACzD,sGAAsG;IACtG,YAAY,CAAC,EAAE,mBAAmB,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;CAC9D;AAgBD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,eAAe,CAkBpE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,eAAe,CAAC,GAAG;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,GACvF,gBAAgB,EAAE,CAqBpB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,uBAAuB,GAC/B,oBAAoB,CAEtB;AAED;;;;GAIG;AACH,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CAE/B"}