@voyant-travel/plugin-smartbill 0.119.2

package/dist/mock.js

@@ -0,0 +1,431 @@
+import { concat, importNodeHttp } from "./mock/node.js";
+import { createPlaceholderPdf } from "./mock/pdf.js";
+const defaultTaxes = [
+    { name: "Normala", percentage: 19, default: true },
+    { name: "Redusa", percentage: 9 },
+    { name: "Redusa", percentage: 5 },
+    { name: "Scutit", percentage: 0 },
+];
+const defaultSeries = [
+    { name: "SB-TEST", type: "invoice", nextNumber: 1 },
+    { name: "PF-TEST", type: "estimate", nextNumber: 1 },
+];
+export function createSmartbillMockServer(options = {}) {
+    const documents = new Map();
+    const taxes = options.taxes ?? defaultTaxes;
+    const initialSeries = options.series ?? defaultSeries;
+    const seriesCounters = new Map();
+    const now = options.now ?? (() => new Date());
+    function reset() {
+        documents.clear();
+        seriesCounters.clear();
+        for (const item of initialSeries) {
+            seriesCounters.set(seriesKey(item.type, item.name), { ...item });
+        }
+    }
+    function listDocuments() {
+        return [...documents.values()].map(cloneDocument);
+    }
+    function getDocument(kind, companyVatCode, seriesName, number) {
+        const document = documents.get(documentKey(kind, companyVatCode, seriesName, number));
+        return document ? cloneDocument(document) : null;
+    }
+    function convertEstimateToInvoice(args) {
+        const estimate = findRequiredDocument("estimate", args.companyVatCode, args.seriesName, args.number);
+        const invoice = createDocument("invoice", {
+            ...estimate.body,
+            seriesName: args.invoiceSeriesName ?? estimate.body.seriesName,
+            mentions: appendTestMention(estimate.body.mentions, `Converted from proforma ${args.seriesName}-${args.number}`),
+        });
+        const response = toCreateResponse(invoice);
+        estimate.convertedInvoices.push(response);
+        documents.set(documentKey(estimate.kind, estimate.companyVatCode, estimate.seriesName, estimate.number), estimate);
+        return response;
+    }
+    async function handleRequest(request) {
+        const method = request.method.toUpperCase();
+        const url = new URL(request.url, "http://smartbill-mock.local");
+        const path = normalizeSmartbillPath(url.pathname);
+        try {
+            if (method === "GET" && path === "/tax")
+                return json(200, taxesEnvelope(taxes));
+            if (method === "GET" && path === "/series")
+                return json(200, seriesEnvelope(listSeries()));
+            if (method === "POST" && path === "/invoice") {
+                const body = parseBody(request.body);
+                if (body.useEstimateDetails === true && body.estimate) {
+                    return json(200, convertEstimateToInvoice({
+                        companyVatCode: body.companyVatCode,
+                        seriesName: body.estimate.seriesName,
+                        number: body.estimate.number,
+                        invoiceSeriesName: body.seriesName,
+                    }));
+                }
+                return json(200, toCreateResponse(createDocument("invoice", body)));
+            }
+            if (method === "POST" && path === "/estimate") {
+                return json(200, toCreateResponse(createDocument("estimate", parseBody(request.body))));
+            }
+            if (method === "GET" && path === "/invoice/pdf") {
+                return pdf(findByQuery("invoice", url));
+            }
+            if (method === "GET" && path === "/estimate/pdf") {
+                return pdf(findByQuery("estimate", url));
+            }
+            if (method === "GET" && path === "/estimate/invoices") {
+                return json(200, estimateInvoicesEnvelope(findByQuery("estimate", url)));
+            }
+            if (method === "GET" && path === "/invoice/paymentstatus") {
+                return json(200, paymentStatusEnvelope(findByQuery("invoice", url)));
+            }
+            if (method === "PUT" && path === "/invoice/cancel") {
+                const invoice = updateInvoiceStatus(parseBody(request.body), "cancelled");
+                return json(200, ackEnvelope(`Invoice ${invoice.seriesName}-${invoice.number} cancelled`));
+            }
+            if (method === "PUT" && path === "/invoice/reverse") {
+                const invoice = updateInvoiceStatus(parseBody(request.body), "reversed");
+                const reversal = createDocument("invoice", {
+                    ...invoice.body,
+                    products: invoice.body.products.map((product) => ({
+                        ...product,
+                        quantity: -Math.abs(product.quantity),
+                    })),
+                    mentions: appendTestMention(invoice.body.mentions, `Reversal for ${invoice.seriesName}-${invoice.number}`),
+                });
+                return json(200, toCreateResponse(reversal));
+            }
+            if (method === "PUT" && path === "/invoice/restore") {
+                const invoice = updateInvoiceStatus(parseBody(request.body), "restored");
+                return json(200, ackEnvelope(`Invoice ${invoice.seriesName}-${invoice.number} restored`));
+            }
+            if (method === "DELETE" && path === "/invoice") {
+                const invoice = updateByQuery(url, "deleted");
+                return json(200, ackEnvelope(`Invoice ${invoice.seriesName}-${invoice.number} deleted`));
+            }
+            return json(404, errorEnvelope(`SmartBill mock endpoint not found: ${method} ${path}`));
+        }
+        catch (error) {
+            return json(error instanceof SmartbillMockError ? error.status : 500, errorEnvelope(error instanceof Error ? error.message : "SmartBill mock failed"));
+        }
+    }
+    const fetch = async (input, init) => {
+        const response = await handleRequest({
+            method: init.method,
+            url: input,
+            body: init.body,
+        });
+        const isBinary = response.body instanceof Uint8Array;
+        const bytes = isBinary
+            ? response.body
+            : new TextEncoder().encode(response.body);
+        const text = isBinary
+            ? new TextDecoder().decode(response.body)
+            : response.body;
+        return {
+            ok: response.status >= 200 && response.status < 300,
+            status: response.status,
+            json: async () => {
+                if (isBinary)
+                    throw new Error("SmartBill mock response is not JSON");
+                return JSON.parse(text);
+            },
+            text: async () => text,
+            arrayBuffer: async () => {
+                const copy = new ArrayBuffer(bytes.byteLength);
+                new Uint8Array(copy).set(bytes);
+                return copy;
+            },
+            headers: {
+                get: (name) => response.headers[name.toLowerCase()] ?? null,
+            },
+        };
+    };
+    async function listen(listenOptions = {}) {
+        const { createServer } = await importNodeHttp();
+        const hostname = listenOptions.hostname ?? "127.0.0.1";
+        const server = createServer(async (req, res) => {
+            const chunks = [];
+            for await (const chunk of req) {
+                chunks.push(typeof chunk === "string" ? new TextEncoder().encode(chunk) : chunk);
+            }
+            const host = Array.isArray(req.headers.host) ? req.headers.host[0] : req.headers.host;
+            const requestUrl = new URL(req.url ?? "/", `http://${host ?? hostname}`);
+            const response = await handleRequest({
+                method: req.method ?? "GET",
+                url: requestUrl.toString(),
+                body: new TextDecoder().decode(concat(chunks)),
+            });
+            for (const [key, value] of Object.entries(response.headers)) {
+                res.setHeader(key, value);
+            }
+            res.statusCode = response.status;
+            res.end(response.body);
+        });
+        await new Promise((resolve, reject) => {
+            server.once("error", reject);
+            server.listen(listenOptions.port ?? 0, hostname, () => {
+                server.off("error", reject);
+                resolve();
+            });
+        });
+        const address = server.address();
+        if (!address || typeof address === "string") {
+            server.close();
+            throw new Error("SmartBill mock server failed to resolve its listening address");
+        }
+        return {
+            apiUrl: `http://${hostname}:${address.port}`,
+            close: () => new Promise((resolve, reject) => {
+                server.close((error) => (error ? reject(error) : resolve()));
+            }),
+        };
+    }
+    function createDocument(kind, body) {
+        const seriesName = body.seriesName;
+        const number = nextNumber(kind, seriesName);
+        const companyVatCode = body.companyVatCode;
+        const total = totalAmount(body, taxes);
+        const paid = paidAmount(body, total);
+        const payments = body.payment
+            ? [
+                {
+                    type: body.payment.type,
+                    value: paid,
+                    paidDate: now().toISOString().slice(0, 10),
+                    isCash: body.payment.isCash,
+                },
+            ]
+            : [];
+        const document = {
+            kind,
+            companyVatCode,
+            seriesName,
+            number,
+            status: "issued",
+            body: {
+                ...body,
+                mentions: appendTestMention(body.mentions, "TEST DOCUMENT - SmartBill local mock"),
+            },
+            url: `smartbill-mock://test-document/${kind}/${encodeURIComponent(companyVatCode)}/${encodeURIComponent(seriesName)}/${number}.pdf`,
+            total,
+            paidAmount: paid,
+            payments,
+            createdAt: now().toISOString(),
+            convertedInvoices: [],
+        };
+        documents.set(documentKey(kind, companyVatCode, seriesName, number), document);
+        return document;
+    }
+    function nextNumber(kind, seriesName) {
+        const key = seriesKey(kind, seriesName);
+        const series = seriesCounters.get(key) ?? { name: seriesName, type: kind, nextNumber: 1 };
+        const number = String(series.nextNumber);
+        seriesCounters.set(key, { ...series, nextNumber: series.nextNumber + 1 });
+        return number;
+    }
+    function listSeries() {
+        return [...seriesCounters.values()].map((item) => ({ ...item }));
+    }
+    function findByQuery(kind, url) {
+        const companyVatCode = url.searchParams.get("cif") ?? url.searchParams.get("companyVatCode");
+        const seriesName = url.searchParams.get("seriesname") ?? url.searchParams.get("seriesName");
+        const number = url.searchParams.get("number");
+        if (!companyVatCode || !seriesName || !number) {
+            throw new SmartbillMockError(400, "SmartBill mock request is missing cif, seriesname, or number");
+        }
+        return findRequiredDocument(kind, companyVatCode, seriesName, number);
+    }
+    function findRequiredDocument(kind, companyVatCode, seriesName, number) {
+        const document = documents.get(documentKey(kind, companyVatCode, seriesName, number));
+        if (!document) {
+            throw new SmartbillMockError(404, `SmartBill mock ${kind} not found: ${seriesName}-${number}`);
+        }
+        return document;
+    }
+    function updateInvoiceStatus(body, status) {
+        const reference = parseInvoiceReference(body);
+        const invoice = findRequiredDocument("invoice", reference.companyVatCode, reference.seriesName, reference.number);
+        invoice.status = status;
+        documents.set(documentKey("invoice", reference.companyVatCode, reference.seriesName, reference.number), invoice);
+        return invoice;
+    }
+    function updateByQuery(url, status) {
+        const invoice = findByQuery("invoice", url);
+        invoice.status = status;
+        documents.set(documentKey("invoice", invoice.companyVatCode, invoice.seriesName, invoice.number), invoice);
+        return invoice;
+    }
+    function pdf(document) {
+        const label = `${document.kind === "estimate" ? "Proforma" : "Invoice"} ${document.seriesName}-${document.number} (TEST)`;
+        return {
+            status: 200,
+            headers: {
+                "access-control-allow-origin": "*",
+                "content-type": "application/pdf",
+                "content-disposition": `inline; filename="${document.seriesName}-${document.number}.pdf"`,
+                "x-mock-pdf-url": document.url,
+            },
+            body: createPlaceholderPdf(label),
+        };
+    }
+    reset();
+    return {
+        fetch,
+        handleRequest,
+        listen,
+        reset,
+        listDocuments,
+        getDocument,
+        convertEstimateToInvoice,
+    };
+}
+class SmartbillMockError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+function normalizeSmartbillPath(pathname) {
+    return pathname.replace(/^\/SBORO\/api/, "") || "/";
+}
+function json(status, payload) {
+    return {
+        status,
+        headers: {
+            "access-control-allow-origin": "*",
+            "content-type": "application/json; charset=utf-8",
+        },
+        body: JSON.stringify(payload),
+    };
+}
+function parseBody(body) {
+    if (!body)
+        throw new SmartbillMockError(400, "SmartBill mock request requires a JSON body");
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        throw new SmartbillMockError(400, "SmartBill mock request body is not valid JSON");
+    }
+}
+function parseInvoiceReference(body) {
+    const value = body;
+    if (typeof value.companyVatCode !== "string" ||
+        typeof value.seriesName !== "string" ||
+        typeof value.number !== "string") {
+        throw new SmartbillMockError(400, "SmartBill mock invoice reference requires companyVatCode, seriesName, and number");
+    }
+    return {
+        companyVatCode: value.companyVatCode,
+        seriesName: value.seriesName,
+        number: value.number,
+    };
+}
+function totalAmount(body, taxes) {
+    return roundMoney(body.products.reduce((total, product) => {
+        const lineNet = product.price * product.quantity;
+        if (product.isTaxIncluded)
+            return total + lineNet;
+        return total + lineNet * (1 + taxPercentage(product.taxPercentage, taxes) / 100);
+    }, 0));
+}
+function taxPercentage(lineTaxPercentage, taxes) {
+    if (typeof lineTaxPercentage === "number" && Number.isFinite(lineTaxPercentage)) {
+        return lineTaxPercentage;
+    }
+    return taxes.find((tax) => tax.default)?.percentage ?? defaultTaxes[0]?.percentage ?? 0;
+}
+function paidAmount(body, total) {
+    return roundMoney(Math.min(total, body.payment?.value ?? 0));
+}
+function toCreateResponse(document) {
+    return {
+        status: "Ok",
+        message: "",
+        errorText: "",
+        series: document.seriesName,
+        number: document.number,
+        url: document.url,
+    };
+}
+function ackEnvelope(message) {
+    return { status: "Ok", message, errorText: "" };
+}
+function errorEnvelope(message) {
+    return { status: "Error", message: "", errorText: message };
+}
+function taxesEnvelope(taxes) {
+    return {
+        status: "Ok",
+        message: "",
+        errorText: "",
+        taxes: taxes.map(({ name, percentage }) => ({ name, percentage })),
+    };
+}
+function seriesEnvelope(series) {
+    return {
+        status: "Ok",
+        message: "",
+        errorText: "",
+        list: series.map((item) => ({
+            name: item.name,
+            nextNumber: item.nextNumber,
+            type: item.type === "invoice" ? "f" : "p",
+        })),
+    };
+}
+function paymentStatusEnvelope(document) {
+    const unpaid = Math.max(0, roundMoney(document.total - document.paidAmount));
+    return {
+        status: "Ok",
+        message: paymentStatusMessage(document),
+        errorText: "",
+        paid: document.total > 0 && document.paidAmount >= document.total,
+        invoiceTotalAmount: document.total,
+        paidAmount: document.paidAmount,
+        unpaidAmount: unpaid,
+        payments: document.payments.map((entry) => ({ ...entry })),
+    };
+}
+function paymentStatusMessage(document) {
+    if (document.status === "cancelled")
+        return "Invoice cancelled";
+    if (document.status === "deleted")
+        return "Invoice deleted";
+    if (document.status === "reversed")
+        return "Invoice reversed";
+    return "";
+}
+function estimateInvoicesEnvelope(estimate) {
+    const last = estimate.convertedInvoices[estimate.convertedInvoices.length - 1];
+    return {
+        status: "Ok",
+        message: "",
+        errorText: "",
+        series: last?.series ?? "",
+        number: last?.number ?? "",
+        areInvoicesCreated: estimate.convertedInvoices.length > 0,
+        invoices: estimate.convertedInvoices.map((invoice) => ({ ...invoice })),
+    };
+}
+function appendTestMention(existing, mention) {
+    return existing ? `${existing}\n${mention}` : mention;
+}
+function seriesKey(kind, seriesName) {
+    return `${kind}:${seriesName}`;
+}
+function documentKey(kind, companyVatCode, seriesName, number) {
+    return `${kind}:${companyVatCode}:${seriesName}:${number}`;
+}
+function cloneDocument(document) {
+    return {
+        ...document,
+        body: structuredClone(document.body),
+        payments: document.payments.map((entry) => ({ ...entry })),
+        convertedInvoices: document.convertedInvoices.map((invoice) => ({ ...invoice })),
+    };
+}
+function roundMoney(value) {
+    return Math.round(value * 100) / 100;
+}

