@hub-kit/core 0.3.0

package/dist/adapters/exclusion-rules.js

@@ -0,0 +1,15 @@
+// Scopes matched against the mail/file envelope before the AI reads the document.
+export const EXCLUSION_SCOPES_BEFORE_READING = [
+    "sender",
+    "subject",
+    "filename",
+    "envelope",
+];
+// Scopes matched against the extracted fields after the AI has read the document.
+export const EXCLUSION_SCOPES_AFTER_READING = [
+    "party",
+    "supplier",
+    "body",
+    "company",
+    "property",
+];

package/dist/adapters/file-naming.d.ts

@@ -0,0 +1,36 @@
+import type { QueryResult } from "../lib/query-result";
+export type FileNamingDescriptionSource = "service_description" | "cost_category" | "none";
+export interface FileNamingSettingsInput {
+    separator: string;
+    vatSuffix: string;
+    includeVatSuffix: boolean;
+    includeAmount: boolean;
+    includeProperty: boolean;
+    descriptionSource: FileNamingDescriptionSource;
+    transliterateUmlauts: boolean;
+}
+export interface FileNamingSettings extends FileNamingSettingsInput {
+    updatedAt: string | null;
+    updatedBy: string | null;
+}
+export interface FilenamePreviewInvoice {
+    documentDate: string | null;
+    companyCode: string | null;
+    issuer: string | null;
+    serviceDescription: string | null;
+    costCategory: string | null;
+    amountGross: number | null;
+    propertyCode: string | null;
+    vatRate: number | null;
+    vatExempt: boolean;
+}
+export interface FileNamingAdapter {
+    useSettings(): QueryResult<FileNamingSettings>;
+    saveSettings(input: FileNamingSettingsInput): Promise<void>;
+    standardSettings: FileNamingSettingsInput;
+    previewInvoices: {
+        complete: FilenamePreviewInvoice;
+        withoutPropertyOrDescription: FilenamePreviewInvoice;
+        minimal: FilenamePreviewInvoice;
+    };
+}

package/dist/adapters/file-naming.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/index.d.ts

@@ -0,0 +1,24 @@
+export type { ProcessingLogAdapter, ProcessingLogEntry, ProcessingLogPageQuery, ProcessingLogCountsQuery, ChangeHistoryEntry, PageOfRows, StatusTone, } from "./processing-log";
+export type { NotificationsAdapter, AckStore, BellEventGroup, ReminderRecipient, } from "./notifications";
+export type { TeamAdapter, TeamEmployee, TeamCompany, TeamRole, CreatedAccount, } from "./team";
+export type { TrashAdapter, TrashedRecord, TrashTableNames } from "./trash";
+export type { CustomersAdapter, Customer, CustomerCompany, CustomerInvoice, CustomerInvoiceTotals, NewCustomerInput, CustomerUpdateInput, } from "./customers";
+export type { CompaniesAdapter, Company, CompanyInvoiceTotals, CompanyInvoice, CompanyProperty, CompanyAlias, } from "./companies";
+export type { PropertiesAdapter, Property, PropertyCompany, PropertyInvoice, PropertyInvoiceTotals, PropertyNameVariant, } from "./properties";
+export type { ExclusionRulesAdapter, ExclusionRule, ExclusionScope, ExclusionImpact, } from "./exclusion-rules";
+export { EXCLUSION_SCOPES_BEFORE_READING, EXCLUSION_SCOPES_AFTER_READING } from "./exclusion-rules";
+export type { VatRulesAdapter, VatRule, VatRuleDraft, VatRuleInput, VatRuleCompany, VatRuleSupplier, VatRuleProperty, RuleImpact, BulkApplyResult, VatReserveSummary, } from "./vat-rules";
+export type { FileNamingAdapter, FileNamingSettings, FileNamingSettingsInput, FileNamingDescriptionSource, FilenamePreviewInvoice, } from "./file-naming";
+export type { OverviewAdapter, MoneyFigure, MoneyCardConfig, OverviewPeriod, PeriodRange, } from "./overview";
+export type { InvoiceDetailConfig } from "./invoice-detail";
+export type { InvoiceListRow, InvoiceQueueCardData, InvoiceListAdapter, InvoiceQueueCardConfig, InvoiceListConfig, } from "./invoice-list";
+export type { SupplierRecord, SupplierBankAccountRecord, SupplierInvoiceRow, NewSupplierBankAccount, SupplierDetailAdapter, } from "./supplier-detail";
+export type { SupplierListRow, NewSupplierInput, SupplierListAdapter } from "./supplier-list";
+export type { UploadedFileResult, InvoiceUploadInput, InvoiceUploadAdapter } from "./invoice-upload";
+export type { OutgoingInvoiceStatus, OutgoingInvoiceRecord, OutgoingInvoiceAdapter } from "./outgoing-invoices";
+export type { OpenItemRow, OpenItemsAdapter } from "./open-items";
+export type { OposRule, NewOposRule, OposWhitelistAdapter } from "./opos-whitelist";
+export type { ManualBookingRecord, NewManualBooking, ManualBookingsAdapter } from "./manual-bookings";
+export type { BwaBlock, CategoryDirection, CategoryRecord, NewCategory, AssignmentRuleScopeChip, AssignmentRuleRow, NewAssignmentRule, CategoryRulesAdapter, } from "./category-rules";
+export type { BankAccountRecord, BankTransactionRecord, BankMatchCandidate, BankInvoiceSearchResult, BankReconciliationAdapter, } from "./bank-reconciliation";
+export type { SyncLogRow, SyncLogFilter, SyncLogAdapter } from "./bank-sync-log";

