@voyantjs/plugin-smartbill 0.25.0 → 0.26.1

package/README.md

@@ -50,8 +50,69 @@ contract.
 | `.` | Barrel re-exports |
 | `./plugin` | `smartbillPlugin(options)` — packaged adapter/subscriber bundle |
 | `./client` | `createSmartbillClient` — `createInvoice`, `cancelInvoice`, `viewPdf`, `getPaymentStatus`, etc. |
+| `./mock` | `createSmartbillMockServer` — stateful local SmartBill-compatible mock for tests |
 | `./types` | SmartBill adapter and bundle types |
 
+## Local SmartBill Mock
+
+SmartBill does not provide a practical sandbox, and invoice/proforma calls can
+create real accounting documents. Use the packaged mock for local workflows and
+end-to-end tests instead of pointing development credentials at the live API.
+
+For in-process tests, pass the mock `fetch` implementation and any local
+`apiUrl`:
+
+```typescript
+import { createSmartbillClient } from "@voyantjs/plugin-smartbill/client"
+import { createSmartbillMockServer } from "@voyantjs/plugin-smartbill/mock"
+
+const smartbill = createSmartbillMockServer()
+const client = createSmartbillClient({
+  username: "local",
+  apiToken: "local",
+  apiUrl: "http://smartbill.local/SBORO/api",
+  fetch: smartbill.fetch,
+})
+```
+
+For full app tests, start the local HTTP listener and wire the plugin/client to
+the returned base URL:
+
+```typescript
+const smartbill = createSmartbillMockServer()
+const server = await smartbill.listen({ port: 4555 })
+
+const plugin = smartbillPlugin({
+  username: "local",
+  apiToken: "local",
+  apiUrl: server.apiUrl,
+  companyVatCode: "RO12345678",
+  seriesName: "SB-TEST",
+})
+
+await server.close()
+```
+
+The mock supports the SmartBill endpoints used by the plugin and common local
+billing flows:
+
+- `GET /tax`
+- `GET /series`
+- `POST /invoice`
+- `GET /invoice/pdf`
+- `GET /invoice/paymentstatus`
+- `PUT /invoice/cancel`
+- `PUT /invoice/reverse`
+- `PUT /invoice/restore`
+- `DELETE /invoice`
+- `POST /estimate`
+- `GET /estimate/pdf`
+- `GET /estimate/invoices`
+
+Documents are stateful and deterministic per series. Generated PDF URLs use the
+`smartbill-mock://test-document/...` scheme, and stored document mentions are
+marked with `TEST DOCUMENT - SmartBill local mock`.
+
 ## License
 
 Apache-2.0

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export type { SmartbillClientApi, SmartbillClientOptions } from "./client.js";
 export { createSmartbillClient } from "./client.js";
 export type { SmartbillMappingOptions } from "./mapping.js";
 export { mapClient, mapLineItems, mapVoyantInvoiceToSmartbill } from "./mapping.js";
+export type { SmartbillMockDocument, SmartbillMockDocumentKind, SmartbillMockDocumentStatus, SmartbillMockListenOptions, SmartbillMockRequest, SmartbillMockResponse, SmartbillMockSeries, SmartbillMockServer, SmartbillMockServerHandle, SmartbillMockServerOptions, SmartbillMockTax, } from "./mock.js";
+export { createSmartbillMockServer } from "./mock.js";
 export type { SmartbillLogger, SmartbillMapFn, SmartbillPluginOptions, SmartbillSyncEventNames, } from "./plugin.js";
 export { smartbillPlugin } from "./plugin.js";
 export type { ResolvedSmartbillSyncEventNames, SmartbillSyncRuntime } from "./runtime.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAA;AACnF,YAAY,EACV,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,YAAY,EAAE,+BAA+B,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,YAAY,EACV,gCAAgC,EAChC,uCAAuC,EACvC,8BAA8B,EAC9B,0BAA0B,EAC1B,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,sCAAsC,EAAE,MAAM,iBAAiB,CAAA;AACxE,YAAY,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAA;AACnF,YAAY,EACV,qBAAqB,EACrB,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAA;AACrD,YAAY,EACV,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,YAAY,EAAE,+BAA+B,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,YAAY,EACV,gCAAgC,EAChC,uCAAuC,EACvC,8BAA8B,EAC9B,0BAA0B,EAC1B,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,sCAAsC,EAAE,MAAM,iBAAiB,CAAA;AACxE,YAAY,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export { createSmartbillClient } from "./client.js";
 export { mapClient, mapLineItems, mapVoyantInvoiceToSmartbill } from "./mapping.js";