package/dist/plugin.d.ts

@@ -0,0 +1,55 @@
+import type { Plugin } from "@voyant-travel/core";
+import type { SmartbillArtifactPersistenceOptions } from "./artifacts.js";
+import type { SmartbillClientOptions } from "./client.js";
+import type { SmartbillMappingOptions } from "./mapping.js";
+import type { SmartbillInvoiceBody, SmartbillInvoiceResponse, VoyantInvoiceEvent } from "./types.js";
+export interface SmartbillSyncEventNames {
+    issued?: string;
+    proformaIssued?: string;
+    proformaConverted?: string;
+    voided?: string;
+    syncRequested?: string;
+}
+export interface SmartbillLogger {
+    error: (message: string, meta?: unknown) => void;
+    info?: (message: string, meta?: unknown) => void;
+}
+export type SmartbillMapFn = (event: VoyantInvoiceEvent) => SmartbillInvoiceBody | Promise<SmartbillInvoiceBody>;
+export interface SmartbillIdempotencyOptions {
+    /**
+     * When artifact DB access is configured, skip SmartBill create calls for
+     * duplicate invoice events that already have a non-error SmartBill ref.
+     * Defaults to true.
+     */
+    skipExistingExternalRef?: boolean;
+}
+export type SmartbillErrorHandler = (event: VoyantInvoiceEvent, error: unknown) => void | Promise<void>;
+export type SmartbillInvoiceNumberWriteBackFormatter = (event: VoyantInvoiceEvent, result: SmartbillInvoiceResponse) => string | Promise<string>;
+export interface SmartbillPluginOptions extends SmartbillClientOptions, SmartbillMappingOptions {
+    events?: SmartbillSyncEventNames;
+    mapEvent?: SmartbillMapFn;
+    logger?: SmartbillLogger;
+    idempotency?: SmartbillIdempotencyOptions;
+    onError?: SmartbillErrorHandler;
+    /**
+     * When enabled, mirrors SmartBill's issued series-number back onto
+     * `invoices.invoice_number` after a successful create. `true` uses
+     * `${series}-${number}`; a formatter can return a custom value.
+     */
+    writeBackInvoiceNumber?: boolean | SmartbillInvoiceNumberWriteBackFormatter;
+    /**
+     * Optional finance artifact persistence. When `db` is supplied, the plugin
+     * registers the SmartBill external ref after creation. When
+     * `documentStorage` is also supplied, it downloads and stores the generated
+     * SmartBill PDF as both an invoice rendition and attachment.
+     */
+    artifacts?: SmartbillArtifactPersistenceOptions;
+    /** @deprecated Use `artifacts.db`. */
+    db?: SmartbillArtifactPersistenceOptions["db"];
+    /** @deprecated Use `artifacts.documentStorage`. */
+    documentStorage?: SmartbillArtifactPersistenceOptions["documentStorage"];
+    /** @deprecated Use `artifacts.documentStorageKeyPrefix`. */
+    documentStorageKeyPrefix?: SmartbillArtifactPersistenceOptions["documentStorageKeyPrefix"];
+}
+export declare function smartbillPlugin(options: SmartbillPluginOptions): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,qBAAqB,CAAA;AAI7D,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,gBAAgB,CAAA;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAO3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAGpG,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IAChD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CACjD;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,kBAAkB,KACtB,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;AAEzD,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAClC;AAED,MAAM,MAAM,qBAAqB,GAAG,CAClC,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,OAAO,KACX,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEzB,MAAM,MAAM,wCAAwC,GAAG,CACrD,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,wBAAwB,KAC7B,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;AAE7B,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB,EAAE,uBAAuB;IAC7F,MAAM,CAAC,EAAE,uBAAuB,CAAA;IAChC,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,MAAM,CAAC,EAAE,eAAe,CAAA;IACxB,WAAW,CAAC,EAAE,2BAA2B,CAAA;IACzC,OAAO,CAAC,EAAE,qBAAqB,CAAA;IAC/B;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,GAAG,wCAAwC,CAAA;IAC3E;;;;;OAKG;IACH,SAAS,CAAC,EAAE,mCAAmC,CAAA;IAC/C,sCAAsC;IACtC,EAAE,CAAC,EAAE,mCAAmC,CAAC,IAAI,CAAC,CAAA;IAC9C,mDAAmD;IACnD,eAAe,CAAC,EAAE,mCAAmC,CAAC,iBAAiB,CAAC,CAAA;IACxE,4DAA4D;IAC5D,wBAAwB,CAAC,EAAE,mCAAmC,CAAC,0BAA0B,CAAC,CAAA;CAC3F;AAmBD,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAmLvE"}