package/dist/adapters/index.js

@@ -0,0 +1 @@
+export { EXCLUSION_SCOPES_BEFORE_READING, EXCLUSION_SCOPES_AFTER_READING } from "./exclusion-rules.js";

package/dist/adapters/invoice-detail.d.ts

@@ -0,0 +1,126 @@
+import type { HistoryConfig } from "../pages/invoice-detail/history";
+import type { LadderColors } from "../pages/invoice-detail/WorkflowLadder";
+import type { InvoiceHistoryEntry, InvoiceReviewFields } from "../pages/invoice-detail/pipeline-types";
+export interface InvoiceDetailConfig extends HistoryConfig {
+    chainActionIds: string[];
+    autoSteps: string[];
+    correctableStatuses: string[];
+    ladderColors: LadderColors;
+    fieldJumpTargets: Record<string, {
+        tab: string;
+        anchor: string;
+    }>;
+    workflowSteps: readonly string[];
+}
+export interface InvoiceDetailRecord extends InvoiceReviewFields {
+    id: string;
+    supplier_id: string | null;
+    issuer_address: string | null;
+    document_type: string | null;
+    service_date: string | null;
+    service_period_from: string | null;
+    service_period_to: string | null;
+    invoice_number: string | null;
+    order_number: string | null;
+    currency: string | null;
+    property_code: string | null;
+    category_id: string | null;
+    cost_category: string | null;
+    service_description: string | null;
+    recipient_address: string | null;
+    customer_number: string | null;
+    payment_reference: string | null;
+    payment_method: string | null;
+    tax_note: string | null;
+    due_date: string | null;
+    early_payment_deadline: string | null;
+    early_payment_discount_percent: number | null;
+    early_payment_discount_amount: number | null;
+    paid_at: string | null;
+    workflow_status: string | null;
+    assigned_to: string | null;
+    created_at: string;
+    updated_at: string | null;
+    archived_at: string | null;
+    not_relevant_at: string | null;
+    deleted_at: string | null;
+}
+export interface Approver {
+    id: string;
+    name: string;
+    role: string;
+}
+export interface ApprovalAction {
+    id: string;
+    requiresComment: boolean;
+}
+export interface InvoiceDetailAdapter {
+    useInvoice(id: string): {
+        data: InvoiceDetailRecord | undefined;
+        loading: boolean;
+        error: unknown;
+        refetch: () => void;
+    };
+    useHistory(invoiceId: string): {
+        data: InvoiceHistoryEntry[];
+        loading: boolean;
+    };
+    useCompanyOptions(): {
+        data: {
+            code: string;
+            name: string;
+        }[];
+        loading: boolean;
+    };
+    usePropertyOptions(): {
+        data: {
+            code: string;
+            name: string;
+        }[];
+        loading: boolean;
+    };
+    useCategoryOptions(): {
+        data: {
+            id: string;
+            name: string;
+        }[];
+        loading: boolean;
+    };
+    canEdit: boolean;
+    updateInvoice(id: string, changes: Record<string, unknown>, changedFieldLabels: string[]): Promise<void>;
+    addNote(id: string, text: string): Promise<void>;
+    softDelete(id: string, reason: string): Promise<void>;
+    openInvoiceList: () => void;
+    approval?: {
+        useApprovers(): {
+            data: Approver[];
+            loading: boolean;
+        };
+        useLegalActions(invoice: InvoiceDetailRecord): {
+            data: Map<string, ApprovalAction>;
+            loading: boolean;
+        };
+        runAction(id: string, actionId: string, comment: string | undefined): Promise<void>;
+    };
+    payment?: {
+        setPaid(id: string, paid: boolean): Promise<void>;
+        usePayableAccount(invoice: InvoiceDetailRecord): {
+            data: {
+                iban: string;
+                bankName: string | null;
+            } | null;
+            loading: boolean;
+        };
+    };
+    supplier?: {
+        openSupplier: (supplierId: string) => void;
+    };
+    archive?: {
+        archive(id: string, note: string): Promise<void>;
+        unarchive(id: string): Promise<void>;
+    };
+    notRelevant?: {
+        setNotRelevant(id: string, reason: string): Promise<void>;
+        clearNotRelevant(id: string): Promise<void>;
+    };
+}

