@hub-kit/core 0.3.0

package/dist/pages/file-naming/file-naming-page.js

@@ -0,0 +1,120 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from "react";
+import { toast } from "sonner";
+import { Button } from "../../ui/button.js";
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "../../ui/card.js";
+import { Input } from "../../ui/input.js";
+import { Label } from "../../ui/label.js";
+import { Skeleton } from "../../ui/skeleton.js";
+import { Switch } from "../../ui/switch.js";
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue, } from "../../ui/select.js";
+import { ErrorState, readableErrorMessage } from "../../components/feedback/query-states.js";
+import { englishFormatters } from "../../lib/formatters.js";
+import { buildSuggestedFilename, UNSAFE_FILENAME_CHARS } from "./build-filename.js";
+import { englishFileNamingLabels } from "./labels.js";
+const DESCRIPTION_SOURCES = [
+    "service_description",
+    "cost_category",
+    "none",
+];
+export function FileNamingPage({ adapter, canEdit, labels = englishFileNamingLabels, formatters = englishFormatters, }) {
+    const settingsQuery = adapter.useSettings();
+    return (_jsxs("div", { children: [_jsxs("div", { children: [_jsx("h1", { className: "mt-2 text-2xl font-semibold tracking-tight text-foreground", children: labels.title }), _jsx("p", { className: "mt-1 max-w-2xl text-sm text-muted-foreground", children: labels.subtitle })] }), _jsx("div", { className: "mt-6", children: settingsQuery.isError ? (_jsx(ErrorState, { error: settingsQuery.error, onRetry: settingsQuery.refetch })) : settingsQuery.isLoading || !settingsQuery.data ? (_jsx(Skeleton, { className: "h-96 w-full" })) : (_jsx(SettingsForm, { settings: settingsQuery.data, canEdit: canEdit, adapter: adapter, labels: labels, formatters: formatters })) })] }));
+}
+function SettingsForm({ settings, canEdit, adapter, labels, formatters, }) {
+    const [separator, setSeparator] = useState(settings.separator);
+    const [vatSuffix, setVatSuffix] = useState(settings.vatSuffix);
+    const [includeVatSuffix, setIncludeVatSuffix] = useState(settings.includeVatSuffix);
+    const [includeAmount, setIncludeAmount] = useState(settings.includeAmount);
+    const [includeProperty, setIncludeProperty] = useState(settings.includeProperty);
+    const [descriptionSource, setDescriptionSource] = useState(settings.descriptionSource);
+    const [transliterateUmlauts, setTransliterateUmlauts] = useState(settings.transliterateUmlauts);
+    const [isSaving, setIsSaving] = useState(false);
+    // Re-sync local state whenever the stored settings change underneath us.
+    useEffect(() => {
+        setSeparator(settings.separator);
+        setVatSuffix(settings.vatSuffix);
+        setIncludeVatSuffix(settings.includeVatSuffix);
+        setIncludeAmount(settings.includeAmount);
+        setIncludeProperty(settings.includeProperty);
+        setDescriptionSource(settings.descriptionSource);
+        setTransliterateUmlauts(settings.transliterateUmlauts);
+    }, [settings]);
+    const draft = {
+        separator,
+        vatSuffix,
+        includeVatSuffix,
+        includeAmount,
+        includeProperty,
+        descriptionSource,
+        transliterateUmlauts,
+    };
+    const previews = useMemo(() => [
+        { key: "complete", name: buildSuggestedFilename(adapter.previewInvoices.complete, draft) },
+        {
+            key: "withoutPropertyOrDescription",
+            name: buildSuggestedFilename(adapter.previewInvoices.withoutPropertyOrDescription, draft),
+        },
+        { key: "minimal", name: buildSuggestedFilename(adapter.previewInvoices.minimal, draft) },
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    ], [adapter.previewInvoices, separator, vatSuffix, includeVatSuffix, includeAmount, includeProperty, descriptionSource, transliterateUmlauts]);
+    const standard = adapter.standardSettings;
+    const driftedFromStandard = settings.separator !== standard.separator ||
+        settings.vatSuffix !== standard.vatSuffix ||
+        settings.includeVatSuffix !== standard.includeVatSuffix ||
+        settings.includeAmount !== standard.includeAmount ||
+        settings.includeProperty !== standard.includeProperty ||
+        settings.descriptionSource !== standard.descriptionSource ||
+        settings.transliterateUmlauts !== standard.transliterateUmlauts;
+    function restoreStandard() {
+        setSeparator(standard.separator);
+        setVatSuffix(standard.vatSuffix);
+        setIncludeVatSuffix(standard.includeVatSuffix);
+        setIncludeAmount(standard.includeAmount);
+        setIncludeProperty(standard.includeProperty);
+        setDescriptionSource(standard.descriptionSource);
+        setTransliterateUmlauts(standard.transliterateUmlauts);
+    }
+    // Both free-text fields feed straight into the file name, and unsafe characters are only
+    // stripped after joining — so an unsafe separator has already done its damage by then.
+    const separatorInvalid = separator.length === 0 || UNSAFE_FILENAME_CHARS.test(separator);
+    const vatSuffixInvalid = includeVatSuffix && (vatSuffix.trim().length === 0 || UNSAFE_FILENAME_CHARS.test(vatSuffix));
+    const invalid = separatorInvalid || vatSuffixInvalid;
+    const dirty = separator !== settings.separator ||
+        vatSuffix !== settings.vatSuffix ||
+        includeVatSuffix !== settings.includeVatSuffix ||
+        includeAmount !== settings.includeAmount ||
+        includeProperty !== settings.includeProperty ||
+        descriptionSource !== settings.descriptionSource ||
+        transliterateUmlauts !== settings.transliterateUmlauts;
+    // Leaving the page must not silently throw away unsaved edits.
+    useEffect(() => {
+        if (!dirty)
+            return;
+        const warnBeforeLeaving = (event) => {
+            event.preventDefault();
+            event.returnValue = "";
+        };
+        window.addEventListener("beforeunload", warnBeforeLeaving);
+        return () => window.removeEventListener("beforeunload", warnBeforeLeaving);
+    }, [dirty]);
+    async function save() {
+        setIsSaving(true);
+        try {
+            await adapter.saveSettings(draft);
+            toast.success(labels.saved);
+        }
+        catch (error) {
+            toast.error(labels.saveFailed(readableErrorMessage(error, "")));
+        }
+        finally {
+            setIsSaving(false);
+        }
+    }
+    return (_jsxs("div", { className: "grid gap-6 lg:grid-cols-[1fr_360px]", children: [_jsxs("div", { className: "space-y-6", children: [!canEdit && (_jsx("p", { className: "rounded-md border border-border bg-muted/40 px-3 py-2 text-xs text-muted-foreground", children: labels.readOnlyHint })), _jsx("p", { className: "rounded-md border border-border bg-muted/40 px-3 py-2 text-xs text-muted-foreground", children: labels.forwardOnlyHint }), settings.updatedAt && (_jsx("p", { className: "text-xs text-muted-foreground", children: labels.lastChanged(settings.updatedBy ?? labels.unknownPerson, formatters.formatDateTime(settings.updatedAt)) })), driftedFromStandard && (_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-3 rounded-md border border-warning/40 bg-warning-soft px-3 py-2 text-xs text-foreground", children: [_jsx("span", { children: labels.driftedFromStandard }), canEdit && (_jsx(Button, { variant: "outline", size: "sm", onClick: restoreStandard, children: labels.restoreStandard }))] })), _jsxs(Card, { children: [_jsxs(CardHeader, { children: [_jsx(CardTitle, { children: labels.structureCard.title }), _jsx(CardDescription, { children: labels.structureCard.description })] }), _jsxs(CardContent, { className: "grid gap-4 sm:grid-cols-2", children: [_jsxs("div", { className: "space-y-1", children: [_jsx(Label, { className: "text-xs text-muted-foreground", children: labels.separatorField }), _jsx(Input, { value: separator, disabled: !canEdit, onChange: (event) => setSeparator(event.target.value), maxLength: 3, "aria-invalid": separatorInvalid }), separatorInvalid && (_jsx("p", { className: "text-xs text-warning", children: labels.separatorInvalid }))] }), _jsxs("div", { className: "space-y-1", children: [_jsx(Label, { className: "text-xs text-muted-foreground", children: labels.vatSuffixField }), _jsx(Input, { value: vatSuffix, disabled: !canEdit, onChange: (event) => setVatSuffix(event.target.value), maxLength: 12, "aria-invalid": vatSuffixInvalid }), vatSuffixInvalid && _jsx("p", { className: "text-xs text-warning", children: labels.vatSuffixInvalid }), _jsx("p", { className: "text-xs text-muted-foreground", children: labels.vatSuffixJoinerHint })] }), _jsx(ToggleRow, { label: labels.includeVatSuffix, checked: includeVatSuffix, disabled: !canEdit, onCheckedChange: setIncludeVatSuffix }), _jsx(ToggleRow, { label: labels.includeAmount, checked: includeAmount, disabled: !canEdit, onCheckedChange: setIncludeAmount }), _jsx(ToggleRow, { label: labels.includeProperty, checked: includeProperty, disabled: !canEdit, onCheckedChange: setIncludeProperty }), _jsx(ToggleRow, { label: labels.transliterateUmlauts, checked: transliterateUmlauts, disabled: !canEdit, onCheckedChange: setTransliterateUmlauts })] })] }), _jsxs(Card, { children: [_jsxs(CardHeader, { children: [_jsx(CardTitle, { children: labels.descriptionCard.title }), _jsx(CardDescription, { children: labels.descriptionCard.description })] }), _jsx(CardContent, { children: _jsxs("div", { className: "space-y-1 sm:max-w-xs", children: [_jsx(Label, { className: "text-xs text-muted-foreground", children: labels.descriptionSourceField }), _jsxs(Select, { value: descriptionSource, disabled: !canEdit, onValueChange: (value) => setDescriptionSource(value), children: [_jsx(SelectTrigger, { children: _jsx(SelectValue, {}) }), _jsx(SelectContent, { children: DESCRIPTION_SOURCES.map((source) => (_jsx(SelectItem, { value: source, children: labels.descriptionSource[source] }, source))) })] })] }) })] }), canEdit && (_jsx("div", { className: "flex justify-end", children: _jsx(Button, { onClick: save, disabled: !dirty || invalid || isSaving, children: isSaving ? labels.saving : labels.save }) }))] }), _jsxs(Card, { className: "h-fit", children: [_jsxs(CardHeader, { children: [_jsx(CardTitle, { children: labels.previewCard.title }), _jsx(CardDescription, { children: labels.previewCard.description })] }), _jsxs(CardContent, { children: [_jsx("p", { className: "rounded-md border border-border bg-muted/40 px-3 py-2 font-mono text-sm break-all text-foreground", children: previews[0]?.name ?? labels.previewEmpty }), _jsx("div", { className: "mt-3 space-y-3", children: previews.slice(1).map((preview) => (_jsxs("div", { className: "space-y-1", children: [_jsx("p", { className: "text-xs text-muted-foreground", children: preview.key === "withoutPropertyOrDescription"
+                                                ? labels.previewCase.withoutPropertyOrDescription
+                                                : labels.previewCase.minimal }), _jsx("p", { className: "rounded-md border border-border bg-muted/40 px-3 py-2 font-mono text-sm break-all text-foreground", children: preview.name ?? labels.previewEmpty })] }, preview.key))) }), _jsx("p", { className: "mt-3 text-xs text-muted-foreground", children: labels.previewTypeHint })] })] })] }));
+}
+function ToggleRow({ label, checked, disabled, onCheckedChange, }) {
+    return (_jsxs("div", { className: "flex items-center justify-between gap-3 rounded-md border border-border px-3 py-2", children: [_jsx("span", { className: "text-sm text-foreground", children: label }), _jsx(Switch, { checked: checked, disabled: disabled, onCheckedChange: onCheckedChange })] }));
+}