+export { createSmartbillMockServer } from "./mock.js";
 export { smartbillPlugin } from "./plugin.js";
 export { createSmartbillSyncRuntime } from "./runtime.js";
 export { createSmartbillInvoiceSettlementPoller } from "./settlement.js";

package/dist/mock.d.ts

@@ -0,0 +1,65 @@
+import type { SmartbillFetch, SmartbillInvoiceBody, SmartbillInvoiceResponse } from "./types.js";
+export type SmartbillMockDocumentKind = "invoice" | "estimate";
+export type SmartbillMockDocumentStatus = "issued" | "cancelled" | "deleted" | "reversed" | "restored";
+export interface SmartbillMockTax {
+    name: string;
+    percentage: number;
+    default?: boolean;
+}
+export interface SmartbillMockSeries {
+    name: string;
+    type: SmartbillMockDocumentKind;
+    nextNumber: number;
+}
+export interface SmartbillMockDocument {
+    kind: SmartbillMockDocumentKind;
+    companyVatCode: string;
+    seriesName: string;
+    number: string;
+    status: SmartbillMockDocumentStatus;
+    body: SmartbillInvoiceBody;
+    url: string;
+    total: number;
+    paidAmount: number;
+    createdAt: string;
+    convertedInvoices: SmartbillInvoiceResponse[];
+}
+export interface SmartbillMockServerOptions {
+    taxes?: SmartbillMockTax[];
+    series?: SmartbillMockSeries[];
+    now?: () => Date;
+}
+export interface SmartbillMockListenOptions {
+    port?: number;
+    hostname?: string;
+}
+export interface SmartbillMockServerHandle {
+    apiUrl: string;
+    close: () => Promise<void>;
+}
+export interface SmartbillMockRequest {
+    method: string;
+    url: string;
+    body?: string;
+}
+export interface SmartbillMockResponse {
+    status: number;
+    headers: Record<string, string>;
+    body: string;
+}
+export interface SmartbillMockServer {
+    fetch: SmartbillFetch;
+    handleRequest: (request: SmartbillMockRequest) => Promise<SmartbillMockResponse>;
+    listen: (options?: SmartbillMockListenOptions) => Promise<SmartbillMockServerHandle>;
+    reset: () => void;
+    listDocuments: () => SmartbillMockDocument[];
+    getDocument: (kind: SmartbillMockDocumentKind, companyVatCode: string, seriesName: string, number: string) => SmartbillMockDocument | null;
+    convertEstimateToInvoice: (args: {
+        companyVatCode: string;
+        seriesName: string;
+        number: string;
+        invoiceSeriesName?: string;
+    }) => SmartbillInvoiceResponse;
+}
+export declare function createSmartbillMockServer(options?: SmartbillMockServerOptions): SmartbillMockServer;
+//# sourceMappingURL=mock.d.ts.map

package/dist/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AAEhG,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,UAAU,CAAA;AAE9D,MAAM,MAAM,2BAA2B,GACnC,QAAQ,GACR,WAAW,GACX,SAAS,GACT,UAAU,GACV,UAAU,CAAA;AAEd,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,yBAAyB,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,yBAAyB,CAAA;IAC/B,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,2BAA2B,CAAA;IACnC,IAAI,EAAE,oBAAoB,CAAA;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB,EAAE,wBAAwB,EAAE,CAAA;CAC9C;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC1B,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC9B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,cAAc,CAAA;IACrB,aAAa,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAChF,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,0BAA0B,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAA;IACpF,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,aAAa,EAAE,MAAM,qBAAqB,EAAE,CAAA;IAC5C,WAAW,EAAE,CACX,IAAI,EAAE,yBAAyB,EAC/B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,KACX,qBAAqB,GAAG,IAAI,CAAA;IACjC,wBAAwB,EAAE,CAAC,IAAI,EAAE;QAC/B,cAAc,EAAE,MAAM,CAAA;QACtB,UAAU,EAAE,MAAM,CAAA;QAClB,MAAM,EAAE,MAAM,CAAA;QACd,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAC3B,KAAK,wBAAwB,CAAA;CAC/B;AA0CD,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CAwSrB"}