package/dist/adapters/invoice-detail.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/invoice-list.d.ts

@@ -0,0 +1,63 @@
+import type { LucideIcon } from "lucide-react";
+import type { Extracted, Validation } from "../pages/invoice-detail/pipeline-types";
+import type { QueueTone } from "../components/invoice-queue";
+export interface InvoiceListRow {
+    id: string;
+    issuer: string | null;
+    invoiceNumber: string | null;
+    costCategory: string | null;
+    documentType: string | null;
+    paymentMethod: string | null;
+    companyCode: string | null;
+    amountGross: number | null;
+    vatRate: number | null;
+    documentDate: string | null;
+    dueDate: string | null;
+    paidAt: string | null;
+    confidenceScore: number | null;
+    status: string | null;
+    workflowStatus: string | null;
+    extracted: Extracted | null;
+    validation: Validation | null;
+    validation_detail?: Record<string, unknown> | null;
+    hasConfirmedBankMatch?: boolean;
+    hasSuggestedBankMatch?: boolean;
+}
+export interface InvoiceQueueCardData {
+    key: string;
+    count: number;
+    amount: number;
+}
+export interface InvoiceListAdapter {
+    useInvoices(): {
+        data: InvoiceListRow[];
+        loading: boolean;
+        error: unknown;
+    };
+    useQueueCards?(): {
+        data: InvoiceQueueCardData[];
+        loading: boolean;
+    };
+    useCompanyOptions?(): {
+        data: {
+            code: string;
+            name: string;
+        }[];
+        loading: boolean;
+    };
+    openInvoice(id: string): void;
+    formatMoney: (value: number | null) => string;
+    formatDate: (iso: string | null) => string;
+}
+export interface InvoiceQueueCardConfig {
+    key: string;
+    icon: LucideIcon;
+    tone: QueueTone;
+    filter: (row: InvoiceListRow) => boolean;
+}
+export interface InvoiceListConfig {
+    direction: "incoming" | "outgoing";
+    queueCards?: InvoiceQueueCardConfig[];
+    showBankMatch?: boolean;
+    showConfidence?: boolean;
+}

