@voyantjs/plugin-smartbill 0.1.0

package/LICENSE

@@ -0,0 +1,109 @@
+# Functional Source License, Version 1.1, Apache 2.0 Future License
+
+## Abbreviation
+
+FSL-1.1-Apache-2.0
+
+## Notice
+
+Copyright 2026 PixelMakers Studio SRL
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly
+display and redistribute the Software for any Permitted Purpose identified
+below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing
+Use means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe
+our patents, the license grant above includes a license under our patents.
+If you make a claim against any party that the Software infringes or
+contributes to the infringement of any patent, then your patent license to
+the Software ends immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives
+of the Software.
+
+If you redistribute any copies, modifications or derivatives of the
+Software, you must include a copy of or a link to these Terms and Conditions
+and not remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A
+PARTICULAR PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO
+THE SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL
+DAMAGES, EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin
+of the Software, you have no right under these Terms and Conditions to use
+our trademarks, trade names, service marks or product names.
+
+---
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software
+under the Apache License, Version 2.0 that is effective on the second
+anniversary of the date we make the Software available. On or after that
+date, you may use the Software under the Apache License, Version 2.0, in
+which case the following will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not
+use this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+License for the specific language governing permissions and limitations
+under the License.

package/README.md

@@ -0,0 +1,43 @@
+# @voyantjs/plugin-smartbill
+
+SmartBill e-invoicing plugin for Voyant. Subscribes to invoice events and creates/cancels/syncs invoices via the SmartBill REST API for Romanian tax compliance.
+
+## Install
+
+```bash
+pnpm add @voyantjs/plugin-smartbill
+```
+
+## Usage
+
+```typescript
+import { smartbillPlugin } from "@voyantjs/plugin-smartbill"
+import { createApp } from "@voyantjs/hono"
+
+const app = createApp({
+  plugins: [
+    smartbillPlugin({
+      username: env.SMARTBILL_USERNAME,
+      apiToken: env.SMARTBILL_API_TOKEN,
+      companyVatCode: "RO12345678",
+      seriesName: "A",
+      // optional: language, art311SpecialRegime, events, mapEvent, logger
+    }),
+  ],
+})
+```
+
+By default the plugin wires up 3 subscribers (`invoice.issued`, `invoice.voided`, `invoice.external.sync.requested`) that create, cancel, and check payment status on SmartBill. All error handling is fire-and-forget per the EventBus contract.
+
+## Exports
+
+| Entry | Description |
+| --- | --- |
+| `.` | Barrel re-exports |
+| `./plugin` | `smartbillPlugin(options)` |
+| `./client` | `createSmartbillClient` — `createInvoice`, `cancelInvoice`, `viewPdf`, `getPaymentStatus`, etc. |
+| `./types` | SmartBill invoice types |
+
+## License
+
+FSL-1.1-Apache-2.0

package/dist/src/client.d.ts

