@voyantjs/plugin-smartbill 0.1.0

package/dist/src/types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Minimal shape for Voyant invoice events. The plugin accepts anything with
+ * at least these fields; everything else is passed through to the mapper.
+ */
+export interface VoyantInvoiceEvent {
+    id: string;
+    invoiceNumber?: string;
+    [key: string]: unknown;
+}
+/**
+ * SmartBill invoice line item (product).
+ * @see https://api.smartbill.ro/#!/Factura/createInvoice
+ */
+export interface SmartbillProduct {
+    name: string;
+    code?: string;
+    measureUnit: string;
+    quantity: number;
+    price: number;
+    currency: string;
+    isTaxIncluded: boolean;
+    taxPercentage?: number;
+    isService?: boolean;
+    saveToDb?: boolean;
+    warehouseName?: string;
+}
+/**
+ * SmartBill invoice client.
+ */
+export interface SmartbillClient {
+    name: string;
+    vatCode?: string;
+    regCom?: string;
+    address?: string;
+    city?: string;
+    county?: string;
+    country?: string;
+    isTaxPayer?: boolean;
+    email?: string;
+    phone?: string;
+    contact?: string;
+    saveToDb?: boolean;
+}
+/**
+ * SmartBill invoice body as accepted by the `POST /invoice` endpoint.
+ */
+export interface SmartbillInvoiceBody {
+    companyVatCode: string;
+    client: SmartbillClient;
+    seriesName: string;
+    isDraft?: boolean;
+    currency: string;
+    language?: string;
+    dueDate?: string;
+    issueDate?: string;
+    deliveryDate?: string;
+    precision?: number;
+    useEstimateDetails?: boolean;
+    mentions?: string;
+    observations?: string;
+    products: SmartbillProduct[];
+    usePaymentTax?: boolean;
+    payment?: {
+        type: string;
+        value: number;
+        isCash: boolean;
+    };
+}
+/**
+ * SmartBill API response for invoice creation.
+ */
+export interface SmartbillInvoiceResponse {
+    number?: string;
+    series?: string;
+    url?: string;
+    errorText?: string;
+}
+/**
+ * SmartBill API response for PDF download.
+ */
+export interface SmartbillPdfResponse {
+    url?: string;
+    errorText?: string;
+}
+/**
+ * SmartBill API response for invoice status.
+ */
+export interface SmartbillStatusResponse {
+    status?: string;
+    paidAmount?: number;
+    unpaidAmount?: number;
+    errorText?: string;
+}
+/**
+ * Minimal `fetch` shape the SmartBill client depends on. Works with the global
+ * `fetch` in Node 18+ / Cloudflare Workers / browsers, and is trivially
+ * stubbable in tests.
+ */
+export type SmartbillFetch = (input: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body?: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    json: () => Promise<unknown>;
+    text: () => Promise<string>;
+}>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/src/types.js

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

package/dist/tests/unit/client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.test.d.ts.map

package/dist/tests/unit/client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../../../tests/unit/client.test.ts"],"names":[],"mappings":""}

package/dist/tests/unit/client.test.js