package/dist/pages/file-naming/labels.d.ts

@@ -0,0 +1,44 @@
+export interface FileNamingLabels {
+    title: string;
+    subtitle: string;
+    readOnlyHint: string;
+    forwardOnlyHint: string;
+    lastChanged: (who: string, when: string) => string;
+    unknownPerson: string;
+    driftedFromStandard: string;
+    restoreStandard: string;
+    structureCard: {
+        title: string;
+        description: string;
+    };
+    separatorField: string;
+    separatorInvalid: string;
+    vatSuffixField: string;
+    vatSuffixInvalid: string;
+    vatSuffixJoinerHint: string;
+    includeVatSuffix: string;
+    includeAmount: string;
+    includeProperty: string;
+    transliterateUmlauts: string;
+    descriptionCard: {
+        title: string;
+        description: string;
+    };
+    descriptionSourceField: string;
+    descriptionSource: Record<"service_description" | "cost_category" | "none", string>;
+    save: string;
+    saving: string;
+    saved: string;
+    saveFailed: (error: string) => string;
+    previewCard: {
+        title: string;
+        description: string;
+    };
+    previewEmpty: string;
+    previewCase: {
+        withoutPropertyOrDescription: string;
+        minimal: string;
+    };
+    previewTypeHint: string;
+}
+export declare const englishFileNamingLabels: FileNamingLabels;