package/dist/adapters/invoice-list.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/invoice-upload.d.ts

@@ -0,0 +1,26 @@
+export interface UploadedFileResult {
+    storageBucket: string;
+    storagePath: string;
+    mime: string;
+    sizeBytes: number;
+    checksumSha256: string;
+}
+export interface InvoiceUploadInput {
+    invoiceId: string;
+    filename: string;
+    mime: string;
+    size: number;
+    storageBucket: string;
+    storagePath: string;
+    checksumSha256: string;
+}
+export interface InvoiceUploadAdapter {
+    acceptedExtensions: string[];
+    maxFileSizeBytes: number;
+    uploadFile(file: File, opts: {
+        signal: AbortSignal;
+        onProgress: (percent: number) => void;
+    }): Promise<UploadedFileResult>;
+    createInvoices(inputs: InvoiceUploadInput[]): Promise<void>;
+    openInvoiceList: () => void;
+}

package/dist/adapters/invoice-upload.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/manual-bookings.d.ts

@@ -0,0 +1,56 @@
+export interface ManualBookingRecord {
+    id: string;
+    companyId: string;
+    categoryId: string;
+    propertyId: string | null;
+    period: string;
+    amount: number;
+    note: string | null;
+    isRecurring: boolean;
+    recurrenceUntil: string | null;
+}
+export interface NewManualBooking {
+    companyId: string;
+    categoryId: string;
+    propertyId: string | null;
+    period: string;
+    amount: number;
+    note: string | null;
+    isRecurring: boolean;
+    recurrenceUntil: string | null;
+}
+export interface ManualBookingsAdapter {
+    useBookings(companyId: string | null, from: string, to: string): {
+        data: ManualBookingRecord[];
+        loading: boolean;
+        error: unknown;
+    };
+    useCompanyOptions(): {
+        data: {
+            id: string;
+            code: string;
+            name: string;
+        }[];
+        loading: boolean;
+    };
+    useCategoryOptions(): {
+        data: {
+            id: string;
+            label: string;
+        }[];
+        loading: boolean;
+    };
+    usePropertyOptions(): {
+        data: {
+            id: string;
+            code: string;
+            name: string | null;
+        }[];
+        loading: boolean;
+    };
+    createBooking(input: NewManualBooking): Promise<void>;
+    updateBooking(id: string, input: NewManualBooking): Promise<void>;
+    deleteBooking(id: string): Promise<void>;
+    monthLabels: readonly string[];
+    formatMoney: (value: number) => string;
+}

package/dist/adapters/manual-bookings.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/notifications.d.ts

@@ -0,0 +1,31 @@
+import type { NotificationItem } from "../components/notifications/types";
+export interface AckStore {
+    acked: Record<string, number>;
+    save: (next: Record<string, number>) => void;
+}
+export interface BellEventGroup {
+    key: string;
+    events: string[];
+}
+export interface ReminderRecipient {
+    value: string;
+    label: string;
+}
+export interface NotificationsAdapter {
+    useItems(): {
+        items: NotificationItem[];
+        loading: boolean;
+    };
+    useAckStore(): AckStore;
+    useBellToggles(): {
+        saved: Record<string, boolean> | undefined;
+        isLoading: boolean;
+        save: (next: Record<string, boolean>) => Promise<void>;
+    };
+    useReminderRecipients(): ReminderRecipient[];
+    sendReminder(input: {
+        recipientUserId: string;
+        note?: string;
+    }): Promise<void>;
+    bellEventGroups: BellEventGroup[];
+}

package/dist/adapters/notifications.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/open-items.d.ts

