@voyantjs/plugin-smartbill 0.5.0 → 0.6.0

package/README.md

@@ -1,6 +1,15 @@
 # @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.
+SmartBill e-invoicing sync adapter bundle for Voyant.
+
+Architecturally, this package is primarily:
+
+- a SmartBill e-invoicing adapter
+- a subscriber bundle for finance invoice events
+- an optional plugin bundle for distribution
+
+It subscribes to invoice events and creates, cancels, or syncs invoices via the
+SmartBill REST API for Romanian tax compliance.
 
 ## Install
 
@@ -14,20 +23,25 @@ pnpm add @voyantjs/plugin-smartbill
 import { smartbillPlugin } from "@voyantjs/plugin-smartbill"
 import { createApp } from "@voyantjs/hono"
 
+const smartbillSync = smartbillPlugin({
+  username: env.SMARTBILL_USERNAME,
+  apiToken: env.SMARTBILL_API_TOKEN,
+  companyVatCode: "RO12345678",
+  seriesName: "A",
+  // optional: language, art311SpecialRegime, events, mapEvent, logger
+})
+
 const app = createApp({
-  plugins: [
-    smartbillPlugin({
-      username: env.SMARTBILL_USERNAME,
-      apiToken: env.SMARTBILL_API_TOKEN,
-      companyVatCode: "RO12345678",
-      seriesName: "A",
-      // optional: language, art311SpecialRegime, events, mapEvent, logger
-    }),
-  ],
+  plugins: [smartbillSync],
 })
 ```
 
-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.
+The exported value is an optional distribution bundle. At runtime, the package
+behaves primarily as a subscriber-driven SmartBill sync adapter. By default it
+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
 

package/dist/index.d.ts

@@ -4,6 +4,8 @@ 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 { ResolvedSmartbillSyncEventNames, SmartbillSyncRuntime } from "./runtime.js";
+export { createSmartbillSyncRuntime } from "./runtime.js";
 export type { SmartbillInvoiceSettlementPoller, SmartbillInvoiceSettlementPollerOptions, SmartbillSettlementExternalRef, SmartbillSettlementInvoice, SmartbillSettlementPollerContext, SmartbillSettlementPollerResult, } from "./settlement.js";
 export { createSmartbillInvoiceSettlementPoller } from "./settlement.js";
 export type { SmartbillClient, SmartbillFetch, SmartbillInvoiceBody, SmartbillInvoiceResponse, SmartbillPdfResponse, SmartbillProduct, SmartbillStatusResponse, VoyantInvoiceEvent, } from "./types.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,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,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,4 +1,5 @@
 export { createSmartbillClient } from "./client.js";
 export { mapClient, mapLineItems, mapVoyantInvoiceToSmartbill } from "./mapping.js";
 export { smartbillPlugin } from "./plugin.js";
+export { createSmartbillSyncRuntime } from "./runtime.js";
 export { createSmartbillInvoiceSettlementPoller } from "./settlement.js";

package/dist/plugin.d.ts

@@ -1,55 +1,21 @@
 import type { Plugin } from "@voyantjs/core";
-import { type SmartbillClientOptions } from "./client.js";
-import { mapVoyantInvoiceToSmartbill, type SmartbillMappingOptions } from "./mapping.js";
+import type { SmartbillClientOptions } from "./client.js";
+import type { mapVoyantInvoiceToSmartbill, 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/plugin.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,gBAAgB,CAAA;AAGxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,KAAK,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAExF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAGpD,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,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,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAEnD,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;CACzB;AASD,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAmGvE"}

package/dist/plugin.js

@@ -1,5 +1,6 @@
-import { createSmartbillClient } from "./client.js";
-import { mapVoyantInvoiceToSmartbill } from "./mapping.js";
+import { ZodError } from "zod";
+import { createSmartbillSyncRuntime } from "./runtime.js";
+import { smartbillPluginOptionsSchema } from "./validation.js";
 function coerceEvent(data) {
     if (data == null || typeof data !== "object")
         return null;
@@ -8,41 +9,14 @@ function coerceEvent(data) {
         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 validatedOptions = parseSmartbillPluginOptions(options);
+    const { client, logger, mapEvent, eventNames } = createSmartbillSyncRuntime(validatedOptions);
     const subscribers = [
         {
             event: eventNames.issued,
-            handler: async (data) => {
-                const event = coerceEvent(data);
+            handler: async (envelope) => {
+                const event = coerceEvent(envelope.data);
                 if (!event)
                     return;
                 try {
@@ -57,14 +31,14 @@ export function smartbillPlugin(options) {
         },
         {
             event: eventNames.voided,
-            handler: async (data) => {
-                const event = coerceEvent(data);
+            handler: async (envelope) => {
+                const event = coerceEvent(envelope.data);
                 if (!event)
                     return;
                 try {
                     const seriesName = typeof event.externalSeriesName === "string"
                         ? event.externalSeriesName
-                        : options.seriesName;
+                        : validatedOptions.seriesName;
                     const number = typeof event.externalNumber === "string"
                         ? event.externalNumber
                         : typeof event.invoiceNumber === "string"
@@ -74,7 +48,7 @@ export function smartbillPlugin(options) {
                         logger.error(`[smartbill] cannot cancel invoice ${event.id}: missing external number`);
                         return;
                     }
-                    await client.cancelInvoice(options.companyVatCode, seriesName, number);
+                    await client.cancelInvoice(validatedOptions.companyVatCode, seriesName, number);
                     logger.info?.(`[smartbill] invoice cancelled: ${seriesName}-${number} for ${event.id}`);
                 }
                 catch (err) {
@@ -84,14 +58,14 @@ export function smartbillPlugin(options) {
         },
         {
             event: eventNames.syncRequested,
-            handler: async (data) => {
-                const event = coerceEvent(data);
+            handler: async (envelope) => {
+                const event = coerceEvent(envelope.data);
                 if (!event)
                     return;
                 try {
                     const seriesName = typeof event.externalSeriesName === "string"
                         ? event.externalSeriesName
-                        : options.seriesName;
+                        : validatedOptions.seriesName;
                     const number = typeof event.externalNumber === "string"
                         ? event.externalNumber
                         : typeof event.invoiceNumber === "string"
@@ -101,7 +75,7 @@ export function smartbillPlugin(options) {
                         logger.error(`[smartbill] cannot sync invoice ${event.id}: missing external number`);
                         return;
                     }
-                    const status = await client.getPaymentStatus(options.companyVatCode, seriesName, number);
+                    const status = await client.getPaymentStatus(validatedOptions.companyVatCode, seriesName, number);
                     logger.info?.(`[smartbill] payment status for ${seriesName}-${number}: ${status.status}`, status);
                 }
                 catch (err) {
@@ -116,3 +90,20 @@ export function smartbillPlugin(options) {
         subscribers,
     };
 }
+function parseSmartbillPluginOptions(options) {
+    try {
+        return smartbillPluginOptionsSchema.parse(options);
+    }
+    catch (error) {
+        if (error instanceof ZodError) {
+            const detail = error.issues
+                .map((issue) => {
+                const path = issue.path.join(".") || "options";
+                return `${path}: ${issue.message}`;
+            })
+                .join("; ");
+            throw new Error(`Invalid SmartBill plugin options: ${detail}`);
+        }
+        throw error;
+    }
+}

package/dist/runtime.d.ts

@@ -0,0 +1,15 @@
+import { createSmartbillClient } from "./client.js";
+import type { SmartbillLogger, SmartbillMapFn, SmartbillPluginOptions } from "./plugin.js";
+export interface ResolvedSmartbillSyncEventNames {
+    issued: string;
+    voided: string;
+    syncRequested: string;
+}
+export interface SmartbillSyncRuntime {
+    client: ReturnType<typeof createSmartbillClient>;
+    logger: SmartbillLogger;
+    mapEvent: SmartbillMapFn;
+    eventNames: ResolvedSmartbillSyncEventNames;
+}
+export declare function createSmartbillSyncRuntime(options: SmartbillPluginOptions): SmartbillSyncRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEnD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAG1F,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAA;IAChD,MAAM,EAAE,eAAe,CAAA;IACvB,QAAQ,EAAE,cAAc,CAAA;IACxB,UAAU,EAAE,+BAA+B,CAAA;CAC5C;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,sBAAsB,GAAG,oBAAoB,CAyBhG"}

package/dist/runtime.js

@@ -0,0 +1,26 @@
+import { createSmartbillClient } from "./client.js";
+import { mapVoyantInvoiceToSmartbill } from "./mapping.js";
+export function createSmartbillSyncRuntime(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 ??
+        ((event) => mapVoyantInvoiceToSmartbill(event, mappingOptions));
+    const eventNames = {
+        issued: options.events?.issued ?? "invoice.issued",
+        voided: options.events?.voided ?? "invoice.voided",
+        syncRequested: options.events?.syncRequested ?? "invoice.external.sync.requested",
+    };
+    return {
+        client,
+        logger,
+        mapEvent,
+        eventNames,
+    };
+}

package/dist/validation.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { SmartbillLogger, SmartbillMapFn, SmartbillSyncEventNames } from "./plugin.js";
+import type { SmartbillFetch } from "./types.js";
+export declare const smartbillPluginOptionsSchema: z.ZodObject<{
+    username: z.ZodString;
+    apiToken: z.ZodString;
+    companyVatCode: z.ZodString;
+    seriesName: z.ZodString;
+    apiUrl: z.ZodOptional<z.ZodString>;
+    fetch: z.ZodOptional<z.ZodCustom<SmartbillFetch | undefined, SmartbillFetch | undefined>>;
+    language: z.ZodOptional<z.ZodString>;
+    isTaxIncluded: z.ZodOptional<z.ZodBoolean>;
+    art311SpecialRegime: z.ZodOptional<z.ZodBoolean>;
+    events: z.ZodOptional<z.ZodCustom<SmartbillSyncEventNames | undefined, SmartbillSyncEventNames | undefined>>;
+    mapEvent: z.ZodOptional<z.ZodCustom<SmartbillMapFn | undefined, SmartbillMapFn | undefined>>;
+    logger: z.ZodOptional<z.ZodCustom<SmartbillLogger | undefined, SmartbillLogger | undefined>>;
+}, z.core.$strip>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAEd,uBAAuB,EACxB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAmChD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;iBAaK,CAAA"}

package/dist/validation.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+const optionalString = z.string().trim().min(1).optional();
+const optionalUrl = z.string().trim().url().optional();
+const optionalFetch = z.custom((value) => value === undefined || typeof value === "function", "Expected a fetch implementation function");
+const optionalLogger = z.custom((value) => value === undefined ||
+    (typeof value === "object" &&
+        value !== null &&
+        typeof value.error === "function" &&
+        ((value.info ?? undefined) === undefined ||
+            typeof value.info === "function")), "Expected a logger with an error function");
+const optionalMapEvent = z.custom((value) => value === undefined || typeof value === "function", "Expected a mapEvent function");
+const optionalEvents = z.custom((value) => {
+    if (value === undefined)
+        return true;
+    if (typeof value !== "object" || value === null)
+        return false;
+    const events = value;
+    return [events.issued, events.voided, events.syncRequested].every((entry) => entry === undefined || (typeof entry === "string" && entry.trim().length > 0));
+}, "Expected event names to be non-empty strings");
+export const smartbillPluginOptionsSchema = z.object({
+    username: z.string().trim().min(1),
+    apiToken: z.string().trim().min(1),
+    companyVatCode: z.string().trim().min(1),
+    seriesName: z.string().trim().min(1),
+    apiUrl: optionalUrl,
+    fetch: optionalFetch.optional(),
+    language: optionalString,
+    isTaxIncluded: z.boolean().optional(),
+    art311SpecialRegime: z.boolean().optional(),
+    events: optionalEvents.optional(),
+    mapEvent: optionalMapEvent.optional(),
+    logger: optionalLogger.optional(),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/plugin-smartbill",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",
   "exports": {
@@ -26,7 +26,8 @@
     }
   },
   "dependencies": {
-    "@voyantjs/core": "0.5.0"
+    "zod": "^4.3.6",
+    "@voyantjs/core": "0.6.0"
   },
   "devDependencies": {
     "typescript": "^6.0.2",