package/dist/mock.js

@@ -0,0 +1,341 @@
+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 = toDocumentResponse(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, taxes);
+            if (method === "GET" && path === "/series")
+                return json(200, listSeries());
+            if (method === "POST" && path === "/invoice") {
+                return json(200, toDocumentResponse(createDocument("invoice", parseBody(request.body))));
+            }
+            if (method === "POST" && path === "/estimate") {
+                return json(200, toDocumentResponse(createDocument("estimate", parseBody(request.body))));
+            }
+            if (method === "GET" && path === "/invoice/pdf") {
+                return json(200, { url: findByQuery("invoice", url).url });
+            }
+            if (method === "GET" && path === "/estimate/pdf") {
+                return json(200, { url: findByQuery("estimate", url).url });
+            }
+            if (method === "GET" && path === "/estimate/invoices") {
+                return json(200, { invoices: findByQuery("estimate", url).convertedInvoices });
+            }
+            if (method === "GET" && path === "/invoice/paymentstatus") {
+                const invoice = findByQuery("invoice", url);
+                return json(200, {
+                    status: invoice.status === "cancelled" || invoice.status === "deleted"
+                        ? invoice.status
+                        : paymentStatus(invoice),
+                    paidAmount: invoice.paidAmount,
+                    unpaidAmount: Math.max(0, invoice.total - invoice.paidAmount),
+                });
+            }
+            if (method === "PUT" && path === "/invoice/cancel") {
+                updateInvoiceStatus(parseBody(request.body), "cancelled");
+                return json(200, {});
+            }
+            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, toDocumentResponse(reversal));
+            }
+            if (method === "PUT" && path === "/invoice/restore") {
+                updateInvoiceStatus(parseBody(request.body), "restored");
+                return json(200, {});
+            }
+            if (method === "DELETE" && path === "/invoice") {
+                updateByQuery(url, "deleted");
+                return json(200, {});
+            }
+            return json(404, { errorText: `SmartBill mock endpoint not found: ${method} ${path}` });
+        }
+        catch (error) {
+            return json(error instanceof SmartbillMockError ? error.status : 500, {
+                errorText: 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,
+        });
+        return {
+            ok: response.status >= 200 && response.status < 300,
+            status: response.status,
+            json: async () => JSON.parse(response.body),
+            text: async () => response.body,
+        };
+    };
+    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 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: paidAmount(body, total),
+            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);
+    }
+    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 paymentStatus(document) {
+    if (document.paidAmount >= document.total && document.total > 0)
+        return "paid";
+    if (document.paidAmount > 0)
+        return "partially_paid";
+    return "unpaid";
+}
+function toDocumentResponse(document) {
+    return {
+        series: document.seriesName,
+        number: document.number,
+        url: document.url,
+    };
+}
+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),
+        convertedInvoices: document.convertedInvoices.map((invoice) => ({ ...invoice })),
+    };
+}
+function roundMoney(value) {
+    return Math.round(value * 100) / 100;
+}
+function concat(chunks) {
+    const length = chunks.reduce((total, chunk) => total + chunk.byteLength, 0);
+    const combined = new Uint8Array(length);
+    let offset = 0;
+    for (const chunk of chunks) {
+        combined.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return combined;
+}
+async function importNodeHttp() {
+    const specifier = "node:http";
+    return import(specifier);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/plugin-smartbill",
-  "version": "0.25.0",
+  "version": "0.26.1",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -14,6 +14,11 @@
       "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",
@@ -32,7 +37,7 @@
   },
   "dependencies": {
     "zod": "^4.3.6",
-    "@voyantjs/core": "0.25.0"
+    "@voyantjs/core": "0.26.1"
   },
   "devDependencies": {
     "typescript": "^6.0.2",