@@ -0,0 +1,42 @@
+import type { BankTransactionRecord } from "./bank-reconciliation";
+export interface OpenItemRow {
+    type: "incoming" | "outgoing";
+    id: string;
+    companyCode: string | null;
+    counterparty: string;
+    invoiceNumber: string | null;
+    amount: number | null;
+    matchedAmount: number;
+    receivedAt: string | null;
+    documentDate: string | null;
+    dueDate: string | null;
+    discountDeadline: string | null;
+    discountPercent: number | null;
+    discountAmount: number | null;
+    blocked: boolean;
+}
+export interface OpenItemsAdapter {
+    useOpenItems(includeBlocked: boolean): {
+        data: OpenItemRow[];
+        loading: boolean;
+        error: unknown;
+    };
+    useMissingReceiptTransactions(): {
+        data: BankTransactionRecord[];
+        loading: boolean;
+        error: unknown;
+    };
+    useCompanyOptions(): {
+        data: {
+            code: string;
+            name: string;
+        }[];
+        loading: boolean;
+    };
+    openInvoice: (row: {
+        type: "incoming" | "outgoing";
+        id: string;
+    }) => void;
+    formatMoney: (value: number | null) => string;
+    formatDate: (iso: string | null) => string;
+}

package/dist/adapters/open-items.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/opos-whitelist.d.ts

@@ -0,0 +1,38 @@
+import type { OposCategory, OposScope } from "../lib/opos-whitelist";
+export interface OposRule {
+    id: string;
+    term: string;
+    scope: OposScope;
+    category: OposCategory;
+    note: string | null;
+    is_active: boolean;
+    created_at: string;
+    created_by: string | null;
+}
+export interface NewOposRule {
+    term: string;
+    scope: OposScope;
+    category: OposCategory;
+    note: string;
+    isActive: boolean;
+}
+export interface OposWhitelistAdapter {
+    useRules(): {
+        data: OposRule[];
+        loading: boolean;
+        error: unknown;
+    };
+    useHitCounts(): {
+        data: Map<string, number>;
+        loading: boolean;
+    };
+    canWrite: boolean;
+    createRule(input: NewOposRule): Promise<void>;
+    updateRule(id: string, changes: Partial<NewOposRule>): Promise<void>;
+    deleteRule(id: string): Promise<void>;
+    setActive(id: string, active: boolean): Promise<void>;
+    reapplyAll(): Promise<{
+        affected: number;
+    }>;
+    formatDate: (iso: string) => string;
+}

package/dist/adapters/opos-whitelist.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/outgoing-invoices.d.ts

@@ -0,0 +1,32 @@
+export type OutgoingInvoiceStatus = "draft" | "open" | "paidoff" | "voided";
+export interface OutgoingInvoiceRecord {
+    id: string;
+    company_id: string | null;
+    customer_name: string | null;
+    voucher_number: string | null;
+    voucher_date: string | null;
+    due_date: string | null;
+    amount_gross: number | null;
+    voucher_status: OutgoingInvoiceStatus;
+}
+export interface OutgoingInvoiceAdapter {
+    useInvoices(companyId?: string): {
+        data: OutgoingInvoiceRecord[];
+        loading: boolean;
+        error: unknown;
+    };
+    useCompanyOptions(): {
+        data: {
+            id: string;
+            code: string;
+            name: string;
+        }[];
+        loading: boolean;
+    };
+    setStatus(id: string, status: OutgoingInvoiceStatus): Promise<void>;
+    softDelete(id: string): Promise<void>;
+    openFile?: (invoiceId: string) => void;
+    openUpload: () => void;
+    formatMoney: (value: number | null) => string;
+    formatDate: (iso: string | null) => string;
+}

package/dist/adapters/outgoing-invoices.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/overview.d.ts

