@voyantjs/plugin-smartbill 0.78.0 → 0.80.0

package/README.md

@@ -199,6 +199,43 @@ finance records.
 | `./workflows` | Proforma conversion polling and drift reconciliation factories |
 | `./types` | SmartBill adapter and bundle types |
 
+## Rate limits
+
+SmartBill can block an account after bursty traffic. `createSmartbillClient`
+throws `SmartbillRateLimitError` when a response carries SmartBill's
+rate-limit shape, with `retryAfterMs`, `retryAfterAt`, and `blockedAt` when the
+response text contains enough timing data.
+
+For cron or batch pollers, enable the process-local circuit breaker so repeated
+calls do not keep hitting SmartBill while the account is blocked:
+
+```typescript
+import {
+  createSmartbillClient,
+  SmartbillRateLimitCircuitOpenError,
+  SmartbillRateLimitError,
+} from "@voyantjs/plugin-smartbill/client"
+
+const client = createSmartbillClient({
+  username,
+  apiToken,
+  rateLimit: {
+    circuitBreaker: true,
+  },
+})
+
+try {
+  await client.listEstimateInvoices(companyVatCode, seriesName, number)
+} catch (err) {
+  if (
+    err instanceof SmartbillRateLimitError ||
+    err instanceof SmartbillRateLimitCircuitOpenError
+  ) {
+    // Stop the batch and retry after `err.retryAfterMs`.
+  }
+}
+```
+
 ## Local SmartBill Mock
 
 SmartBill does not provide a practical sandbox, and invoice/proforma calls can

package/dist/client.d.ts

