@voyant-travel/plugin-smartbill 0.119.2

package/dist/workflows/types.d.ts

@@ -0,0 +1,142 @@
+import type { Invoice } from "@voyant-travel/finance";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { SmartbillClientApi } from "../client.js";
+import type { SmartbillEstimateInvoicesResponse, SmartbillInvoiceResponse, SmartbillPdfResponse, SmartbillStatusResponse } from "../types.js";
+import type { SmartbillCandidateExternalRefRecorder, SmartbillCandidateInvoice, SmartbillWorkflowCandidateSource } from "../workflow-candidates.js";
+export type { SmartbillCandidateExternalRefRecorder, SmartbillCandidateExternalRefRecorderContext, SmartbillCandidateInvoice, SmartbillWorkflowCandidateSource, } from "../workflow-candidates.js";
+export type SmartbillWorkflowDocumentType = "invoice" | "proforma";
+export interface SmartbillWorkflowLogger {
+    info?: (message: string, meta?: unknown) => void;
+    error?: (message: string, meta?: unknown) => void;
+}
+export interface SmartbillWorkflowInvoice {
+    id: string;
+    invoiceNumber: string;
+    invoiceType: Invoice["invoiceType"];
+    status: Invoice["status"];
+    currency: string;
+    totalCents: number;
+    paidCents: number;
+    balanceDueCents: number;
+}
+export interface SmartbillWorkflowExternalRef {
+    id: string;
+    invoiceId: string;
+    provider: string;
+    externalId: string | null;
+    externalNumber: string | null;
+    externalUrl: string | null;
+    status: string | null;
+    metadata: unknown;
+    syncError: string | null;
+    createdAt?: Date | null;
+    updatedAt?: Date | null;
+    invoice?: SmartbillWorkflowInvoice | null;
+}
+export interface SmartbillReferenceParts {
+    companyVatCode: string;
+    seriesName: string;
+    number: string;
+    documentType: SmartbillWorkflowDocumentType;
+}
+export interface SmartbillProformaConversion {
+    proformaRef: SmartbillWorkflowExternalRef;
+    invoice: SmartbillWorkflowInvoice | null;
+    companyVatCode: string;
+    proformaSeriesName: string;
+    proformaNumber: string;
+    invoiceSeriesName: string;
+    invoiceNumber: string;
+    invoiceUrl: string | null;
+    response: SmartbillEstimateInvoicesResponse;
+    smartbillInvoice: SmartbillInvoiceResponse;
+}
+export interface SmartbillProformaConversionPollerOptions {
+    db?: PostgresJsDatabase;
+    client: SmartbillClientApi;
+    limit?: number;
+    requestSpacingMs?: number;
+    companyVatCode?: string;
+    source?: SmartbillWorkflowCandidateSource;
+    logger?: SmartbillWorkflowLogger;
+    listExternalRefs?: () => Promise<SmartbillWorkflowExternalRef[]>;
+    listCandidateInvoices?: () => Promise<SmartbillCandidateInvoice[]>;
+    recordCandidateExternalRef?: SmartbillCandidateExternalRefRecorder;
+    onConverted: (proformaRef: SmartbillWorkflowExternalRef, conversion: SmartbillProformaConversion) => void | Promise<void>;
+    onError?: (error: SmartbillWorkflowError) => void | Promise<void>;
+}
+export interface SmartbillWorkflowError {
+    ref?: SmartbillWorkflowExternalRef;
+    error: unknown;
+}
+export interface SmartbillProformaConversionPollerResult {
+    checked: number;
+    converted: SmartbillProformaConversion[];
+    skipped: Array<{
+        ref: SmartbillWorkflowExternalRef;
+        reason: string;
+    }>;
+    errors: SmartbillWorkflowError[];
+}
+export type SmartbillRemoteDocumentStatus = "present" | "issued" | "paid" | "unpaid" | "partially_paid" | "voided" | "cancelled" | "reversed" | "deleted" | "missing";
+export interface SmartbillRemoteDocument extends SmartbillReferenceParts {
+    status?: SmartbillRemoteDocumentStatus;
+    metadata?: Record<string, unknown>;
+    accessors?: SmartbillRemoteDocumentAccessors;
+}
+export interface SmartbillRemoteDocumentAccessors {
+    viewPdf: () => Promise<SmartbillPdfResponse>;
+    getPaymentStatus?: () => Promise<SmartbillStatusResponse>;
+    listEstimateInvoices?: () => Promise<SmartbillEstimateInvoicesResponse>;
+}
+export type SmartbillDriftFindingType = "missing_local" | "missing_remote" | "voided_remote";
+interface SmartbillDriftFindingBase {
+    document: SmartbillReferenceParts;
+    error?: unknown;
+}
+export interface SmartbillMissingLocalDriftFinding extends SmartbillDriftFindingBase {
+    type: "missing_local";
+    remote: SmartbillRemoteDocument;
+}
+export interface SmartbillKnownLocalDriftFinding extends SmartbillDriftFindingBase {
+    type: "missing_remote" | "voided_remote";
+    ref?: SmartbillWorkflowExternalRef;
+    invoice?: SmartbillWorkflowInvoice | null;
+    remote?: SmartbillRemoteDocument | null;
+}
+export type SmartbillDriftFinding = SmartbillMissingLocalDriftFinding | SmartbillKnownLocalDriftFinding;
+export interface SmartbillDriftReconcilerOptions {
+    db?: PostgresJsDatabase;
+    client: SmartbillClientApi;
+    limit?: number;
+    requestSpacingMs?: number;
+    companyVatCode?: string;
+    logger?: SmartbillWorkflowLogger;
+    discoverRemote?: boolean;
+    source?: SmartbillWorkflowCandidateSource;
+    listExternalRefs?: () => Promise<SmartbillWorkflowExternalRef[]>;
+    listCandidateInvoices?: () => Promise<SmartbillCandidateInvoice[]>;
+    recordCandidateExternalRef?: SmartbillCandidateExternalRefRecorder;
+    listRemoteDocuments?: (context: {
+        refs: SmartbillWorkflowExternalRef[];
+    }) => Promise<SmartbillRemoteDocument[]>;
+    verifyRemoteDocument?: (context: {
+        ref: SmartbillWorkflowExternalRef;
+        document: SmartbillReferenceParts;
+    }) => Promise<SmartbillRemoteDocumentStatus | SmartbillRemoteDocument>;
+    onFinding?: (finding: SmartbillDriftFinding) => void | Promise<void>;
+    onMissingLocal?: (finding: SmartbillMissingLocalDriftFinding) => void | Promise<void>;
+    onError?: (error: SmartbillWorkflowError) => void | Promise<void>;
+}
+export interface SmartbillDriftReconcilerResult {
+    checked: number;
+    findings: SmartbillDriftFinding[];
+    skipped: Array<{
+        ref: SmartbillWorkflowExternalRef;
+        reason: string;
+    }>;
+    errors: SmartbillWorkflowError[];
+}
+export type SmartbillProformaConversionPoller = () => Promise<SmartbillProformaConversionPollerResult>;
+export type SmartbillDriftReconciler = () => Promise<SmartbillDriftReconcilerResult>;
+//# sourceMappingURL=types.d.ts.map

