@voyantjs/plugin-smartbill 0.1.0

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

@@ -0,0 +1,216 @@
+import { describe, expect, it, vi } from "vitest";
+import { smartbillPlugin } from "../../src/plugin.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@test.com",
+    apiToken: "tok",
+    companyVatCode: "RO12345678",
+    seriesName: "A",
+};
+function makeLogger() {
+    return {
+        error: vi.fn(),
+        info: vi.fn(),
+    };
+}
+describe("smartbillPlugin structure", () => {
+    it("returns a Plugin with name and version", () => {
+        const fetchMock = vi.fn();
+        const plugin = smartbillPlugin({ ...baseOptions, fetch: fetchMock });
+        expect(plugin.name).toBe("smartbill");
+        expect(plugin.version).toBe("0.1.0");
+        expect(plugin.subscribers).toHaveLength(3);
+    });
+    it("subscribes to default event names", () => {
+        const fetchMock = vi.fn();
+        const plugin = smartbillPlugin({ ...baseOptions, fetch: fetchMock });
+        const events = plugin.subscribers.map((s) => s.event);
+        expect(events).toEqual(["invoice.issued", "invoice.voided", "invoice.external.sync.requested"]);
+    });
+    it("subscribes to custom event names", () => {
+        const fetchMock = vi.fn();
+        const plugin = smartbillPlugin({
+            ...baseOptions,
+            fetch: fetchMock,
+            events: {
+                issued: "custom.issued",
+                voided: "custom.voided",
+                syncRequested: "custom.sync",
+            },
+        });
+        const events = plugin.subscribers.map((s) => s.event);
+        expect(events).toEqual(["custom.issued", "custom.voided", "custom.sync"]);
+    });
+});
+describe("smartbillPlugin — invoice.issued subscriber", () => {
+    it("calls createInvoice with mapped body", async () => {
+        const fetchMock = vi.fn(async () => jsonResponse(200, { number: "1", series: "A" }));
+        const logger = makeLogger();
+        const plugin = smartbillPlugin({ ...baseOptions, fetch: fetchMock, logger });
+        const handler = plugin.subscribers[0].handler;
+        await handler({
+            id: "inv_123",
+            clientName: "Test SRL",
+            currency: "RON",
+            lineItems: [{ name: "Tour", quantity: 1, unitPrice: 50000 }],
+        });
+        expect(fetchMock).toHaveBeenCalledOnce();
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(url).toContain("/invoice");
+        expect(init.method).toBe("POST");
+        const body = JSON.parse(init.body ?? "{}");
+        expect(body.companyVatCode).toBe("RO12345678");
+        expect(body.seriesName).toBe("A");
+        expect(body.client.name).toBe("Test SRL");
+        expect(logger.info).toHaveBeenCalledOnce();
+    });
+    it("logs error and does not throw on failure", async () => {
+        const fetchMock = vi.fn(async () => textResponse(500, "boom"));
+        const logger = makeLogger();
+        const plugin = smartbillPlugin({ ...baseOptions, fetch: fetchMock, logger });
+        const handler = plugin.subscribers[0].handler;
+        // Should not throw
+        await handler({ id: "inv_fail", lineItems: [] });
+        expect(logger.error).toHaveBeenCalledOnce();
+        expect(logger.error.mock.calls[0][0]).toContain("createInvoice");
+        expect(logger.error.mock.calls[0][0]).toContain("inv_fail");
+    });
+    it("ignores null data", async () => {
+        const fetchMock = vi.fn();
+        const plugin = smartbillPlugin({ ...baseOptions, fetch: fetchMock });
+        await plugin.subscribers[0].handler(null);
+        expect(fetchMock).not.toHaveBeenCalled();
+    });
+    it("ignores data without id", async () => {
+        const fetchMock = vi.fn();
+        const plugin = smartbillPlugin({ ...baseOptions, fetch: fetchMock });
+        await plugin.subscribers[0].handler({ noId: true });
+        expect(fetchMock).not.toHaveBeenCalled();
+    });
+});
+describe("smartbillPlugin — invoice.voided subscriber", () => {
+    it("calls cancelInvoice with external number", async () => {
+        const fetchMock = vi.fn(async () => jsonResponse(200, {}));
+        const logger = makeLogger();
+        const plugin = smartbillPlugin({ ...baseOptions, fetch: fetchMock, logger });
+        const handler = plugin.subscribers[1].handler;
+        await handler({
+            id: "inv_void",
+            externalSeriesName: "B",
+            externalNumber: "42",
+        });
+        expect(fetchMock).toHaveBeenCalledOnce();
+        const body = JSON.parse(fetchMock.mock.calls[0][1].body ?? "{}");
+        expect(body).toEqual({
+            companyVatCode: "RO12345678",
+            seriesName: "B",
+            number: "42",
+        });
+        expect(logger.info).toHaveBeenCalledOnce();
+    });
+    it("falls back to invoiceNumber when externalNumber missing", async () => {
+        const fetchMock = vi.fn(async () => jsonResponse(200, {}));
+        const logger = makeLogger();
+        const plugin = smartbillPlugin({ ...baseOptions, fetch: fetchMock, logger });
+        const handler = plugin.subscribers[1].handler;
+        await handler({ id: "inv_void2", invoiceNumber: "99" });
+        const body = JSON.parse(fetchMock.mock.calls[0][1].body ?? "{}");
+        expect(body.seriesName).toBe("A"); // falls back to options.seriesName
+        expect(body.number).toBe("99");
+    });
+    it("logs error when no number is available", async () => {
+        const fetchMock = vi.fn();
+        const logger = makeLogger();
+        const plugin = smartbillPlugin({ ...baseOptions, fetch: fetchMock, logger });
+        const handler = plugin.subscribers[1].handler;
+        await handler({ id: "inv_no_num" });
+        expect(fetchMock).not.toHaveBeenCalled();
+        expect(logger.error).toHaveBeenCalledOnce();
+        expect(logger.error.mock.calls[0][0]).toContain("missing external number");
+    });
+    it("logs error on cancel failure (fire-and-forget)", async () => {
+        const fetchMock = vi.fn(async () => textResponse(500, "error"));
+        const logger = makeLogger();
+        const plugin = smartbillPlugin({ ...baseOptions, fetch: fetchMock, logger });
+        const handler = plugin.subscribers[1].handler;
+        await handler({ id: "inv_err", externalNumber: "1" });
+        expect(logger.error).toHaveBeenCalledOnce();
+        expect(logger.error.mock.calls[0][0]).toContain("cancelInvoice");
+    });
+});
+describe("smartbillPlugin — invoice.external.sync.requested subscriber", () => {
+    it("calls getPaymentStatus and logs result", async () => {
+        const fetchMock = vi.fn(async () => jsonResponse(200, { status: "paid", paidAmount: 100 }));
+        const logger = makeLogger();
+        const plugin = smartbillPlugin({ ...baseOptions, fetch: fetchMock, logger });
+        const handler = plugin.subscribers[2].handler;
+        await handler({ id: "inv_sync", externalNumber: "55" });
+        expect(fetchMock).toHaveBeenCalledOnce();
+        const [url] = fetchMock.mock.calls[0];
+        expect(url).toContain("/invoice/paymentstatus");
+        expect(logger.info).toHaveBeenCalledOnce();
+        expect(logger.info.mock.calls[0][0]).toContain("paid");
+    });
+    it("logs error when no number is available", async () => {
+        const fetchMock = vi.fn();
+        const logger = makeLogger();
+        const plugin = smartbillPlugin({ ...baseOptions, fetch: fetchMock, logger });
+        const handler = plugin.subscribers[2].handler;
+        await handler({ id: "inv_no_num" });
+        expect(fetchMock).not.toHaveBeenCalled();
+        expect(logger.error).toHaveBeenCalledOnce();
+        expect(logger.error.mock.calls[0][0]).toContain("missing external number");
+    });
+    it("logs error on failure (fire-and-forget)", async () => {
+        const fetchMock = vi.fn(async () => textResponse(500, "timeout"));
+        const logger = makeLogger();
+        const plugin = smartbillPlugin({ ...baseOptions, fetch: fetchMock, logger });
+        const handler = plugin.subscribers[2].handler;
+        await handler({ id: "inv_err", externalNumber: "1" });
+        expect(logger.error).toHaveBeenCalledOnce();
+        expect(logger.error.mock.calls[0][0]).toContain("getPaymentStatus");
+    });
+});
+describe("smartbillPlugin — custom mapEvent", () => {
+    it("uses custom mapper when provided", async () => {
+        const fetchMock = vi.fn(async () => jsonResponse(200, { number: "1", series: "A" }));
+        const logger = makeLogger();
+        const customMapper = vi.fn().mockReturnValue({
+            companyVatCode: "CUSTOM",
+            client: { name: "Custom" },
+            seriesName: "Z",
+            currency: "EUR",
+            products: [],
+        });
+        const plugin = smartbillPlugin({
+            ...baseOptions,
+            fetch: fetchMock,
+            logger,
+            mapEvent: customMapper,
+        });
+        const handler = plugin.subscribers[0].handler;
+        await handler({ id: "inv_custom" });
+        expect(customMapper).toHaveBeenCalledOnce();
+        expect(customMapper.mock.calls[0][0].id).toBe("inv_custom");
+        const body = JSON.parse(fetchMock.mock.calls[0][1].body ?? "{}");
+        expect(body.companyVatCode).toBe("CUSTOM");
+    });
+});

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@voyantjs/plugin-smartbill",
+  "version": "0.1.0",
+  "license": "FSL-1.1-Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "import": "./dist/plugin.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    }
+  },
+  "dependencies": {
+    "@voyantjs/core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2",
+    "@voyantjs/voyant-typescript-config": "0.1.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src/",
+    "test": "vitest run",
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}