@@ -13,6 +13,16 @@ export interface SmartbillClientOptions {
     apiUrl?: string;
     /** Override `fetch` (e.g. in tests). Defaults to global `fetch`. */
     fetch?: SmartbillFetch;
+    /** Optional process-local protection for SmartBill account rate limits. */
+    rateLimit?: {
+        /**
+         * When enabled, the client opens a process-local circuit after the first
+         * SmartBill rate-limit response and skips network calls until retry time.
+         */
+        circuitBreaker?: boolean;
+        /** Test hook for deterministic time. */
+        now?: () => Date;
+    };
 }
 export interface SmartbillClientApi {
     /** Create an invoice. Returns the live envelope: series + number + URL + status/message. */
@@ -45,5 +55,32 @@ export interface SmartbillClientApi {
     /** List invoices created from a proforma (conversion lookup). */
     listEstimateInvoices(companyVatCode: string, seriesName: string, number: string): Promise<SmartbillEstimateInvoicesResponse>;
 }
+export interface SmartbillApiErrorOptions {
+    operation: string;
+    status?: number;
+    body?: string;
+    response?: unknown;
+}
+export declare class SmartbillApiError extends Error {
+    readonly operation: string;
+    readonly status?: number;
+    readonly body?: string;
+    readonly response?: unknown;
+    constructor(message: string, options: SmartbillApiErrorOptions);
+}
+export interface SmartbillRateLimitErrorOptions extends SmartbillApiErrorOptions {
+    retryAfterMs?: number;
+    retryAfterAt?: Date;
+    blockedAt?: Date;
+}
+export declare class SmartbillRateLimitError extends SmartbillApiError {
+    readonly retryAfterMs?: number;
+    readonly retryAfterAt?: Date;
+    readonly blockedAt?: Date;
+    constructor(message: string, options: SmartbillRateLimitErrorOptions);
+}
+export declare class SmartbillRateLimitCircuitOpenError extends SmartbillRateLimitError {
+    constructor(options: SmartbillRateLimitErrorOptions);
+}
 export declare function createSmartbillClient(options: SmartbillClientOptions): SmartbillClientApi;
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,iCAAiC,EACjC,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACvB,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,4FAA4F;IAC5F,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,uEAAuE;IACvE,aAAa,CACX,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC7B,8CAA8C;IAC9C,cAAc,CACZ,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC7B,4CAA4C;IAC5C,aAAa,CACX,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC7B,wEAAwE;IACxE,cAAc,CACZ,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,wBAAwB,CAAC,CAAA;IACpC,kCAAkC;IAClC,cAAc,CACZ,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAChC;;;OAGG;IACH,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAClG,mCAAmC;IACnC,eAAe,CACb,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAChC,yCAAyC;IACzC,gBAAgB,CACd,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,uBAAuB,CAAC,CAAA;IACnC,sDAAsD;IACtD,SAAS,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAC5C,gEAAgE;IAChE,UAAU,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAC9C,iEAAiE;IACjE,oBAAoB,CAClB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iCAAiC,CAAC,CAAA;CAC9C;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,kBAAkB,CAqMzF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -1,6 +1,87 @@
+export class SmartbillApiError extends Error {
+    operation;
+    status;
+    body;
+    response;
+    constructor(message, options) {
+        super(message);
+        this.name = "SmartbillApiError";
+        this.operation = options.operation;
+        this.status = options.status;
+        this.body = options.body;
+        this.response = options.response;
+    }
+}
+export class SmartbillRateLimitError extends SmartbillApiError {
+    retryAfterMs;
+    retryAfterAt;
+    blockedAt;
+    constructor(message, options) {
+        super(message, options);
+        this.name = "SmartbillRateLimitError";
+        this.retryAfterMs = options.retryAfterMs;
+        this.retryAfterAt = options.retryAfterAt;
+        this.blockedAt = options.blockedAt;
+    }
+}
+export class SmartbillRateLimitCircuitOpenError extends SmartbillRateLimitError {
+    constructor(options) {
+        super(`SmartBill rate-limit circuit is open${options.retryAfterMs !== undefined ? `; retry after ${options.retryAfterMs}ms` : ""}`, options);
+        this.name = "SmartbillRateLimitCircuitOpenError";
+    }
+}
+const RATE_LIMIT_TEXT_PATTERN = /limita\s+maxima\s+de\s+requesturi|vei\s+putea\s+executa\s+alte\s+requesturi/i;
+const RATE_LIMIT_MINUTES_PATTERN = /dupa\s+(\d+)\s*min/i;
+const RATE_LIMIT_DATE_PATTERN = /(\d{1,2})\/(\d{1,2})\/(\d{4})\s+(\d{1,2}):(\d{2}):(\d{2})|(\d{4})-(\d{1,2})-(\d{1,2})\s+(\d{1,2}):(\d{2}):(\d{2})/;
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function parseSmartbillDate(value) {
+    const match = RATE_LIMIT_DATE_PATTERN.exec(value);
+    if (!match)
+        return undefined;
+    if (match[1]) {
+        const [, day, month, year, hour, minute, second] = match;
+        return new Date(Number(year), Number(month) - 1, Number(day), Number(hour), Number(minute), Number(second));
+    }
+    const [, , , , , , , year, month, day, hour, minute, second] = match;
+    return new Date(Number(year), Number(month) - 1, Number(day), Number(hour), Number(minute), Number(second));
+}
+function parseSmartbillRateLimit(status, parsed, now) {
+    if (!isRecord(parsed))
+        return null;
+    const errorText = typeof parsed.errorText === "string"
+        ? parsed.errorText
+        : typeof parsed.message === "string"
+            ? parsed.message
+            : "";
+    if (status !== 403 && !RATE_LIMIT_TEXT_PATTERN.test(errorText))
+        return null;
+    if (!RATE_LIMIT_TEXT_PATTERN.test(errorText))
+        return null;
+    const minutesMatch = RATE_LIMIT_MINUTES_PATTERN.exec(errorText);
+    const blockedAt = parseSmartbillDate(errorText);
+    const minutes = minutesMatch?.[1] ? Number(minutesMatch[1]) : undefined;
+    const retryAfterAt = blockedAt && minutes !== undefined
+        ? new Date(blockedAt.getTime() + minutes * 60_000)
+        : typeof parsed.cooldown === "number" && parsed.cooldown > 0
+            ? new Date(now.getTime() + parsed.cooldown * 1000)
+            : undefined;
+    const retryAfterMs = retryAfterAt
+        ? Math.max(0, retryAfterAt.getTime() - now.getTime())
+        : undefined;
+    return {
+        errorText,
+        retryAfterMs,
+        retryAfterAt,
+        blockedAt,
+    };
+}
 export function createSmartbillClient(options) {
     const apiUrl = (options.apiUrl ?? "https://ws.smartbill.ro/SBORO/api").replace(/\/$/, "");
-    const fetchImpl = options.fetch ?? globalThis.fetch;
+    const fetchImpl = options.fetch ?? createGlobalSmartbillFetch();
+    const now = options.rateLimit?.now ?? (() => new Date());
+    let rateLimitCircuitOpenUntil;
     function authHeader() {
         return `Basic ${btoa(`${options.username}:${options.apiToken}`)}`;
     }
@@ -15,6 +96,7 @@ export function createSmartbillClient(options) {
         if (!fetchImpl) {
             throw new Error("SmartBill client requires a fetch implementation");
         }
+        assertRateLimitCircuitClosed(operation);
         const init = {
             method,
             headers: headers(),
@@ -32,11 +114,11 @@ export function createSmartbillClient(options) {
             // leave parsed as null, surface text
         }
         if (!response.ok) {
-            throw new Error(`SmartBill ${operation} failed (${response.status}): ${text}`);
+            throw buildApiError(operation, response.status, text, parsed);
         }
         const envelope = (parsed ?? {});
         if (envelope.status === "Error" || envelope.errorText) {
-            throw new Error(`SmartBill ${operation} failed: ${envelope.errorText ?? envelope.message ?? "Error"}`);
+            throw buildApiError(operation, response.status, text, parsed);
         }
         return envelope;
     }
@@ -44,13 +126,14 @@ export function createSmartbillClient(options) {
         if (!fetchImpl) {
             throw new Error("SmartBill client requires a fetch implementation");
         }
+        assertRateLimitCircuitClosed(operation);
         const response = await fetchImpl(`${apiUrl}${path}`, {
             method: "GET",
             headers: { ...headers(), Accept: "application/octet-stream" },
         });
         if (!response.ok) {
             const text = await response.text().catch(() => "");
-            throw new Error(`SmartBill ${operation} failed (${response.status}): ${text}`);
+            throw buildApiError(operation, response.status, text, parseJson(text));
         }
         const buffer = await response.arrayBuffer();
         const contentType = response.headers?.get("content-type") ?? "application/pdf";
@@ -59,6 +142,55 @@ export function createSmartbillClient(options) {
     function pdfQuery(companyVatCode, seriesName, number) {
         return `cif=${encodeURIComponent(companyVatCode)}&seriesname=${encodeURIComponent(seriesName)}&number=${encodeURIComponent(number)}`;
     }
+    function assertRateLimitCircuitClosed(operation) {
+        if (!options.rateLimit?.circuitBreaker || !rateLimitCircuitOpenUntil)
+            return;
+        const currentTime = now();
+        if (currentTime.getTime() >= rateLimitCircuitOpenUntil.getTime()) {
+            rateLimitCircuitOpenUntil = undefined;
+            return;
+        }
+        throw new SmartbillRateLimitCircuitOpenError({
+            operation,
+            retryAfterAt: rateLimitCircuitOpenUntil,
+            retryAfterMs: rateLimitCircuitOpenUntil.getTime() - currentTime.getTime(),
+        });
+    }
+    function buildApiError(operation, status, text, parsed) {
+        const rateLimit = parseSmartbillRateLimit(status, parsed, now());
+        if (rateLimit) {
+            if (options.rateLimit?.circuitBreaker && rateLimit.retryAfterAt) {
+                rateLimitCircuitOpenUntil = rateLimit.retryAfterAt;
+            }
+            return new SmartbillRateLimitError(`SmartBill ${operation} rate-limited: ${rateLimit.errorText}`, {
+                operation,
+                status,
+                body: text,
+                response: parsed,
+                retryAfterMs: rateLimit.retryAfterMs,
+                retryAfterAt: rateLimit.retryAfterAt,
+                blockedAt: rateLimit.blockedAt,
+            });
+        }
+        const envelope = isRecord(parsed) ? parsed : null;
+        const message = envelope?.errorText || envelope?.message
+            ? `SmartBill ${operation} failed: ${envelope.errorText ?? envelope.message ?? "Error"}`
+            : `SmartBill ${operation} failed (${status}): ${text}`;
+        return new SmartbillApiError(message, {
+            operation,
+            status,
+            body: text,
+            response: parsed,
+        });
+    }
+    function parseJson(text) {
+        try {
+            return text ? JSON.parse(text) : null;
+        }
+        catch {
+            return null;
+        }
+    }
     async function createInvoice(body) {
         return request("createInvoice", "POST", "/invoice", body);
     }
@@ -123,3 +255,8 @@ export function createSmartbillClient(options) {
         listEstimateInvoices,
     };
 }
+function createGlobalSmartbillFetch() {
+    if (typeof globalThis.fetch !== "function")
+        return undefined;
+    return (input, init) => globalThis.fetch(input, init);
+}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export type { RetrySmartbillInvoiceArtifactInput, SmartbillArtifactPersistenceOptions, SmartbillArtifactPersistenceResult, SmartbillArtifactPersistenceRuntime, SmartbillArtifactStorageContext, SmartbillDbResolver, SmartbillDocumentStorageResolver, SmartbillDocumentType, SmartbillExternalRef, SmartbillStorageKeyPrefixResolver, } from "./artifacts.js";
 export { retrySmartbillInvoiceArtifact } from "./artifacts.js";
-export type { SmartbillClientApi, SmartbillClientOptions } from "./client.js";
-export { createSmartbillClient } from "./client.js";
+export type { SmartbillApiErrorOptions, SmartbillClientApi, SmartbillClientOptions, } from "./client.js";
+export { createSmartbillClient, SmartbillApiError, SmartbillRateLimitCircuitOpenError, SmartbillRateLimitError, } from "./client.js";
 export type { SmartbillAdminModuleOptions, SmartbillAdminRouteRuntime, SmartbillPluginOptionsResolver, } from "./hono.js";
 export { buildSmartbillAdminRouteRuntime, createSmartbillAdminModule, createSmartbillAdminRoutes, SMARTBILL_ADMIN_RUNTIME_CONTAINER_KEY, } from "./hono.js";
 export type { SmartbillEventValue, SmartbillMappingOptions, SmartbillMaybePromise, } from "./mapping.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kCAAkC,EAClC,mCAAmC,EACnC,kCAAkC,EAClC,mCAAmC,EACnC,+BAA+B,EAC/B,mBAAmB,EACnB,gCAAgC,EAChC,qBAAqB,EACrB,oBAAoB,EACpB,iCAAiC,GAClC,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAA;AAC9D,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,EAC1B,0BAA0B,EAC1B,qCAAqC,GACtC,MAAM,WAAW,CAAA;AAClB,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,2BAA2B,EAC3B,gCAAgC,GACjC,MAAM,cAAc,CAAA;AACrB,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,qBAAqB,EACrB,2BAA2B,EAC3B,wCAAwC,EACxC,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,EAC/B,gCAAgC,GACjC,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,sCAAsC,EAAE,MAAM,iBAAiB,CAAA;AACxE,YAAY,EACV,8BAA8B,EAC9B,+BAA+B,EAC/B,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAA;AAC3E,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,iCAAiC,EACjC,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACxB,+BAA+B,EAC/B,8BAA8B,EAC9B,2BAA2B,EAC3B,iCAAiC,EACjC,wCAAwC,EACxC,uCAAuC,EACvC,uBAAuB,EACvB,uBAAuB,EACvB,6BAA6B,EAC7B,6BAA6B,EAC7B,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,8BAA8B,EAC9B,uCAAuC,GACxC,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kCAAkC,EAClC,mCAAmC,EACnC,kCAAkC,EAClC,mCAAmC,EACnC,+BAA+B,EAC/B,mBAAmB,EACnB,gCAAgC,EAChC,qBAAqB,EACrB,oBAAoB,EACpB,iCAAiC,GAClC,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAA;AAC9D,YAAY,EACV,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,kCAAkC,EAClC,uBAAuB,GACxB,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,EAC1B,0BAA0B,EAC1B,qCAAqC,GACtC,MAAM,WAAW,CAAA;AAClB,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,2BAA2B,EAC3B,gCAAgC,GACjC,MAAM,cAAc,CAAA;AACrB,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,qBAAqB,EACrB,2BAA2B,EAC3B,wCAAwC,EACxC,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,EAC/B,gCAAgC,GACjC,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,sCAAsC,EAAE,MAAM,iBAAiB,CAAA;AACxE,YAAY,EACV,8BAA8B,EAC9B,+BAA+B,EAC/B,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAA;AAC3E,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,iCAAiC,EACjC,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACxB,+BAA+B,EAC/B,8BAA8B,EAC9B,2BAA2B,EAC3B,iCAAiC,EACjC,wCAAwC,EACxC,uCAAuC,EACvC,uBAAuB,EACvB,uBAAuB,EACvB,6BAA6B,EAC7B,6BAA6B,EAC7B,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,8BAA8B,EAC9B,uCAAuC,GACxC,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -1,5 +1,5 @@
 export { retrySmartbillInvoiceArtifact } from "./artifacts.js";
-export { createSmartbillClient } from "./client.js";
+export { createSmartbillClient, SmartbillApiError, SmartbillRateLimitCircuitOpenError, SmartbillRateLimitError, } from "./client.js";
 export { buildSmartbillAdminRouteRuntime, createSmartbillAdminModule, createSmartbillAdminRoutes, SMARTBILL_ADMIN_RUNTIME_CONTAINER_KEY, } from "./hono.js";
 export { mapClient, mapLineItems, mapVoyantInvoiceToSmartbill, mapVoyantInvoiceToSmartbillAsync, } from "./mapping.js";
 export { createSmartbillMockServer } from "./mock.js";

package/dist/validation.d.ts

@@ -9,6 +9,13 @@ export declare const smartbillPluginOptionsSchema: z.ZodObject<{
     seriesName: z.ZodCustom<import("./mapping.js").SmartbillEventValue<string>, import("./mapping.js").SmartbillEventValue<string>>;
     apiUrl: z.ZodOptional<z.ZodString>;
     fetch: z.ZodOptional<z.ZodCustom<SmartbillFetch | undefined, SmartbillFetch | undefined>>;
+    rateLimit: z.ZodOptional<z.ZodCustom<{
+        circuitBreaker?: boolean;
+        now?: () => Date;
+    } | undefined, {
+        circuitBreaker?: boolean;
+        now?: () => Date;
+    } | undefined>>;
     language: z.ZodOptional<z.ZodString>;
     isTaxIncluded: z.ZodOptional<z.ZodBoolean>;
     measuringUnitName: z.ZodOptional<z.ZodCustom<import("./mapping.js").SmartbillEventValue<string | null | undefined>, import("./mapping.js").SmartbillEventValue<string | null | undefined>>>;

package/dist/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,CAAC,EAAE,MAAM,KAAK,CAAA;AACjC,OAAO,KAAK,EACV,mCAAmC,EACnC,mBAAmB,EACnB,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,gBAAgB,CAAA;AAEvB,OAAO,KAAK,EACV,qBAAqB,EACrB,2BAA2B,EAC3B,wCAAwC,EACxC,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAgHhD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;iBAwBK,CAAA;AAE9C,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,sBAAsB,GAC9B,sBAAsB,CAexB"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,CAAC,EAAE,MAAM,KAAK,CAAA;AACjC,OAAO,KAAK,EACV,mCAAmC,EACnC,mBAAmB,EACnB,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,gBAAgB,CAAA;AAGvB,OAAO,KAAK,EACV,qBAAqB,EACrB,2BAA2B,EAC3B,wCAAwC,EACxC,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AA0HhD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyBK,CAAA;AAE9C,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,sBAAsB,GAC9B,sBAAsB,CAexB"}

package/dist/validation.js

@@ -6,6 +6,15 @@ const optionalEventText = z.custom((value) => value === undefined ||
     (typeof value === "string" && value.trim().length > 0) ||
     typeof value === "function", "Expected a non-empty string or event resolver function");
 const optionalFetch = z.custom((value) => value === undefined || typeof value === "function", "Expected a fetch implementation function");
+const optionalRateLimit = z.custom((value) => {
+    if (value === undefined)
+        return true;
+    if (typeof value !== "object" || value === null)
+        return false;
+    const options = value;
+    return ((options.circuitBreaker === undefined || typeof options.circuitBreaker === "boolean") &&
+        (options.now === undefined || typeof options.now === "function"));
+}, "Expected valid SmartBill rate-limit options");
 const optionalLogger = z.custom((value) => value === undefined ||
     (typeof value === "object" &&
         value !== null &&
@@ -65,6 +74,7 @@ export const smartbillPluginOptionsSchema = z.object({
     seriesName: requiredEventString,
     apiUrl: optionalUrl,
     fetch: optionalFetch.optional(),
+    rateLimit: optionalRateLimit.optional(),
     language: optionalString,
     isTaxIncluded: z.boolean().optional(),
     measuringUnitName: optionalEventText.optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/plugin-smartbill",
-  "version": "0.78.0",
+  "version": "0.80.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -59,18 +59,18 @@
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.10",
     "zod": "^4.3.6",
-    "@voyantjs/core": "0.78.0",
-    "@voyantjs/finance": "0.78.0",
-    "@voyantjs/hono": "0.78.0",
-    "@voyantjs/storage": "0.78.0"
+    "@voyantjs/core": "0.80.0",
+    "@voyantjs/finance": "0.80.0",
+    "@voyantjs/hono": "0.80.0",
+    "@voyantjs/storage": "0.80.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",
     "lucide-react": "^0.475.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@voyantjs/finance-react": "0.78.0",
-    "@voyantjs/ui": "0.78.0"
+    "@voyantjs/finance-react": "0.80.0",
+    "@voyantjs/ui": "0.80.0"
   },
   "peerDependenciesMeta": {
     "@tanstack/react-query": {
@@ -101,8 +101,8 @@
     "react-dom": "^19.2.4",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2",
-    "@voyantjs/finance-react": "0.78.0",
-    "@voyantjs/ui": "0.78.0",
+    "@voyantjs/finance-react": "0.80.0",
+    "@voyantjs/ui": "0.80.0",
     "@voyantjs/voyant-typescript-config": "0.1.0"
   },
   "files": [