package/dist/plugin.js

@@ -0,0 +1,192 @@
+import { financeService } from "@voyant-travel/finance";
+import { createSmartbillSyncRuntime } from "./runtime.js";
+import { syncSmartbillInvoiceEvent, syncSmartbillInvoiceVoidEvent, syncSmartbillProformaConversion, } from "./sync.js";
+import { parseSmartbillPluginOptions } from "./validation.js";
+function resolveStaticArtifactDb(db) {
+    if (!db || typeof db === "function")
+        return null;
+    return db;
+}
+function coerceEvent(data) {
+    if (data == null || typeof data !== "object")
+        return null;
+    const maybe = data;
+    if (typeof maybe.id === "string")
+        return maybe;
+    if (typeof maybe.invoiceId === "string") {
+        return { ...maybe, id: maybe.invoiceId };
+    }
+    return null;
+}
+export function smartbillPlugin(options) {
+    const validatedOptions = parseSmartbillPluginOptions(options);
+    const runtime = createSmartbillSyncRuntime(validatedOptions);
+    const { client, logger, eventNames } = runtime;
+    async function ensureNumberSeries() {
+        const db = resolveStaticArtifactDb(runtime.artifacts.db);
+        if (!db || typeof validatedOptions.seriesName !== "string")
+            return;
+        try {
+            await financeService.ensureExternalInvoiceNumberSeries(db, [
+                {
+                    provider: "smartbill",
+                    scope: "invoice",
+                    code: "smartbill-invoice",
+                    name: "SmartBill invoices",
+                    externalConfigKey: validatedOptions.seriesName,
+                    isDefault: true,
+                },
+                {
+                    provider: "smartbill",
+                    scope: "proforma",
+                    code: "smartbill-proforma",
+                    name: "SmartBill proformas",
+                    externalConfigKey: validatedOptions.seriesName,
+                    isDefault: true,
+                },
+            ]);
+        }
+        catch (error) {
+            logger.error("[smartbill] invoice number series bootstrap failed", error);
+        }
+    }
+    async function resolveConfiguredSeriesName(event) {
+        const value = validatedOptions.seriesName;
+        return typeof value === "function" ? await value(event) : value;
+    }
+    async function resolveExternalSeriesName(event) {
+        return typeof event.externalSeriesName === "string"
+            ? event.externalSeriesName
+            : await resolveConfiguredSeriesName(event);
+    }
+    const subscribers = [
+        {
+            event: eventNames.issued,
+            handler: async (envelope) => {
+                const event = coerceEvent(envelope.data);
+                if (!event)
+                    return;
+                if (event.skipExternalSync === true) {
+                    logger.info?.(`[smartbill] skipping invoice ${event.id} (skipExternalSync=true)`);
+                    return;
+                }
+                if (typeof event.convertedFromInvoiceId === "string" && event.convertedFromInvoiceId) {
+                    logger.info?.(`[smartbill] skipping invoice create for converted proforma ${event.id}; waiting for "${eventNames.proformaConverted}"`);
+                    return;
+                }
+                try {
+                    await syncSmartbillInvoiceEvent({
+                        event,
+                        documentType: "invoice",
+                        runtime,
+                        pluginOptions: validatedOptions,
+                        operationLabel: `createInvoice on "${eventNames.issued}"`,
+                    });
+                }
+                catch {
+                    // `syncSmartbillInvoiceEvent` logs and records retryable state.
+                }
+            },
+        },
+        {
+            event: eventNames.proformaIssued,
+            handler: async (envelope) => {
+                const event = coerceEvent(envelope.data);
+                if (!event)
+                    return;
+                if (event.skipExternalSync === true) {
+                    logger.info?.(`[smartbill] skipping proforma ${event.id} (skipExternalSync=true)`);
+                    return;
+                }
+                try {
+                    await syncSmartbillInvoiceEvent({
+                        event,
+                        documentType: "proforma",
+                        runtime,
+                        pluginOptions: validatedOptions,
+                        operationLabel: `createProforma on "${eventNames.proformaIssued}"`,
+                    });
+                }
+                catch {
+                    // `syncSmartbillInvoiceEvent` logs and records retryable state.
+                }
+            },
+        },
+        {
+            event: eventNames.proformaConverted,
+            handler: async (envelope) => {
+                const event = coerceEvent(envelope.data);
+                if (!event)
+                    return;
+                if (event.skipExternalSync === true) {
+                    logger.info?.(`[smartbill] skipping proforma conversion ${event.id} (skipExternalSync=true)`);
+                    return;
+                }
+                try {
+                    await syncSmartbillProformaConversion({
+                        event,
+                        runtime,
+                        pluginOptions: validatedOptions,
+                    });
+                }
+                catch {
+                    // `syncSmartbillProformaConversion` logs and records retryable state.
+                }
+            },
+        },
+        {
+            event: eventNames.voided,
+            handler: async (envelope) => {
+                const event = coerceEvent(envelope.data);
+                if (!event)
+                    return;
+                try {
+                    await syncSmartbillInvoiceVoidEvent({
+                        event,
+                        runtime,
+                        pluginOptions: validatedOptions,
+                    });
+                }
+                catch {
+                    // `syncSmartbillInvoiceVoidEvent` logs and records retryable state.
+                }
+            },
+        },
+        {
+            event: eventNames.syncRequested,
+            handler: async (envelope) => {
+                const event = coerceEvent(envelope.data);
+                if (!event)
+                    return;
+                try {
+                    const seriesName = await resolveExternalSeriesName(event);
+                    const number = typeof event.externalNumber === "string"
+                        ? event.externalNumber
+                        : typeof event.invoiceNumber === "string"
+                            ? event.invoiceNumber
+                            : undefined;
+                    if (!number) {
+                        logger.error(`[smartbill] cannot sync invoice ${event.id}: missing external number`);
+                        return;
+                    }
+                    const status = await client.getPaymentStatus(validatedOptions.companyVatCode, seriesName, number);
+                    const paymentLabel = status.paid
+                        ? "paid"
+                        : (status.paidAmount ?? 0) > 0
+                            ? "partially_paid"
+                            : "unpaid";
+                    logger.info?.(`[smartbill] payment status for ${seriesName}-${number}: ${paymentLabel}`, status);
+                }
+                catch (err) {
+                    logger.error(`[smartbill] getPaymentStatus on "${eventNames.syncRequested}" failed for ${event.id}`, err);
+                }
+            },
+        },
+    ];
+    return {
+        name: "smartbill",
+        version: "0.1.0",
+        bootstrap: ensureNumberSeries,
+        subscribers,
+    };
+}