package/dist/pages/file-naming/labels.js

@@ -0,0 +1,44 @@
+export const englishFileNamingLabels = {
+    title: "File naming",
+    subtitle: "The naming pattern applied to every incoming document.",
+    readOnlyHint: "You can view this page but not change it.",
+    forwardOnlyHint: "A change only applies to documents processed from now on. One pattern applies to the whole Hub, not per company.",
+    lastChanged: (who, when) => `Last changed by ${who} on ${when}.`,
+    unknownPerson: "an unknown person",
+    driftedFromStandard: "These settings no longer match the recommended pattern.",
+    restoreStandard: "Restore recommended pattern",
+    structureCard: {
+        title: "File name structure",
+        description: "What goes into the file name, and in what order.",
+    },
+    separatorField: "Separator",
+    separatorInvalid: "Enter a separator with no /, \\, :, *, ?, \", <, >, or |.",
+    vatSuffixField: "VAT marker",
+    vatSuffixInvalid: "Enter a VAT marker with no /, \\, :, *, ?, \", <, >, or |.",
+    vatSuffixJoinerHint: "This is joined to the company code with an underscore, not the separator above.",
+    includeVatSuffix: "Add the VAT marker",
+    includeAmount: "Add the amount",
+    includeProperty: "Add the property code",
+    transliterateUmlauts: "Spell out ä, ö, ü and ß",
+    descriptionCard: {
+        title: "Description",
+        description: "Which field fills the description part of the name.",
+    },
+    descriptionSourceField: "Description source",
+    descriptionSource: {
+        service_description: "Service description",
+        cost_category: "Cost category",
+        none: "None",
+    },
+    save: "Save",
+    saving: "Saving …",
+    saved: "Saved.",
+    saveFailed: (error) => `Saving failed: ${error}`,
+    previewCard: { title: "Preview", description: "How today's settings turn into a file name." },
+    previewEmpty: "Not enough data for a preview.",
+    previewCase: {
+        withoutPropertyOrDescription: "Without a property or a description",
+        minimal: "With only the earliest extracted fields",
+    },
+    previewTypeHint: "The document type is never part of the name — the destination folder already says it.",
+};