package/dist/workflows/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workflows/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACtD,OAAO,KAAK,EACV,iCAAiC,EACjC,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EACV,qCAAqC,EACrC,yBAAyB,EACzB,gCAAgC,EACjC,MAAM,2BAA2B,CAAA;AAElC,YAAY,EACV,qCAAqC,EACrC,4CAA4C,EAC5C,yBAAyB,EACzB,gCAAgC,GACjC,MAAM,2BAA2B,CAAA;AAElC,MAAM,MAAM,6BAA6B,GAAG,SAAS,GAAG,UAAU,CAAA;AAElE,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IAChD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CAClD;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IACnC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IACvB,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IACvB,OAAO,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAA;CAC1C;AAED,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,6BAA6B,CAAA;CAC5C;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,4BAA4B,CAAA;IACzC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAA;IACxC,cAAc,EAAE,MAAM,CAAA;IACtB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,EAAE,iCAAiC,CAAA;IAC3C,gBAAgB,EAAE,wBAAwB,CAAA;CAC3C;AAED,MAAM,WAAW,wCAAwC;IACvD,EAAE,CAAC,EAAE,kBAAkB,CAAA;IACvB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,gCAAgC,CAAA;IACzC,MAAM,CAAC,EAAE,uBAAuB,CAAA;IAChC,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAAA;IAChE,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAA;IAClE,0BAA0B,CAAC,EAAE,qCAAqC,CAAA;IAClE,WAAW,EAAE,CACX,WAAW,EAAE,4BAA4B,EACzC,UAAU,EAAE,2BAA2B,KACpC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClE;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,EAAE,4BAA4B,CAAA;IAClC,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,uCAAuC;IACtD,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,2BAA2B,EAAE,CAAA;IACxC,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,4BAA4B,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACrE,MAAM,EAAE,sBAAsB,EAAE,CAAA;CACjC;AAED,MAAM,MAAM,6BAA6B,GACrC,SAAS,GACT,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,gBAAgB,GAChB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,SAAS,GACT,SAAS,CAAA;AAEb,MAAM,WAAW,uBAAwB,SAAQ,uBAAuB;IACtE,MAAM,CAAC,EAAE,6BAA6B,CAAA;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,SAAS,CAAC,EAAE,gCAAgC,CAAA;CAC7C;AAED,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAC5C,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAA;IACzD,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,iCAAiC,CAAC,CAAA;CACxE;AAED,MAAM,MAAM,yBAAyB,GAAG,eAAe,GAAG,gBAAgB,GAAG,eAAe,CAAA;AAE5F,UAAU,yBAAyB;IACjC,QAAQ,EAAE,uBAAuB,CAAA;IACjC,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,iCAAkC,SAAQ,yBAAyB;IAClF,IAAI,EAAE,eAAe,CAAA;IACrB,MAAM,EAAE,uBAAuB,CAAA;CAChC;AAED,MAAM,WAAW,+BAAgC,SAAQ,yBAAyB;IAChF,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAAA;IACxC,GAAG,CAAC,EAAE,4BAA4B,CAAA;IAClC,OAAO,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAA;IACzC,MAAM,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAA;CACxC;AAED,MAAM,MAAM,qBAAqB,GAC7B,iCAAiC,GACjC,+BAA+B,CAAA;AAEnC,MAAM,WAAW,+BAA+B;IAC9C,EAAE,CAAC,EAAE,kBAAkB,CAAA;IACvB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,uBAAuB,CAAA;IAChC,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,MAAM,CAAC,EAAE,gCAAgC,CAAA;IACzC,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAAA;IAChE,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAA;IAClE,0BAA0B,CAAC,EAAE,qCAAqC,CAAA;IAClE,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE;QAC9B,IAAI,EAAE,4BAA4B,EAAE,CAAA;KACrC,KAAK,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAA;IACxC,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE;QAC/B,GAAG,EAAE,4BAA4B,CAAA;QACjC,QAAQ,EAAE,uBAAuB,CAAA;KAClC,KAAK,OAAO,CAAC,6BAA6B,GAAG,uBAAuB,CAAC,CAAA;IACtE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpE,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,iCAAiC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClE;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,qBAAqB,EAAE,CAAA;IACjC,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,4BAA4B,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACrE,MAAM,EAAE,sBAAsB,EAAE,CAAA;CACjC;AAED,MAAM,MAAM,iCAAiC,GAC3C,MAAM,OAAO,CAAC,uCAAuC,CAAC,CAAA;AAExD,MAAM,MAAM,wBAAwB,GAAG,MAAM,OAAO,CAAC,8BAA8B,CAAC,CAAA"}