@@ -0,0 +1,68 @@
+import type { LucideIcon } from "lucide-react";
+import type { OverviewPeriod, PeriodRange } from "../components/dashboard/periods";
+import type { RankedBarRow } from "../components/dashboard/ranked-bars";
+import type { StageTile } from "../components/dashboard/stage-tiles";
+import type { MoneyTrendPoint } from "../components/dashboard/money-trend-chart";
+import type { ProcessingSummary } from "../components/dashboard/processing-summary-panel";
+import type { StatRowConfig } from "../components/dashboard/stat-rows-panel";
+export type { OverviewPeriod, PeriodRange };
+export interface MoneyFigure {
+    value: number;
+    count?: number;
+    previousValue?: number;
+    loading: boolean;
+}
+export interface OverviewAdapter {
+    useMoneyFigures?(ranges: Record<string, PeriodRange>): {
+        data: Record<string, MoneyFigure>;
+        loading: boolean;
+    };
+    useInvoiceStages?(range: PeriodRange): {
+        data: StageTile[];
+        loading: boolean;
+        error: boolean;
+    };
+    useTopSuppliers?(range: PeriodRange): {
+        data: {
+            rows: RankedBarRow[];
+            totalText: string;
+        };
+        loading: boolean;
+    };
+    useSpendByCompany?(range: PeriodRange): {
+        data: {
+            rows: RankedBarRow[];
+            totalText: string;
+        };
+        loading: boolean;
+    };
+    useMoneyTrend?(range: PeriodRange): {
+        data: MoneyTrendPoint[];
+        loading: boolean;
+    };
+    useProcessingSummary?(range: PeriodRange): {
+        data: ProcessingSummary | undefined;
+        loading: boolean;
+        error: boolean;
+    };
+    useOpenItemsSummary?(): {
+        data: StatRowConfig[];
+        loading: boolean;
+        error: boolean;
+    };
+    useBankSummary?(): {
+        data: StatRowConfig[];
+        loading: boolean;
+        error: boolean;
+    };
+    formatMoney(value: number): string;
+    formatMoneyCompact(value: number): string;
+    formatDay(iso: string): string;
+}
+export interface MoneyCardConfig {
+    key: string;
+    icon: LucideIcon;
+    to: string;
+    iconTint: string;
+    higherIsBetter: boolean;
+}

package/dist/adapters/overview.js

@@ -0,0 +1 @@
+export {};

package/dist/adapters/processing-log.d.ts

@@ -0,0 +1,48 @@
+import type { QueryResult } from "../lib/query-result";
+export type StatusTone = "brand" | "success" | "warning" | "danger" | "neutral";
+export interface ProcessingLogEntry {
+    id: string;
+    processedAt: string | null;
+    subject: string | null;
+    sender: string | null;
+    status: string | null;
+    reason: string | null;
+    invoiceId: string | null;
+}
+export interface ProcessingLogPageQuery {
+    search: string;
+    status: string | undefined;
+    fromDate: string | null;
+    toDate: string | null;
+    page: number;
+    pageSize: number;
+}
+export interface ProcessingLogCountsQuery {
+    search: string;
+    fromDate: string | null;
+    toDate: string | null;
+}
+export interface ChangeHistoryEntry {
+    id: string;
+    at: string | null;
+    actor: string | null;
+    type: string | null;
+    tableName: string | null;
+    text: string | null;
+}
+export interface PageOfRows<Row> {
+    rows: Row[];
+    total: number;
+}
+export interface ProcessingLogAdapter {
+    useLogPage(query: ProcessingLogPageQuery): QueryResult<PageOfRows<ProcessingLogEntry>>;
+    useStatusCounts(query: ProcessingLogCountsQuery): QueryResult<Record<string, number>>;
+    useChangeHistoryPage(query: {
+        search: string;
+        page: number;
+        pageSize: number;
+    }): QueryResult<PageOfRows<ChangeHistoryEntry>>;
+    searchTermWasIgnored(term: string): boolean;
+    openInvoice(invoiceId: string): void;
+    statusTone: Record<string, StatusTone>;
+}

package/dist/adapters/processing-log.js

@@ -0,0 +1 @@
+export {};