@@ -0,0 +1,38 @@
+import type { SmartbillFetch, SmartbillInvoiceBody, SmartbillInvoiceResponse, SmartbillPdfResponse, SmartbillStatusResponse } from "./types.js";
+/**
+ * Options for {@link createSmartbillClient}.
+ */
+export interface SmartbillClientOptions {
+    /** SmartBill account username (email). */
+    username: string;
+    /** SmartBill API token. */
+    apiToken: string;
+    /**
+     * SmartBill API base URL. Defaults to `"https://ws.smartbill.ro/SBORO/api"`.
+     */
+    apiUrl?: string;
+    /** Override `fetch` (e.g. in tests). Defaults to global `fetch`. */
+    fetch?: SmartbillFetch;
+}
+export interface SmartbillClientApi {
+    /** Create an invoice. Returns the series + number + URL. */
+    createInvoice(body: SmartbillInvoiceBody): Promise<SmartbillInvoiceResponse>;
+    /** Create a proforma invoice. */
+    createProforma(body: SmartbillInvoiceBody): Promise<SmartbillInvoiceResponse>;
+    /** Cancel an invoice by series + number. */
+    cancelInvoice(companyVatCode: string, seriesName: string, number: string): Promise<{
+        errorText?: string;
+    }>;
+    /** Delete an invoice by series + number. */
+    deleteInvoice(companyVatCode: string, seriesName: string, number: string): Promise<{
+        errorText?: string;
+    }>;
+    /** Reverse an invoice by series + number. */
+    reverseInvoice(companyVatCode: string, seriesName: string, number: string): Promise<SmartbillInvoiceResponse>;
+    /** Get PDF URL for an invoice. */
+    viewPdf(companyVatCode: string, seriesName: string, number: string): Promise<SmartbillPdfResponse>;
+    /** Get payment status for an invoice. */
+    getPaymentStatus(companyVatCode: string, seriesName: string, number: string): Promise<SmartbillStatusResponse>;
+}
+export declare function createSmartbillClient(options: SmartbillClientOptions): SmartbillClientApi;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,YAAY,CAAA;AAEnB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAA;IAChB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oEAAoE;IACpE,KAAK,CAAC,EAAE,cAAc,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAA;IAC5E,iCAAiC;IACjC,cAAc,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAA;IAC7E,4CAA4C;IAC5C,aAAa,CACX,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClC,4CAA4C;IAC5C,aAAa,CACX,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClC,6CAA6C;IAC7C,cAAc,CACZ,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,wBAAwB,CAAC,CAAA;IACpC,kCAAkC;IAClC,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAClG,yCAAyC;IACzC,gBAAgB,CACd,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,uBAAuB,CAAC,CAAA;CACpC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,kBAAkB,CAyIzF"}

package/dist/src/client.js

@@ -0,0 +1,105 @@
+export function createSmartbillClient(options) {
+    const apiUrl = (options.apiUrl ?? "https://ws.smartbill.ro/SBORO/api").replace(/\/$/, "");
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    function authHeader() {
+        return `Basic ${btoa(`${options.username}:${options.apiToken}`)}`;
+    }
+    function headers() {
+        return {
+            Authorization: authHeader(),
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        };
+    }
+    async function request(method, path, body) {
+        if (!fetchImpl) {
+            throw new Error("SmartBill client requires a fetch implementation");
+        }
+        const init = {
+            method,
+            headers: headers(),
+        };
+        if (body !== undefined)
+            init.body = JSON.stringify(body);
+        const response = await fetchImpl(`${apiUrl}${path}`, init);
+        let text = "";
+        let json = null;
+        try {
+            text = await response.text();
+            json = text ? JSON.parse(text) : null;
+        }
+        catch {
+            // leave json as null, surface text
+        }
+        return { ok: response.ok, status: response.status, json, text };
+    }
+    async function createInvoice(body) {
+        const res = await request("POST", "/invoice", body);
+        if (!res.ok) {
+            throw new Error(`SmartBill createInvoice failed (${res.status}): ${res.text}`);
+        }
+        return (res.json ?? {});
+    }
+    async function createProforma(body) {
+        const res = await request("POST", "/estimate", body);
+        if (!res.ok) {
+            throw new Error(`SmartBill createProforma failed (${res.status}): ${res.text}`);
+        }
+        return (res.json ?? {});
+    }
+    async function cancelInvoice(companyVatCode, seriesName, number) {
+        const res = await request("PUT", "/invoice/cancel", {
+            companyVatCode,
+            seriesName,
+            number,
+        });
+        if (!res.ok) {
+            throw new Error(`SmartBill cancelInvoice failed (${res.status}): ${res.text}`);
+        }
+        return (res.json ?? {});
+    }
+    async function deleteInvoice(companyVatCode, seriesName, number) {
+        const query = `cif=${encodeURIComponent(companyVatCode)}&seriesname=${encodeURIComponent(seriesName)}&number=${encodeURIComponent(number)}`;
+        const res = await request("DELETE", `/invoice?${query}`);
+        if (!res.ok) {
+            throw new Error(`SmartBill deleteInvoice failed (${res.status}): ${res.text}`);
+        }
+        return (res.json ?? {});
+    }
+    async function reverseInvoice(companyVatCode, seriesName, number) {
+        const res = await request("PUT", "/invoice/reverse", {
+            companyVatCode,
+            seriesName,
+            number,
+        });
+        if (!res.ok) {
+            throw new Error(`SmartBill reverseInvoice failed (${res.status}): ${res.text}`);
+        }
+        return (res.json ?? {});
+    }
+    async function viewPdf(companyVatCode, seriesName, number) {
+        const query = `cif=${encodeURIComponent(companyVatCode)}&seriesname=${encodeURIComponent(seriesName)}&number=${encodeURIComponent(number)}`;
+        const res = await request("GET", `/invoice/pdf?${query}`);
+        if (!res.ok) {
+            throw new Error(`SmartBill viewPdf failed (${res.status}): ${res.text}`);
+        }
+        return (res.json ?? {});
+    }
+    async function getPaymentStatus(companyVatCode, seriesName, number) {
+        const query = `cif=${encodeURIComponent(companyVatCode)}&seriesname=${encodeURIComponent(seriesName)}&number=${encodeURIComponent(number)}`;
+        const res = await request("GET", `/invoice/paymentstatus?${query}`);
+        if (!res.ok) {
+            throw new Error(`SmartBill getPaymentStatus failed (${res.status}): ${res.text}`);
+        }
+        return (res.json ?? {});
+    }
+    return {
+        createInvoice,
+        createProforma,
+        cancelInvoice,
+        deleteInvoice,
+        reverseInvoice,
+        viewPdf,
+        getPaymentStatus,
+    };
+}