package/dist/workflows/types.js

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

package/dist/workflows.d.ts

@@ -0,0 +1,5 @@
+import type { SmartbillDriftReconciler, SmartbillDriftReconcilerOptions, SmartbillProformaConversionPoller, SmartbillProformaConversionPollerOptions } from "./workflows/types.js";
+export type { SmartbillCandidateExternalRefRecorder, SmartbillCandidateExternalRefRecorderContext, SmartbillCandidateInvoice, SmartbillDriftFinding, SmartbillDriftFindingType, SmartbillDriftReconciler, SmartbillDriftReconcilerOptions, SmartbillDriftReconcilerResult, SmartbillKnownLocalDriftFinding, SmartbillMissingLocalDriftFinding, SmartbillProformaConversion, SmartbillProformaConversionPoller, SmartbillProformaConversionPollerOptions, SmartbillProformaConversionPollerResult, SmartbillReferenceParts, SmartbillRemoteDocument, SmartbillRemoteDocumentAccessors, SmartbillRemoteDocumentStatus, SmartbillWorkflowCandidateSource, SmartbillWorkflowDocumentType, SmartbillWorkflowError, SmartbillWorkflowExternalRef, SmartbillWorkflowInvoice, SmartbillWorkflowLogger, } from "./workflows/types.js";
+export declare function createSmartbillProformaConversionPoller(options: SmartbillProformaConversionPollerOptions): SmartbillProformaConversionPoller;
+export declare function createSmartbillDriftReconciler(options: SmartbillDriftReconcilerOptions): SmartbillDriftReconciler;
+//# sourceMappingURL=workflows.d.ts.map