@@ -0,0 +1,182 @@
+import { describe, expect, it, vi } from "vitest";
+import { createSmartbillClient } from "../../src/client.js";
+function jsonResponse(status, body) {
+    const text = JSON.stringify(body);
+    return {
+        ok: status >= 200 && status < 300,
+        status,
+        json: async () => JSON.parse(text),
+        text: async () => text,
+    };
+}
+function textResponse(status, text) {
+    return {
+        ok: status >= 200 && status < 300,
+        status,
+        json: async () => {
+            throw new Error("not json");
+        },
+        text: async () => text,
+    };
+}
+const baseOptions = {
+    username: "user@example.com",
+    apiToken: "test-token",
+};
+describe("createSmartbillClient.createInvoice", () => {
+    it("sends POST to /invoice with basic auth", async () => {
+        const fetchMock = vi.fn(async () => jsonResponse(200, { number: "1", series: "A" }));
+        const client = createSmartbillClient({ ...baseOptions, fetch: fetchMock });
+        const result = await client.createInvoice({
+            companyVatCode: "RO123",
+            client: { name: "Acme" },
+            seriesName: "A",
+            currency: "RON",
+            products: [
+                {
+                    name: "Tour",
+                    measureUnit: "buc",
+                    quantity: 1,
+                    price: 100,
+                    currency: "RON",
+                    isTaxIncluded: true,
+                },
+            ],
+        });
+        expect(result).toEqual({ number: "1", series: "A" });
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(url).toBe("https://ws.smartbill.ro/SBORO/api/invoice");
+        expect(init.method).toBe("POST");
+        expect(init.headers.Authorization).toMatch(/^Basic /);
+        expect(init.headers["Content-Type"]).toBe("application/json");
+        const body = JSON.parse(init.body ?? "{}");
+        expect(body.companyVatCode).toBe("RO123");
+        expect(body.products).toHaveLength(1);
+    });
+    it("throws on non-2xx response", async () => {
+        const fetchMock = vi.fn(async () => textResponse(400, "bad request"));
+        const client = createSmartbillClient({ ...baseOptions, fetch: fetchMock });
+        await expect(client.createInvoice({
+            companyVatCode: "RO123",
+            client: { name: "X" },
+            seriesName: "A",
+            currency: "RON",
+            products: [],
+        })).rejects.toThrow(/SmartBill createInvoice failed \(400\)/);
+    });
+});
+describe("createSmartbillClient.createProforma", () => {
+    it("sends POST to /estimate", async () => {
+        const fetchMock = vi.fn(async () => jsonResponse(200, { number: "P1", series: "P" }));
+        const client = createSmartbillClient({ ...baseOptions, fetch: fetchMock });
+        await client.createProforma({
+            companyVatCode: "RO123",
+            client: { name: "X" },
+            seriesName: "P",
+            currency: "RON",
+            products: [],
+        });
+        const [url] = fetchMock.mock.calls[0];
+        expect(url).toBe("https://ws.smartbill.ro/SBORO/api/estimate");
+    });
+});
+describe("createSmartbillClient.cancelInvoice", () => {
+    it("sends PUT to /invoice/cancel", async () => {
+        const fetchMock = vi.fn(async () => jsonResponse(200, {}));
+        const client = createSmartbillClient({ ...baseOptions, fetch: fetchMock });
+        await client.cancelInvoice("RO123", "A", "42");
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(url).toBe("https://ws.smartbill.ro/SBORO/api/invoice/cancel");
+        expect(init.method).toBe("PUT");
+        const body = JSON.parse(init.body ?? "{}");
+        expect(body).toEqual({ companyVatCode: "RO123", seriesName: "A", number: "42" });
+    });
+    it("throws on error", async () => {
+        const fetchMock = vi.fn(async () => textResponse(500, "fail"));
+        const client = createSmartbillClient({ ...baseOptions, fetch: fetchMock });
+        await expect(client.cancelInvoice("RO123", "A", "1")).rejects.toThrow(/SmartBill cancelInvoice failed \(500\)/);
+    });
+});
+describe("createSmartbillClient.deleteInvoice", () => {
+    it("sends DELETE to /invoice with query params", async () => {
+        const fetchMock = vi.fn(async () => jsonResponse(200, {}));
+        const client = createSmartbillClient({ ...baseOptions, fetch: fetchMock });
+        await client.deleteInvoice("RO123", "A", "42");
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(url).toContain("/invoice?cif=RO123&seriesname=A&number=42");
+        expect(init.method).toBe("DELETE");
+    });
+});
+describe("createSmartbillClient.reverseInvoice", () => {
+    it("sends PUT to /invoice/reverse", async () => {
+        const fetchMock = vi.fn(async () => jsonResponse(200, { number: "S1", series: "S" }));
+        const client = createSmartbillClient({ ...baseOptions, fetch: fetchMock });
+        const result = await client.reverseInvoice("RO123", "A", "42");
+        expect(result).toEqual({ number: "S1", series: "S" });
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(url).toBe("https://ws.smartbill.ro/SBORO/api/invoice/reverse");
+        expect(init.method).toBe("PUT");
+    });
+});
+describe("createSmartbillClient.viewPdf", () => {
+    it("sends GET to /invoice/pdf with query params", async () => {
+        const fetchMock = vi.fn(async () => jsonResponse(200, { url: "https://smartbill.ro/pdf/123" }));
+        const client = createSmartbillClient({ ...baseOptions, fetch: fetchMock });
+        const result = await client.viewPdf("RO123", "A", "42");
+        expect(result.url).toBe("https://smartbill.ro/pdf/123");
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(url).toContain("/invoice/pdf?cif=RO123&seriesname=A&number=42");
+        expect(init.method).toBe("GET");
+    });
+});
+describe("createSmartbillClient.getPaymentStatus", () => {
+    it("sends GET to /invoice/paymentstatus", async () => {
+        const fetchMock = vi.fn(async () => jsonResponse(200, { status: "paid", paidAmount: 100, unpaidAmount: 0 }));
+        const client = createSmartbillClient({ ...baseOptions, fetch: fetchMock });
+        const result = await client.getPaymentStatus("RO123", "A", "42");
+        expect(result).toEqual({ status: "paid", paidAmount: 100, unpaidAmount: 0 });
+        const [url] = fetchMock.mock.calls[0];
+        expect(url).toContain("/invoice/paymentstatus?cif=RO123&seriesname=A&number=42");
+    });
+});
+describe("createSmartbillClient — custom apiUrl", () => {
+    it("respects custom API base URL", async () => {
+        const fetchMock = vi.fn(async () => jsonResponse(200, {}));
+        const client = createSmartbillClient({
+            ...baseOptions,
+            apiUrl: "https://custom.example.com/api/",
+            fetch: fetchMock,
+        });
+        await client.cancelInvoice("RO1", "A", "1");
+        const [url] = fetchMock.mock.calls[0];
+        expect(url).toBe("https://custom.example.com/api/invoice/cancel");
+    });
+});
+describe("createSmartbillClient — basic auth encoding", () => {
+    it("encodes username:token as base64", async () => {
+        const fetchMock = vi.fn(async () => jsonResponse(200, {}));
+        const client = createSmartbillClient({
+            username: "test@test.com",
+            apiToken: "secret123",
+            fetch: fetchMock,
+        });
+        await client.cancelInvoice("X", "A", "1");
+        const [, init] = fetchMock.mock.calls[0];
+        const expected = `Basic ${btoa("test@test.com:secret123")}`;
+        expect(init.headers.Authorization).toBe(expected);
+    });
+});
+describe("createSmartbillClient — fetch handling", () => {
+    it("throws when no fetch implementation is available", async () => {
+        const originalFetch = globalThis.fetch;
+        globalThis.fetch = undefined;
+        try {
+            // biome-ignore lint/suspicious/noExplicitAny: simulating missing fetch
+            const client = createSmartbillClient({ ...baseOptions, fetch: undefined });
+            await expect(client.cancelInvoice("X", "A", "1")).rejects.toThrow(/requires a fetch implementation/);
+        }
+        finally {
+            globalThis.fetch = originalFetch;
+        }
+    });
+});