package/dist/src/index.d.ts

@@ -0,0 +1,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 { SmartbillLogger, SmartbillMapFn, SmartbillPluginOptions, SmartbillSyncEventNames, } from "./plugin.js";
+export { smartbillPlugin } from "./plugin.js";
+export type { SmartbillClient, SmartbillFetch, SmartbillInvoiceBody, SmartbillInvoiceResponse, SmartbillPdfResponse, SmartbillProduct, SmartbillStatusResponse, VoyantInvoiceEvent, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,YAAY,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,3 @@
+export { createSmartbillClient } from "./client.js";
+export { mapClient, mapLineItems, mapVoyantInvoiceToSmartbill } from "./mapping.js";
+export { smartbillPlugin } from "./plugin.js";

package/dist/src/mapping.d.ts

@@ -0,0 +1,32 @@
+import type { SmartbillClient, SmartbillInvoiceBody, SmartbillProduct, VoyantInvoiceEvent } from "./types.js";
+/**
+ * Options for the default invoice mapper.
+ */
+export interface SmartbillMappingOptions {
+    /** Romanian company VAT code (e.g. `"RO12345678"`). */
+    companyVatCode: string;
+    /** SmartBill invoice series name (e.g. `"A"`). */
+    seriesName: string;
+    /** Invoice language. Defaults to `"RO"`. */
+    language?: string;
+    /** Whether VAT is included in line item prices. Defaults to `true`. */
+    isTaxIncluded?: boolean;
+    /** Whether to use Art. 311 special regime (margin scheme for travel). */
+    art311SpecialRegime?: boolean;
+}
+/**
+ * Extract the SmartBill client block from a Voyant invoice event.
+ * Falls back to empty strings for missing fields.
+ */
+export declare function mapClient(event: VoyantInvoiceEvent): SmartbillClient;
+/**
+ * Extract SmartBill product lines from a Voyant invoice event.
+ * Expects `event.lineItems` to be an array of objects with at minimum
+ * `description`/`name`, `quantity`, `unitPrice`, `currency`.
+ */
+export declare function mapLineItems(event: VoyantInvoiceEvent, options: SmartbillMappingOptions): SmartbillProduct[];
+/**
+ * Map a full Voyant invoice event to a SmartBill invoice body.
+ */
+export declare function mapVoyantInvoiceToSmartbill(event: VoyantInvoiceEvent, options: SmartbillMappingOptions): SmartbillInvoiceBody;
+//# sourceMappingURL=mapping.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../src/mapping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAEnB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAA;IACtB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAA;IAClB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uEAAuE;IACvE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,eAAe,CAapE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,uBAAuB,GAC/B,gBAAgB,EAAE,CAgBpB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,uBAAuB,GAC/B,oBAAoB,CA2BtB"}

package/dist/src/mapping.js

@@ -0,0 +1,90 @@
+/**
+ * Extract the SmartBill client block from a Voyant invoice event.
+ * Falls back to empty strings for missing fields.
+ */
+export function mapClient(event) {
+    return {
+        name: asString(event.clientName ?? event.customerName, "Client"),
+        vatCode: asStringOrUndefined(event.clientVatCode ?? event.customerVatCode),
+        regCom: asStringOrUndefined(event.clientRegCom),
+        address: asStringOrUndefined(event.clientAddress ?? event.customerAddress),
+        city: asStringOrUndefined(event.clientCity ?? event.customerCity),
+        county: asStringOrUndefined(event.clientCounty ?? event.customerCounty),
+        country: asStringOrUndefined(event.clientCountry ?? event.customerCountry),
+        email: asStringOrUndefined(event.clientEmail ?? event.customerEmail),
+        phone: asStringOrUndefined(event.clientPhone ?? event.customerPhone),
+        saveToDb: false,
+    };
+}
+/**
+ * Extract SmartBill product lines from a Voyant invoice event.
+ * Expects `event.lineItems` to be an array of objects with at minimum
+ * `description`/`name`, `quantity`, `unitPrice`, `currency`.
+ */
+export function mapLineItems(event, options) {
+    const items = event.lineItems;
+    if (!Array.isArray(items))
+        return [];
+    return items.map((item) => ({
+        name: asString(item.description ?? item.name, "Item"),
+        code: asStringOrUndefined(item.code ?? item.sku),
+        measureUnit: asString(item.measureUnit ?? item.unit, "buc"),
+        quantity: asNumber(item.quantity, 1),
+        price: asNumber(item.unitPrice ?? item.price, 0),
+        currency: asString(item.currency ?? event.currency, "RON"),
+        isTaxIncluded: options.isTaxIncluded ?? true,
+        taxPercentage: item.taxPercentage != null ? asNumber(item.taxPercentage, 0) : undefined,
+        isService: item.isService === true,
+        saveToDb: false,
+    }));
+}
+/**
+ * Map a full Voyant invoice event to a SmartBill invoice body.
+ */
+export function mapVoyantInvoiceToSmartbill(event, options) {
+    const body = {
+        companyVatCode: options.companyVatCode,
+        client: mapClient(event),
+        seriesName: options.seriesName,
+        currency: asString(event.currency, "RON"),
+        language: options.language ?? "RO",
+        products: mapLineItems(event, options),
+    };
+    if (event.isDraft === true)
+        body.isDraft = true;
+    if (typeof event.dueDate === "string")
+        body.dueDate = event.dueDate;
+    if (typeof event.issueDate === "string")
+        body.issueDate = event.issueDate;
+    if (typeof event.deliveryDate === "string")
+        body.deliveryDate = event.deliveryDate;
+    if (typeof event.mentions === "string")
+        body.mentions = event.mentions;
+    if (typeof event.observations === "string")
+        body.observations = event.observations;
+    if (options.art311SpecialRegime) {
+        body.mentions = [
+            body.mentions,
+            "Regimul special de taxare - agentie de turism (Art. 311 Cod Fiscal)",
+        ]
+            .filter(Boolean)
+            .join("\n");
+    }
+    return body;
+}
+// --- helpers ---
+function asString(value, fallback) {
+    if (typeof value === "string" && value.length > 0)
+        return value;
+    return fallback;
+}
+function asStringOrUndefined(value) {
+    if (typeof value === "string" && value.length > 0)
+        return value;
+    return undefined;
+}
+function asNumber(value, fallback) {
+    if (typeof value === "number" && !Number.isNaN(value))
+        return value;
+    return fallback;
+}

package/dist/src/plugin.d.ts

@@ -0,0 +1,55 @@
+import type { Plugin } from "@voyantjs/core";
+import { type SmartbillClientOptions } from "./client.js";
+import { mapVoyantInvoiceToSmartbill, type SmartbillMappingOptions } from "./mapping.js";
+import type { VoyantInvoiceEvent } from "./types.js";
+/**
+ * Event names the plugin subscribes to. Defaults match the
+ * `invoice.<action>` naming convention from the EventBus.
+ */
+export interface SmartbillSyncEventNames {
+    issued?: string;
+    voided?: string;
+    syncRequested?: string;
+}
+/**
+ * Logger shape used to surface plugin errors without coupling to any specific
+ * runtime. Defaults to `console`.
+ */
+export interface SmartbillLogger {
+    error: (message: string, meta?: unknown) => void;
+    info?: (message: string, meta?: unknown) => void;
+}
+/**
+ * Custom mapper from a Voyant invoice event to a SmartBill invoice body.
+ * When provided, replaces the default {@link mapVoyantInvoiceToSmartbill}.
+ */
+export type SmartbillMapFn = (event: VoyantInvoiceEvent) => ReturnType<typeof mapVoyantInvoiceToSmartbill>;
+export interface SmartbillPluginOptions extends SmartbillClientOptions, SmartbillMappingOptions {
+    /**
+     * Event names this plugin subscribes to.
+     * Defaults to `invoice.issued` / `invoice.voided` / `invoice.external.sync.requested`.
+     */
+    events?: SmartbillSyncEventNames;
+    /**
+     * Map a Voyant invoice event into a SmartBill invoice body.
+     * Defaults to the built-in {@link mapVoyantInvoiceToSmartbill}.
+     */
+    mapEvent?: SmartbillMapFn;
+    /** Override logger. Defaults to `console`. */
+    logger?: SmartbillLogger;
+}
+/**
+ * Build a Voyant {@link Plugin} that pushes invoice events to SmartBill
+ * for Romanian e-invoicing.
+ *
+ * The plugin subscribes to three events (configurable via
+ * {@link SmartbillPluginOptions.events}):
+ * - `invoice.issued` → create invoice in SmartBill
+ * - `invoice.voided` → cancel invoice in SmartBill
+ * - `invoice.external.sync.requested` → re-fetch payment status
+ *
+ * Errors are caught and logged — subscribers are fire-and-forget per the
+ * EventBus contract, so a SmartBill outage never blocks the emitter.
+ */
+export declare function smartbillPlugin(options: SmartbillPluginOptions): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/src/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,gBAAgB,CAAA;AAExD,OAAO,EAAyB,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAChF,OAAO,EAAE,2BAA2B,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAA;AACxF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,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;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,kBAAkB,KACtB,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAEnD,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB,EAAE,uBAAuB;IAC7F;;;OAGG;IACH,MAAM,CAAC,EAAE,uBAAuB,CAAA;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,eAAe,CAAA;CACzB;AASD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CA8GvE"}

package/dist/src/plugin.js

@@ -0,0 +1,118 @@
+import { createSmartbillClient } from "./client.js";
+import { mapVoyantInvoiceToSmartbill } from "./mapping.js";
+function coerceEvent(data) {
+    if (data == null || typeof data !== "object")
+        return null;
+    const maybe = data;
+    if (typeof maybe.id !== "string")
+        return null;
+    return maybe;
+}
+/**
+ * Build a Voyant {@link Plugin} that pushes invoice events to SmartBill
+ * for Romanian e-invoicing.
+ *
+ * The plugin subscribes to three events (configurable via
+ * {@link SmartbillPluginOptions.events}):
+ * - `invoice.issued` → create invoice in SmartBill
+ * - `invoice.voided` → cancel invoice in SmartBill
+ * - `invoice.external.sync.requested` → re-fetch payment status
+ *
+ * Errors are caught and logged — subscribers are fire-and-forget per the
+ * EventBus contract, so a SmartBill outage never blocks the emitter.
+ */
+export function smartbillPlugin(options) {
+    const client = createSmartbillClient(options);
+    const logger = options.logger ?? console;
+    const mappingOptions = {
+        companyVatCode: options.companyVatCode,
+        seriesName: options.seriesName,
+        language: options.language,
+        isTaxIncluded: options.isTaxIncluded,
+        art311SpecialRegime: options.art311SpecialRegime,
+    };
+    const mapEvent = options.mapEvent ??
+        ((ev) => mapVoyantInvoiceToSmartbill(ev, mappingOptions));
+    const eventNames = {
+        issued: options.events?.issued ?? "invoice.issued",
+        voided: options.events?.voided ?? "invoice.voided",
+        syncRequested: options.events?.syncRequested ?? "invoice.external.sync.requested",
+    };
+    const subscribers = [
+        {
+            event: eventNames.issued,
+            handler: async (data) => {
+                const event = coerceEvent(data);
+                if (!event)
+                    return;
+                try {
+                    const body = mapEvent(event);
+                    const result = await client.createInvoice(body);
+                    logger.info?.(`[smartbill] invoice created: ${result.series}-${result.number} for ${event.id}`, result);
+                }
+                catch (err) {
+                    logger.error(`[smartbill] createInvoice on "${eventNames.issued}" failed for ${event.id}`, err);
+                }
+            },
+        },
+        {
+            event: eventNames.voided,
+            handler: async (data) => {
+                const event = coerceEvent(data);
+                if (!event)
+                    return;
+                try {
+                    const seriesName = typeof event.externalSeriesName === "string"
+                        ? event.externalSeriesName
+                        : options.seriesName;
+                    const number = typeof event.externalNumber === "string"
+                        ? event.externalNumber
+                        : typeof event.invoiceNumber === "string"
+                            ? event.invoiceNumber
+                            : undefined;
+                    if (!number) {
+                        logger.error(`[smartbill] cannot cancel invoice ${event.id}: missing external number`);
+                        return;
+                    }
+                    await client.cancelInvoice(options.companyVatCode, seriesName, number);
+                    logger.info?.(`[smartbill] invoice cancelled: ${seriesName}-${number} for ${event.id}`);
+                }
+                catch (err) {
+                    logger.error(`[smartbill] cancelInvoice on "${eventNames.voided}" failed for ${event.id}`, err);
+                }
+            },
+        },
+        {
+            event: eventNames.syncRequested,
+            handler: async (data) => {
+                const event = coerceEvent(data);
+                if (!event)
+                    return;
+                try {
+                    const seriesName = typeof event.externalSeriesName === "string"
+                        ? event.externalSeriesName
+                        : options.seriesName;
+                    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(options.companyVatCode, seriesName, number);
+                    logger.info?.(`[smartbill] payment status for ${seriesName}-${number}: ${status.status}`, status);
+                }
+                catch (err) {
+                    logger.error(`[smartbill] getPaymentStatus on "${eventNames.syncRequested}" failed for ${event.id}`, err);
+                }
+            },
+        },
+    ];
+    return {
+        name: "smartbill",
+        version: "0.1.0",
+        subscribers,
+    };
+}