package/dist/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../src/workflows.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEV,wBAAwB,EACxB,+BAA+B,EAI/B,iCAAiC,EACjC,wCAAwC,EASzC,MAAM,sBAAsB,CAAA;AAE7B,YAAY,EACV,qCAAqC,EACrC,4CAA4C,EAC5C,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACxB,+BAA+B,EAC/B,8BAA8B,EAC9B,+BAA+B,EAC/B,iCAAiC,EACjC,2BAA2B,EAC3B,iCAAiC,EACjC,wCAAwC,EACxC,uCAAuC,EACvC,uBAAuB,EACvB,uBAAuB,EACvB,gCAAgC,EAChC,6BAA6B,EAC7B,gCAAgC,EAChC,6BAA6B,EAC7B,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,sBAAsB,CAAA;AAE7B,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,wCAAwC,GAChD,iCAAiC,CA0DnC;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,+BAA+B,GACvC,wBAAwB,CAoF1B"}

package/dist/workflows.js

@@ -0,0 +1,229 @@
+import { discoverRemoteDocuments, paymentStatusToRemoteStatus, } from "./workflow-remote-discovery.js";
+import { loadSmartbillWorkflowRefs } from "./workflows/refs.js";
+import { createSpacedSmartbillClient, isSmartbillRateLimitError, } from "./workflows/spaced-client.js";
+export function createSmartbillProformaConversionPoller(options) {
+    return async () => {
+        const result = {
+            checked: 0,
+            converted: [],
+            skipped: [],
+            errors: [],
+        };
+        const client = createSpacedSmartbillClient(options.client, options.requestSpacingMs);
+        const refs = await loadSmartbillWorkflowRefs(options);
+        for (const ref of refs) {
+            const document = resolveReferenceParts(ref, options.companyVatCode);
+            if (document?.documentType !== "proforma")
+                continue;
+            result.checked += 1;
+            try {
+                const response = await client.listEstimateInvoices(document.companyVatCode, document.seriesName, document.number);
+                const convertedInvoices = convertedInvoicesFromResponse(response);
+                if (convertedInvoices.length === 0) {
+                    result.skipped.push({ ref, reason: "not_converted" });
+                    continue;
+                }
+                for (const smartbillInvoice of convertedInvoices) {
+                    if (!smartbillInvoice.series || !smartbillInvoice.number) {
+                        result.skipped.push({ ref, reason: "missing_converted_invoice_number" });
+                        continue;
+                    }
+                    const conversion = {
+                        proformaRef: ref,
+                        invoice: ref.invoice ?? null,
+                        companyVatCode: document.companyVatCode,
+                        proformaSeriesName: document.seriesName,
+                        proformaNumber: document.number,
+                        invoiceSeriesName: smartbillInvoice.series,
+                        invoiceNumber: smartbillInvoice.number,
+                        invoiceUrl: smartbillInvoice.url ?? null,
+                        response,
+                        smartbillInvoice,
+                    };
+                    await options.onConverted(ref, conversion);
+                    options.logger?.info?.("[smartbill] proforma conversion detected", conversion);
+                    result.converted.push(conversion);
+                }
+            }
+            catch (error) {
+                await recordWorkflowError(options, result.errors, { ref, error });
+                if (isSmartbillRateLimitError(error))
+                    break;
+            }
+        }
+        return result;
+    };
+}
+export function createSmartbillDriftReconciler(options) {
+    return async () => {
+        const result = {
+            checked: 0,
+            findings: [],
+            skipped: [],
+            errors: [],
+        };
+        const workflowOptions = {
+            ...options,
+            client: createSpacedSmartbillClient(options.client, options.requestSpacingMs),
+        };
+        const refs = await loadSmartbillWorkflowRefs(options);
+        let remoteDocuments;
+        try {
+            remoteDocuments = await loadRemoteDocuments(workflowOptions, refs);
+        }
+        catch (error) {
+            if (!isSmartbillRateLimitError(error))
+                throw error;
+            await recordWorkflowError(options, result.errors, { error });
+            return result;
+        }
+        const remoteDocumentMap = new Map((remoteDocuments ?? []).map((remote) => [documentKey(remote), remote]));
+        const hasTrustedRemoteInventory = options.listRemoteDocuments !== undefined;
+        const localDocuments = new Map();
+        for (const ref of refs) {
+            const document = resolveReferenceParts(ref, options.companyVatCode);
+            if (!document) {
+                result.skipped.push({ ref, reason: "missing_smartbill_reference" });
+                continue;
+            }
+            const key = documentKey(document);
+            localDocuments.set(key, document);
+            result.checked += 1;
+            try {
+                const remote = hasTrustedRemoteInventory
+                    ? (remoteDocumentMap.get(key) ?? { ...document, status: "missing" })
+                    : await verifyRemoteDocument(workflowOptions, ref, document);
+                if (remote.status === "missing" || remote.status === "deleted") {
+                    await recordFinding(options, result.findings, {
+                        type: "missing_remote",
+                        document,
+                        ref,
+                        invoice: ref.invoice ?? null,
+                        remote,
+                    });
+                }
+                else if (isVoidedRemote(remote.status) && ref.invoice?.status !== "void") {
+                    await recordFinding(options, result.findings, {
+                        type: "voided_remote",
+                        document,
+                        ref,
+                        invoice: ref.invoice ?? null,
+                        remote,
+                    });
+                }
+            }
+            catch (error) {
+                await recordWorkflowError(options, result.errors, { ref, error });
+                if (isSmartbillRateLimitError(error))
+                    return result;
+                await recordFinding(options, result.findings, {
+                    type: "missing_remote",
+                    document,
+                    ref,
+                    invoice: ref.invoice ?? null,
+                    remote: null,
+                    error,
+                });
+            }
+        }
+        for (const remote of remoteDocuments ?? []) {
+            if (!localDocuments.has(documentKey(remote))) {
+                await recordMissingLocalFinding(options, result.findings, {
+                    type: "missing_local",
+                    document: remote,
+                    remote,
+                });
+            }
+        }
+        return result;
+    };
+}
+async function loadRemoteDocuments(options, refs) {
+    if (options.listRemoteDocuments)
+        return options.listRemoteDocuments({ refs });
+    if (!options.discoverRemote)
+        return undefined;
+    return discoverRemoteDocuments(options.client, resolveDiscoveryCompanyVatCode(options, refs));
+}
+function resolveDiscoveryCompanyVatCode(options, refs) {
+    if (options.companyVatCode)
+        return options.companyVatCode;
+    const companyVatCodes = new Set(refs
+        .map((ref) => resolveReferenceParts(ref, options.companyVatCode)?.companyVatCode)
+        .filter((value) => typeof value === "string" && value.length > 0));
+    if (companyVatCodes.size === 1)
+        return [...companyVatCodes][0];
+    throw new Error("SmartBill remote discovery requires companyVatCode");
+}
+function convertedInvoicesFromResponse(response) {
+    if (Array.isArray(response.invoices) && response.invoices.length > 0) {
+        return response.invoices.filter((invoice) => invoice.series && invoice.number);
+    }
+    if (response.areInvoicesCreated && response.series && response.number) {
+        return [{ series: response.series, number: response.number }];
+    }
+    return [];
+}
+async function verifyRemoteDocument(options, ref, document) {
+    const verified = await (options.verifyRemoteDocument
+        ? options.verifyRemoteDocument({ ref, document })
+        : defaultVerifyRemoteDocument(options.client, document));
+    return typeof verified === "string" ? { ...document, status: verified } : verified;
+}
+async function defaultVerifyRemoteDocument(client, document) {
+    if (document.documentType === "proforma") {
+        await client.listEstimateInvoices(document.companyVatCode, document.seriesName, document.number);
+        return "present";
+    }
+    const status = await client.getPaymentStatus(document.companyVatCode, document.seriesName, document.number);
+    return paymentStatusToRemoteStatus(status);
+}
+function resolveReferenceParts(ref, fallbackCompanyVatCode) {
+    const metadata = coerceMetadata(ref.metadata);
+    const documentType = coerceDocumentType(metadata?.documentType);
+    const companyVatCode = metadataString(metadata, "companyVatCode") ??
+        metadataString(metadata, "vatCode") ??
+        fallbackCompanyVatCode;
+    const seriesName = metadataString(metadata, "series") ?? metadataString(metadata, "seriesName");
+    const number = metadataString(metadata, "number") ?? ref.externalNumber ?? ref.externalId;
+    if (!documentType || !companyVatCode || !seriesName || !number)
+        return null;
+    return { companyVatCode, seriesName, number, documentType };
+}
+function coerceMetadata(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function metadataString(metadata, key) {
+    const value = metadata?.[key];
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function coerceDocumentType(value) {
+    return value === "invoice" || value === "proforma" ? value : null;
+}
+function documentKey(document) {
+    return [
+        document.documentType,
+        document.companyVatCode,
+        document.seriesName,
+        document.number,
+    ].join(":");
+}
+function isVoidedRemote(status) {
+    return status === "voided" || status === "cancelled" || status === "reversed";
+}
+async function recordFinding(options, findings, finding) {
+    findings.push(finding);
+    options.logger?.info?.("[smartbill] drift finding", finding);
+    await options.onFinding?.(finding);
+}
+async function recordMissingLocalFinding(options, findings, finding) {
+    await recordFinding(options, findings, finding);
+    await options.onMissingLocal?.(finding);
+}
+async function recordWorkflowError(options, errors, error) {
+    errors.push(error);
+    options.logger?.error?.("[smartbill] workflow error", error);
+    await options.onError?.(error);
+}

package/package.json

@@ -0,0 +1,129 @@
+{
+  "name": "@voyant-travel/plugin-smartbill",
+  "version": "0.119.2",
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "default": "./dist/client.js"
+    },
+    "./mock": {
+      "types": "./dist/mock.d.ts",
+      "import": "./dist/mock.js",
+      "default": "./dist/mock.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "import": "./dist/plugin.js",
+      "default": "./dist/plugin.js"
+    },
+    "./hono": {
+      "types": "./dist/hono.d.ts",
+      "import": "./dist/hono.js",
+      "default": "./dist/hono.js"
+    },
+    "./sync": {
+      "types": "./dist/sync.d.ts",
+      "import": "./dist/sync.js",
+      "default": "./dist/sync.js"
+    },
+    "./invoice-ui": {
+      "types": "./dist/invoice-ui.d.ts",
+      "import": "./dist/invoice-ui.js",
+      "default": "./dist/invoice-ui.js"
+    },
+    "./settlement": {
+      "types": "./dist/settlement.d.ts",
+      "import": "./dist/settlement.js",
+      "default": "./dist/settlement.js"
+    },
+    "./workflows": {
+      "types": "./dist/workflows.d.ts",
+      "import": "./dist/workflows.js",
+      "default": "./dist/workflows.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
+    }
+  },
+  "dependencies": {
+    "drizzle-orm": "^0.45.2",
+    "hono": "^4.12.10",
+    "zod": "^4.3.6",
+    "@voyant-travel/storage": "^0.104.1",
+    "@voyant-travel/utils": "^0.105.1",
+    "@voyant-travel/finance": "^0.119.5",
+    "@voyant-travel/hono": "^0.109.1",
+    "@voyant-travel/core": "^0.109.0"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "lucide-react": "^0.475.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@voyant-travel/finance-react": "^0.119.5",
+    "@voyant-travel/ui": "^0.106.1"
+  },
+  "peerDependenciesMeta": {
+    "@tanstack/react-query": {
+      "optional": true
+    },
+    "@voyant-travel/finance-react": {
+      "optional": true
+    },
+    "@voyant-travel/ui": {
+      "optional": true
+    },
+    "lucide-react": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.100.11",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "lucide-react": "^0.475.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2",
+    "@voyant-travel/ui": "^0.106.1",
+    "@voyant-travel/voyant-typescript-config": "^0.1.0",
+    "@voyant-travel/finance-react": "^0.119.5"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/voyant-travel/voyant.git",
+    "directory": "packages/plugins/smartbill"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src/",
+    "test": "vitest run",
+    "build": "pnpm run clean && tsc -p tsconfig.json",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}