package/dist/tests/unit/mapping.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mapping.test.d.ts.map

package/dist/tests/unit/mapping.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.test.d.ts","sourceRoot":"","sources":["../../../tests/unit/mapping.test.ts"],"names":[],"mappings":""}

package/dist/tests/unit/mapping.test.js

@@ -0,0 +1,149 @@
+import { describe, expect, it } from "vitest";
+import { mapClient, mapLineItems, mapVoyantInvoiceToSmartbill } from "../../src/mapping.js";
+const defaultOptions = {
+    companyVatCode: "RO12345678",
+    seriesName: "A",
+};
+function event(overrides = {}) {
+    return { id: "inv_test", ...overrides };
+}
+describe("mapClient", () => {
+    it("extracts client fields from event", () => {
+        const result = mapClient(event({
+            clientName: "Acme SRL",
+            clientVatCode: "RO999",
+            clientAddress: "Str. Test 1",
+            clientCity: "Bucharest",
+            clientCounty: "B",
+            clientCountry: "RO",
+            clientEmail: "acme@test.com",
+            clientPhone: "+40700000000",
+        }));
+        expect(result.name).toBe("Acme SRL");
+        expect(result.vatCode).toBe("RO999");
+        expect(result.address).toBe("Str. Test 1");
+        expect(result.city).toBe("Bucharest");
+        expect(result.email).toBe("acme@test.com");
+        expect(result.saveToDb).toBe(false);
+    });
+    it("falls back to customerName if clientName is missing", () => {
+        const result = mapClient(event({ customerName: "Fallback Inc" }));
+        expect(result.name).toBe("Fallback Inc");
+    });
+    it("uses 'Client' fallback for missing name", () => {
+        const result = mapClient(event());
+        expect(result.name).toBe("Client");
+    });
+    it("returns undefined for missing optional fields", () => {
+        const result = mapClient(event());
+        expect(result.vatCode).toBeUndefined();
+        expect(result.address).toBeUndefined();
+        expect(result.email).toBeUndefined();
+    });
+});
+describe("mapLineItems", () => {
+    it("maps an array of line items", () => {
+        const result = mapLineItems(event({
+            lineItems: [
+                {
+                    description: "Safari Tour",
+                    code: "TOUR-1",
+                    unit: "buc",
+                    quantity: 2,
+                    unitPrice: 50000,
+                    currency: "RON",
+                    isService: true,
+                },
+            ],
+        }), defaultOptions);
+        expect(result).toHaveLength(1);
+        expect(result[0].name).toBe("Safari Tour");
+        expect(result[0].code).toBe("TOUR-1");
+        expect(result[0].quantity).toBe(2);
+        expect(result[0].price).toBe(50000);
+        expect(result[0].isService).toBe(true);
+        expect(result[0].isTaxIncluded).toBe(true);
+    });
+    it("returns empty array when no lineItems", () => {
+        expect(mapLineItems(event(), defaultOptions)).toEqual([]);
+    });
+    it("uses event.currency as fallback for item currency", () => {
+        const result = mapLineItems(event({
+            currency: "EUR",
+            lineItems: [{ name: "X", quantity: 1, price: 10 }],
+        }), defaultOptions);
+        expect(result[0].currency).toBe("EUR");
+    });
+    it("respects isTaxIncluded from options", () => {
+        const result = mapLineItems(event({ lineItems: [{ name: "X", quantity: 1, price: 10 }] }), {
+            ...defaultOptions,
+            isTaxIncluded: false,
+        });
+        expect(result[0].isTaxIncluded).toBe(false);
+    });
+    it("passes through taxPercentage when present", () => {
+        const result = mapLineItems(event({ lineItems: [{ name: "X", quantity: 1, price: 10, taxPercentage: 19 }] }), defaultOptions);
+        expect(result[0].taxPercentage).toBe(19);
+    });
+    it("omits taxPercentage when not present", () => {
+        const result = mapLineItems(event({ lineItems: [{ name: "X", quantity: 1, price: 10 }] }), defaultOptions);
+        expect(result[0].taxPercentage).toBeUndefined();
+    });
+});
+describe("mapVoyantInvoiceToSmartbill", () => {
+    it("produces a complete SmartBill invoice body", () => {
+        const result = mapVoyantInvoiceToSmartbill(event({
+            clientName: "Test SRL",
+            currency: "RON",
+            issueDate: "2026-01-15",
+            dueDate: "2026-02-15",
+            lineItems: [{ name: "Tour Package", quantity: 1, unitPrice: 50000 }],
+        }), defaultOptions);
+        expect(result.companyVatCode).toBe("RO12345678");
+        expect(result.seriesName).toBe("A");
+        expect(result.currency).toBe("RON");
+        expect(result.language).toBe("RO");
+        expect(result.client.name).toBe("Test SRL");
+        expect(result.products).toHaveLength(1);
+        expect(result.issueDate).toBe("2026-01-15");
+        expect(result.dueDate).toBe("2026-02-15");
+    });
+    it("sets isDraft when event has isDraft=true", () => {
+        const result = mapVoyantInvoiceToSmartbill(event({ isDraft: true }), defaultOptions);
+        expect(result.isDraft).toBe(true);
+    });
+    it("does not set isDraft when not present", () => {
+        const result = mapVoyantInvoiceToSmartbill(event(), defaultOptions);
+        expect(result.isDraft).toBeUndefined();
+    });
+    it("appends Art. 311 mention when art311SpecialRegime is true", () => {
+        const result = mapVoyantInvoiceToSmartbill(event(), {
+            ...defaultOptions,
+            art311SpecialRegime: true,
+        });
+        expect(result.mentions).toContain("Art. 311");
+    });
+    it("appends Art. 311 to existing mentions", () => {
+        const result = mapVoyantInvoiceToSmartbill(event({ mentions: "Custom note" }), {
+            ...defaultOptions,
+            art311SpecialRegime: true,
+        });
+        expect(result.mentions).toContain("Custom note");
+        expect(result.mentions).toContain("Art. 311");
+    });
+    it("uses custom language", () => {
+        const result = mapVoyantInvoiceToSmartbill(event(), {
+            ...defaultOptions,
+            language: "EN",
+        });
+        expect(result.language).toBe("EN");
+    });
+    it("defaults currency to RON", () => {
+        const result = mapVoyantInvoiceToSmartbill(event(), defaultOptions);
+        expect(result.currency).toBe("RON");
+    });
+    it("passes through observations", () => {
+        const result = mapVoyantInvoiceToSmartbill(event({ observations: "Test obs" }), defaultOptions);
+        expect(result.observations).toBe("Test obs");
+    });
+});

package/dist/tests/unit/plugin.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin.test.d.ts.map

package/dist/tests/unit/plugin.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.test.d.ts","sourceRoot":"","sources":["../../../tests/unit/plugin.test.ts"],"names":[],"mappings":""}