package/dist/pages/index.d.ts

@@ -0,0 +1,63 @@
+export { ProcessingLogPage } from "./processing-log/processing-log-page";
+export type { ProcessingLogPageProps } from "./processing-log/processing-log-page";
+export { englishProcessingLogLabels } from "./processing-log/labels";
+export type { ProcessingLogLabels } from "./processing-log/labels";
+export { parseSender, parseReason, senderOneLine } from "./processing-log/mail-parsing";
+export { NotificationsPage } from "./notifications/notifications-page";
+export type { NotificationsPageProps } from "./notifications/notifications-page";
+export { englishNotificationsPageLabels } from "./notifications/labels";
+export type { NotificationsPageLabels } from "./notifications/labels";
+export { TeamPage } from "./team/team-page";
+export type { TeamPageProps } from "./team/team-page";
+export { englishTeamPageLabels } from "./team/labels";
+export type { TeamPageLabels } from "./team/labels";
+export { EditEmployeeSheet, CompanyPickList, EmployeePermissionsSection } from "./team/employee-editor";
+export { NewEmployeeSheet } from "./team/new-employee";
+export { ToggleActiveDialog, ResetPasswordDialog } from "./team/account-dialogs";
+export { TempPasswordDialog } from "./team/temp-password-dialog";
+export { RolesPermissionsTab } from "./team/roles-tab";
+export { TrashPage } from "./trash/trash-page";
+export { englishTrashPageLabels } from "./trash/labels";
+export type { TrashPageLabels } from "./trash/labels";
+export { CustomerListPage } from "./customers/customer-list-page";
+export { CustomerDetailPage } from "./customers/customer-detail-page";
+export { NewCustomerDialog } from "./customers/new-customer-dialog";
+export { EditCustomerDialog } from "./customers/edit-customer-dialog";
+export { englishCustomersLabels } from "./customers/labels";
+export type { CustomersLabels } from "./customers/labels";
+export { CompanyListPage } from "./companies/company-list-page";
+export { CompanyDetailPage } from "./companies/company-detail-page";
+export { englishCompaniesLabels } from "./companies/labels";
+export type { CompaniesLabels } from "./companies/labels";
+export { PropertyListPage } from "./properties/property-list-page";
+export { PropertyDetailPage } from "./properties/property-detail-page";
+export { englishPropertiesLabels } from "./properties/labels";
+export type { PropertiesLabels } from "./properties/labels";
+export { ExclusionRulesPage } from "./exclusion-rules/exclusion-rules-page";
+export { englishExclusionRulesLabels } from "./exclusion-rules/labels";
+export type { ExclusionRulesLabels } from "./exclusion-rules/labels";
+export { VatRulesPage } from "./vat-rules/vat-rules-page";
+export { englishVatRulesLabels } from "./vat-rules/labels";
+export type { VatRulesLabels } from "./vat-rules/labels";
+export { FileNamingPage } from "./file-naming/file-naming-page";
+export { englishFileNamingLabels } from "./file-naming/labels";
+export type { FileNamingLabels } from "./file-naming/labels";
+export { buildSuggestedFilename, UNSAFE_FILENAME_CHARS } from "./file-naming/build-filename";
+export { OverviewPage } from "./overview/overview-page";
+export type { OverviewLinks, OverviewPageProps, OverviewWidget, } from "./overview/overview-page";
+export { englishOverviewLabels } from "./overview/labels";
+export type { OverviewLabels } from "./overview/labels";
+export * from "./invoice-detail";
+export * from "./invoice-list";
+export * from "./supplier-detail";
+export * from "./supplier-list";
+export * from "./invoice-upload";
+export * from "./outgoing-invoices";
+export * from "./open-items";
+export * from "./opos-whitelist";
+export * from "./manual-bookings";
+export * from "./category-rules";
+export * from "./bank-transactions";
+export * from "./bank-accounts";
+export * from "./bank-import";
+export * from "./bank-sync-log";

package/dist/pages/index.js

@@ -0,0 +1,48 @@
+export { ProcessingLogPage } from "./processing-log/processing-log-page.js";
+export { englishProcessingLogLabels } from "./processing-log/labels.js";
+export { parseSender, parseReason, senderOneLine } from "./processing-log/mail-parsing.js";
+export { NotificationsPage } from "./notifications/notifications-page.js";
+export { englishNotificationsPageLabels } from "./notifications/labels.js";
+export { TeamPage } from "./team/team-page.js";
+export { englishTeamPageLabels } from "./team/labels.js";
+export { EditEmployeeSheet, CompanyPickList, EmployeePermissionsSection } from "./team/employee-editor.js";
+export { NewEmployeeSheet } from "./team/new-employee.js";
+export { ToggleActiveDialog, ResetPasswordDialog } from "./team/account-dialogs.js";
+export { TempPasswordDialog } from "./team/temp-password-dialog.js";
+export { RolesPermissionsTab } from "./team/roles-tab.js";
+export { TrashPage } from "./trash/trash-page.js";
+export { englishTrashPageLabels } from "./trash/labels.js";
+export { CustomerListPage } from "./customers/customer-list-page.js";
+export { CustomerDetailPage } from "./customers/customer-detail-page.js";
+export { NewCustomerDialog } from "./customers/new-customer-dialog.js";
+export { EditCustomerDialog } from "./customers/edit-customer-dialog.js";
+export { englishCustomersLabels } from "./customers/labels.js";
+export { CompanyListPage } from "./companies/company-list-page.js";
+export { CompanyDetailPage } from "./companies/company-detail-page.js";
+export { englishCompaniesLabels } from "./companies/labels.js";
+export { PropertyListPage } from "./properties/property-list-page.js";
+export { PropertyDetailPage } from "./properties/property-detail-page.js";
+export { englishPropertiesLabels } from "./properties/labels.js";
+export { ExclusionRulesPage } from "./exclusion-rules/exclusion-rules-page.js";
+export { englishExclusionRulesLabels } from "./exclusion-rules/labels.js";
+export { VatRulesPage } from "./vat-rules/vat-rules-page.js";
+export { englishVatRulesLabels } from "./vat-rules/labels.js";
+export { FileNamingPage } from "./file-naming/file-naming-page.js";
+export { englishFileNamingLabels } from "./file-naming/labels.js";
+export { buildSuggestedFilename, UNSAFE_FILENAME_CHARS } from "./file-naming/build-filename.js";
+export { OverviewPage } from "./overview/overview-page.js";
+export { englishOverviewLabels } from "./overview/labels.js";
+export * from "./invoice-detail/index.js";
+export * from "./invoice-list/index.js";
+export * from "./supplier-detail/index.js";
+export * from "./supplier-list/index.js";
+export * from "./invoice-upload/index.js";
+export * from "./outgoing-invoices/index.js";
+export * from "./open-items/index.js";
+export * from "./opos-whitelist/index.js";
+export * from "./manual-bookings/index.js";
+export * from "./category-rules/index.js";
+export * from "./bank-transactions/index.js";
+export * from "./bank-accounts/index.js";
+export * from "./bank-import/index.js";
+export * from "./bank-sync-log/index.js";

package/dist/pages/invoice-detail/InvoiceDetailPage.d.ts

@@ -0,0 +1,11 @@
+import { type Formatters } from "../../lib/formatters";
+import type { InvoiceDetailAdapter, InvoiceDetailConfig } from "../../adapters/invoice-detail";
+import { type InvoiceDetailLabels } from "./labels";
+export interface InvoiceDetailPageProps {
+    invoiceId: string;
+    adapter: InvoiceDetailAdapter;
+    config: InvoiceDetailConfig;
+    labels?: InvoiceDetailLabels;
+    formatters?: Formatters;
+}
+export declare function InvoiceDetailPage({ invoiceId, adapter, config, labels, formatters, }: InvoiceDetailPageProps): import("react").JSX.Element;