@voyant-travel/plugin-smartbill 0.119.2

package/dist/artifacts.js

@@ -0,0 +1,295 @@
+// agent-quality: file-size exception -- owner: plugins; existing module stays co-located until a dedicated split preserves behavior and tests.
+import { financeService } from "@voyant-travel/finance";
+export class SmartbillPdfPersistError extends Error {
+    stage;
+    originalError;
+    constructor(stage, error) {
+        super(`SmartBill PDF persist failed at ${stage}: ${errorMessage(error)}`);
+        this.name = "SmartbillPdfPersistError";
+        this.stage = stage;
+        this.originalError = error;
+    }
+}
+export class SmartbillPdfPersistMetadataUpdateError extends Error {
+    originalError;
+    constructor(error) {
+        super(`SmartBill PDF persist metadata update failed: ${errorMessage(error)}`);
+        this.name = "SmartbillPdfPersistMetadataUpdateError";
+        this.originalError = error;
+    }
+}
+export function isSmartbillPdfPersistMetadataUpdateError(error) {
+    return error instanceof SmartbillPdfPersistMetadataUpdateError;
+}
+const SMARTBILL_ATTACHMENT_KIND = "smartbill_pdf";
+function isResolver(value) {
+    return typeof value === "function";
+}
+async function resolveMaybe(value, context) {
+    return isResolver(value) ? await value(context) : value;
+}
+function sanitizeKeyPart(value) {
+    return value.replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "document";
+}
+async function sha256(bytes) {
+    const crypto = globalThis.crypto;
+    if (!crypto?.subtle)
+        return null;
+    const buffer = new ArrayBuffer(bytes.byteLength);
+    new Uint8Array(buffer).set(bytes);
+    const digest = await crypto.subtle.digest("SHA-256", buffer);
+    return `sha256:${Array.from(new Uint8Array(digest))
+        .map((byte) => byte.toString(16).padStart(2, "0"))
+        .join("")}`;
+}
+function smartbillAttachmentName(documentType, seriesName, number) {
+    return `SmartBill ${documentType} ${seriesName}-${number}.pdf`;
+}
+function coerceMetadata(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function metadataString(metadata, key) {
+    const value = metadata?.[key];
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function errorMessage(error) {
+    if (error instanceof SmartbillPdfPersistError)
+        return errorMessage(error.originalError);
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+function errorStage(error) {
+    return error instanceof SmartbillPdfPersistError ? error.stage : "unknown";
+}
+async function withPdfPersistStage(stage, operation) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        throw new SmartbillPdfPersistError(stage, error);
+    }
+}
+function buildSmartbillExternalRefMetadata({ body, result, documentType, extra, }) {
+    return {
+        companyVatCode: body.companyVatCode,
+        seriesName: body.seriesName,
+        series: result.series ?? body.seriesName,
+        number: result.number ?? null,
+        documentType,
+        ...extra,
+    };
+}
+async function registerSmartbillExternalRef(db, invoiceId, body, result, documentType, metadataExtra) {
+    const number = result.number;
+    return financeService.registerInvoiceExternalRef(db, invoiceId, {
+        provider: "smartbill",
+        externalId: number ?? null,
+        externalNumber: number ?? null,
+        externalUrl: result.url ?? null,
+        status: result.errorText ? "error" : "issued",
+        syncedAt: new Date().toISOString(),
+        syncError: result.errorText ?? null,
+        metadata: buildSmartbillExternalRefMetadata({
+            body,
+            result,
+            documentType,
+            extra: metadataExtra,
+        }),
+    });
+}
+async function recordSmartbillInvoiceArtifactReady(db, invoiceId, body, result, documentType, storageKey, existingMetadata) {
+    try {
+        await registerSmartbillExternalRef(db, invoiceId, body, result, documentType, {
+            ...(existingMetadata ?? {}),
+            pdfPersistStatus: "ready",
+            pdfPersistedAt: new Date().toISOString(),
+            pdfStorageKey: storageKey,
+            pdfPersistError: null,
+            pdfPersistStage: null,
+        });
+    }
+    catch (error) {
+        throw new SmartbillPdfPersistMetadataUpdateError(error);
+    }
+}
+export async function persistSmartbillInvoiceArtifact({ runtime, client, event, documentType, body, result, }) {
+    if (!runtime.db)
+        return { status: "skipped", reason: "missing_db" };
+    const context = { event, documentType, body, result };
+    const db = await resolveMaybe(runtime.db, context);
+    if (!db)
+        return { status: "skipped", reason: "missing_db" };
+    const seriesName = result.series ?? body.seriesName;
+    const number = result.number;
+    const externalRef = await registerSmartbillExternalRef(db, event.id, body, result, documentType);
+    if (!externalRef)
+        return { status: "skipped", reason: "missing_invoice" };
+    const storage = await resolveMaybe(runtime.documentStorage, context);
+    if (!storage)
+        return { status: "registered_ref" };
+    if (!number)
+        return { status: "registered_ref", reason: "missing_number" };
+    const keyPrefix = await resolveMaybe(runtime.documentStorageKeyPrefix, context);
+    const persisted = await persistSmartbillPdfArtifact({
+        db,
+        storage,
+        client,
+        invoiceId: event.id,
+        documentType,
+        companyVatCode: body.companyVatCode,
+        seriesName,
+        number,
+        language: body.language ?? null,
+        keyPrefix,
+    });
+    if (persisted.status === "persisted" || persisted.status === "already_exists") {
+        await recordSmartbillInvoiceArtifactReady(db, event.id, body, result, documentType, persisted.attachment?.storageKey ?? null);
+    }
+    return persisted;
+}
+export async function recordSmartbillInvoiceArtifactFailure({ runtime, event, documentType, body, result, error, }) {
+    if (!runtime.db)
+        return { status: "skipped", reason: "missing_db" };
+    const context = { event, documentType, body, result };
+    const db = await resolveMaybe(runtime.db, context);
+    if (!db)
+        return { status: "skipped", reason: "missing_db" };
+    const externalRef = await registerSmartbillExternalRef(db, event.id, body, result, documentType, {
+        pdfPersistStatus: "failed",
+        pdfPersistError: errorMessage(error),
+        pdfPersistStage: errorStage(error),
+        pdfPersistedAt: null,
+    });
+    if (!externalRef)
+        return { status: "skipped", reason: "missing_invoice" };
+    return { status: "registered_ref" };
+}
+export async function retrySmartbillInvoiceArtifact({ runtime, client, externalRef, documentType, }) {
+    if (!runtime.db)
+        return { status: "skipped", reason: "missing_db" };
+    const metadata = coerceMetadata(externalRef.metadata);
+    const companyVatCode = metadataString(metadata, "companyVatCode") ?? metadataString(metadata, "vatCode");
+    const seriesName = metadataString(metadata, "series") ?? metadataString(metadata, "seriesName");
+    const number = metadataString(metadata, "number") ??
+        externalRef.externalNumber ??
+        externalRef.externalId ??
+        null;
+    if (!companyVatCode || !seriesName || !number) {
+        return { status: "skipped", reason: "missing_smartbill_reference" };
+    }
+    const context = {
+        event: { id: externalRef.invoiceId },
+        documentType,
+        body: {
+            companyVatCode,
+            client: { name: "Client" },
+            seriesName,
+            currency: "RON",
+            language: metadataString(metadata, "language") ?? undefined,
+            products: [],
+        },
+        result: {
+            number,
+            series: seriesName,
+            url: externalRef.externalUrl ?? undefined,
+        },
+    };
+    const db = await resolveMaybe(runtime.db, context);
+    if (!db)
+        return { status: "skipped", reason: "missing_db" };
+    const storage = await resolveMaybe(runtime.documentStorage, context);
+    if (!storage)
+        return { status: "skipped", reason: "missing_document_storage" };
+    const keyPrefix = await resolveMaybe(runtime.documentStorageKeyPrefix, context);
+    const result = context.result;
+    let persisted;
+    try {
+        persisted = await persistSmartbillPdfArtifact({
+            db,
+            storage,
+            client,
+            invoiceId: externalRef.invoiceId,
+            documentType,
+            companyVatCode,
+            seriesName,
+            number,
+            language: metadataString(metadata, "language"),
+            keyPrefix,
+        });
+    }
+    catch (error) {
+        await registerSmartbillExternalRef(db, externalRef.invoiceId, context.body, result, documentType, {
+            ...(metadata ?? {}),
+            pdfPersistStatus: "failed",
+            pdfPersistError: errorMessage(error),
+            pdfPersistStage: errorStage(error),
+            pdfPersistedAt: null,
+        });
+        throw error;
+    }
+    if (persisted.status === "persisted" || persisted.status === "already_exists") {
+        await recordSmartbillInvoiceArtifactReady(db, externalRef.invoiceId, context.body, result, documentType, persisted.attachment?.storageKey ?? null, metadata);
+    }
+    return persisted;
+}
+async function persistSmartbillPdfArtifact({ db, storage, client, invoiceId, documentType, companyVatCode, seriesName, number, language, keyPrefix, }) {
+    const existingAttachments = await withPdfPersistStage("attachment_lookup", () => financeService.listInvoiceAttachments(db, invoiceId));
+    const existingSmartbillAttachment = existingAttachments.find((attachment) => attachment.kind === SMARTBILL_ATTACHMENT_KIND);
+    if (existingSmartbillAttachment) {
+        return { status: "already_exists", attachment: existingSmartbillAttachment };
+    }
+    const pdf = documentType === "proforma"
+        ? await withPdfPersistStage("viewEstimatePdf", () => client.viewEstimatePdf(companyVatCode, seriesName, number))
+        : await withPdfPersistStage("viewInvoicePdf", () => client.viewInvoicePdf(companyVatCode, seriesName, number));
+    const defaultPrefix = `invoices/${invoiceId}/smartbill`;
+    const resolvedKeyPrefix = keyPrefix ?? defaultPrefix;
+    const key = `${resolvedKeyPrefix.replace(/\/$/, "")}/${documentType}-${sanitizeKeyPart(seriesName)}-${sanitizeKeyPart(number)}.pdf`;
+    const contentType = pdf.contentType || "application/pdf";
+    const checksum = await sha256(pdf.bytes);
+    const uploaded = await withPdfPersistStage("storage_upload", () => storage.upload(pdf.bytes, {
+        key,
+        contentType,
+        metadata: {
+            provider: "smartbill",
+            documentType,
+            invoiceId,
+            seriesName,
+            number,
+        },
+    }));
+    const commonMetadata = {
+        provider: "smartbill",
+        documentType,
+        companyVatCode,
+        seriesName,
+        number,
+        storageProvider: storage.name,
+        ...(uploaded.url ? { url: uploaded.url } : {}),
+    };
+    const rendition = await withPdfPersistStage("rendition_insert", () => financeService.createInvoiceRendition(db, invoiceId, {
+        format: "pdf",
+        status: "ready",
+        storageKey: uploaded.key,
+        fileSize: pdf.bytes.byteLength,
+        checksum,
+        language: language ?? null,
+        generatedAt: new Date().toISOString(),
+        metadata: commonMetadata,
+    }));
+    const attachment = await withPdfPersistStage("attachment_insert", () => financeService.createInvoiceAttachment(db, invoiceId, {
+        kind: SMARTBILL_ATTACHMENT_KIND,
+        name: smartbillAttachmentName(documentType, seriesName, number),
+        mimeType: contentType,
+        fileSize: pdf.bytes.byteLength,
+        storageKey: uploaded.key,
+        checksum,
+        metadata: {
+            ...commonMetadata,
+            renditionId: rendition?.id ?? null,
+        },
+    }));
+    return { status: "persisted", rendition, attachment };
+}

package/dist/client/errors.d.ts

@@ -0,0 +1,28 @@
+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);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;gBAEf,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB;CAQ/D;AAED,MAAM,WAAW,8BAA+B,SAAQ,wBAAwB;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,IAAI,CAAA;IACnB,SAAS,CAAC,EAAE,IAAI,CAAA;CACjB;AAED,qBAAa,uBAAwB,SAAQ,iBAAiB;IAC5D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,CAAA;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;gBAEb,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,8BAA8B;CAOrE;AAED,qBAAa,kCAAmC,SAAQ,uBAAuB;gBACjE,OAAO,EAAE,8BAA8B;CASpD"}

package/dist/client/errors.js

@@ -0,0 +1,32 @@
+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";
+    }
+}

package/dist/client/fetch.d.ts

@@ -0,0 +1,4 @@
+import type { SmartbillFetch } from "../types.js";
+export declare function createGlobalSmartbillFetch(): SmartbillFetch | undefined;
+export declare function asResilientFetch(fetchImpl: SmartbillFetch): typeof fetch;
+//# sourceMappingURL=fetch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/client/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,wBAAgB,0BAA0B,IAAI,cAAc,GAAG,SAAS,CAGvE;AAYD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,KAAK,CAcxE"}

package/dist/client/fetch.js

@@ -0,0 +1,32 @@
+export function createGlobalSmartbillFetch() {
+    if (typeof globalThis.fetch !== "function")
+        return undefined;
+    return (input, init) => globalThis.fetch(input, init);
+}
+function headersForPluginFetch(headers) {
+    if (!headers)
+        return {};
+    if (headers instanceof Headers || Array.isArray(headers)) {
+        return Object.fromEntries(new Headers(headers).entries());
+    }
+    const out = {};
+    for (const [key, value] of Object.entries(headers))
+        out[key] = String(value);
+    return out;
+}
+export function asResilientFetch(fetchImpl) {
+    return async (input, init = {}) => {
+        const response = await fetchImpl(input instanceof Request ? input.url : String(input), {
+            method: init.method ?? "GET",
+            headers: headersForPluginFetch(init.headers),
+            ...(typeof init.body === "string" ? { body: init.body } : {}),
+        });
+        if (response instanceof Response)
+            return response;
+        const contentType = response.headers?.get("content-type");
+        return new Response(await response.arrayBuffer(), {
+            status: response.status,
+            headers: contentType ? { "content-type": contentType } : undefined,
+        });
+    };
+}

package/dist/client/rate-limit.d.ts

@@ -0,0 +1,8 @@
+export interface ParsedSmartbillRateLimit {
+    errorText: string;
+    retryAfterMs?: number;
+    retryAfterAt?: Date;
+    blockedAt?: Date;
+}
+export declare function parseSmartbillRateLimit(status: number, parsed: unknown, now: Date): ParsedSmartbillRateLimit | null;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/client/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/client/rate-limit.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,IAAI,CAAA;IACnB,SAAS,CAAC,EAAE,IAAI,CAAA;CACjB;AAkDD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,IAAI,GACR,wBAAwB,GAAG,IAAI,CA+BjC"}

package/dist/client/rate-limit.js

@@ -0,0 +1,54 @@
+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;
+    // Treat SmartBill's date string as UTC. The original code used `new
+    // Date(y, m, d, ...)` which interprets components as the JS host's
+    // local time, so the same response decoded to different instants on a
+    // CI runner (UTC) vs. a developer machine (Europe/Bucharest, EEST).
+    // The retry-window math downstream is duration-based (`retryAfterAt -
+    // now`), so anchoring to UTC keeps the math deterministic and matches
+    // the existing test fixtures that assert UTC timestamps.
+    if (match[1]) {
+        const [, day, month, year, hour, minute, second] = match;
+        return new Date(Date.UTC(Number(year), Number(month) - 1, Number(day), Number(hour), Number(minute), Number(second)));
+    }
+    const [, , , , , , , year, month, day, hour, minute, second] = match;
+    return new Date(Date.UTC(Number(year), Number(month) - 1, Number(day), Number(hour), Number(minute), Number(second)));
+}
+export 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,
+    };
+}

package/dist/client/resilience.d.ts

@@ -0,0 +1,36 @@
+import { type CircuitBreaker, type RetryOptions } from "@voyant-travel/utils/resilience";
+/**
+ * Outbound-HTTP resilience knobs for the SmartBill client. Every call goes
+ * through `resilientFetch`, so a slow or down SmartBill fails fast instead
+ * of burning the Worker request's CPU/subrequest budget. Retries only apply
+ * to idempotent operations (GETs, PDF downloads, cancel/restore/delete);
+ * document-creating calls (invoice/proforma create, conversion, reversal)
+ * never retry because SmartBill has no idempotency keys.
+ */
+export interface SmartbillResilienceOptions {
+    /** Per-attempt timeout. Default 10s. */
+    timeoutMs?: number;
+    /**
+     * Retry tuning (attempts/backoff) for retry-eligible operations, or
+     * `false` to disable retries entirely. Defaults to 3 attempts on network
+     * errors/timeouts/429/5xx.
+     */
+    retry?: Pick<RetryOptions, "attempts" | "baseDelayMs" | "maxDelayMs"> | false;
+    /**
+     * Override/share the circuit breaker. Defaults to one breaker per client
+     * instance (clients are per-worker singletons, i.e. one per upstream).
+     * Distinct from the SmartBill-specific rate-limit circuit (`rateLimit`),
+     * which reacts to SmartBill's 403 quota responses.
+     */
+    breaker?: CircuitBreaker;
+}
+/**
+ * Retry on network errors/timeouts/429/5xx, but surface the FINAL failing
+ * response to the caller instead of throwing, so `buildApiError` keeps the
+ * upstream status + body (including SmartBill's rate-limit envelope).
+ */
+export declare function surfacingRetry(maxAttempts: number, tuning?: {
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+}): RetryOptions;
+//# sourceMappingURL=resilience.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resilience.d.ts","sourceRoot":"","sources":["../../src/client/resilience.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAA;AAExC;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B;IACzC,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,aAAa,GAAG,YAAY,CAAC,GAAG,KAAK,CAAA;IAC7E;;;;;OAKG;IACH,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,YAAY,CAcd"}

package/dist/client/resilience.js

@@ -0,0 +1,23 @@
+import { CircuitOpenError, } from "@voyant-travel/utils/resilience";
+/**
+ * Retry on network errors/timeouts/429/5xx, but surface the FINAL failing
+ * response to the caller instead of throwing, so `buildApiError` keeps the
+ * upstream status + body (including SmartBill's rate-limit envelope).
+ */
+export function surfacingRetry(maxAttempts, tuning) {
+    let failedAttempts = 0;
+    return {
+        baseDelayMs: tuning?.baseDelayMs,
+        maxDelayMs: tuning?.maxDelayMs,
+        attempts: maxAttempts,
+        retryOn: ({ response, error }) => {
+            failedAttempts += 1;
+            if (failedAttempts >= maxAttempts)
+                return false;
+            if (error)
+                return !(error instanceof CircuitOpenError);
+            const status = response?.status ?? 0;
+            return status === 429 || status >= 500;
+        },
+    };
+}

package/dist/client.d.ts

@@ -0,0 +1,67 @@
+import { type SmartbillResilienceOptions } from "./client/resilience.js";
+import type { SmartbillEnvelope, SmartbillEstimateInvoicesResponse, SmartbillFetch, SmartbillInvoiceBody, SmartbillInvoiceResponse, SmartbillPdfResponse, SmartbillSeriesResponse, SmartbillStatusResponse, SmartbillTaxesResponse } from "./types.js";
+export type { SmartbillResilienceOptions } from "./client/resilience.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;
+    /** 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;
+    };
+    /** Timeout/retry/circuit-breaker tuning. See {@link SmartbillResilienceOptions}. */
+    resilience?: SmartbillResilienceOptions;
+}
+export interface SmartbillClientApi {
+    /** Create an invoice. Returns the live envelope: series + number + URL + status/message. */
+    createInvoice(body: SmartbillInvoiceBody): Promise<SmartbillInvoiceResponse>;
+    /** Create a proforma invoice. */
+    createProforma(body: SmartbillInvoiceBody): Promise<SmartbillInvoiceResponse>;
+    /** Create an invoice from an existing proforma estimate. */
+    convertEstimateToInvoice(companyVatCode: string, estimateSeriesName: string, estimateNumber: string, body: SmartbillInvoiceBody): Promise<SmartbillInvoiceResponse>;
+    /** Cancel an invoice by series + number. Returns the live envelope. */
+    cancelInvoice(companyVatCode: string, seriesName: string, number: string): Promise<SmartbillEnvelope>;
+    /** Restore a previously cancelled invoice. */
+    restoreInvoice(companyVatCode: string, seriesName: string, number: string): Promise<SmartbillEnvelope>;
+    /** Delete an invoice by series + number. */
+    deleteInvoice(companyVatCode: string, seriesName: string, number: string): Promise<SmartbillEnvelope>;
+    /** Reverse an invoice — issues a credit-note style reversal invoice. */
+    reverseInvoice(companyVatCode: string, seriesName: string, number: string): Promise<SmartbillInvoiceResponse>;
+    /** Download invoice PDF bytes. */
+    viewInvoicePdf(companyVatCode: string, seriesName: string, number: string): Promise<SmartbillPdfResponse>;
+    /**
+     * Alias for {@link viewInvoicePdf}. Kept for backward compatibility with
+     * earlier client versions that only exposed an invoice PDF method.
+     */
+    viewPdf(companyVatCode: string, seriesName: string, number: string): Promise<SmartbillPdfResponse>;
+    /** Download proforma PDF bytes. */
+    viewEstimatePdf(companyVatCode: string, seriesName: string, number: string): Promise<SmartbillPdfResponse>;
+    /** Get payment status for an invoice. */
+    getPaymentStatus(companyVatCode: string, seriesName: string, number: string): Promise<SmartbillStatusResponse>;
+    /** List taxes configured on the SmartBill account. */
+    listTaxes(): Promise<SmartbillTaxesResponse>;
+    /** List document series configured on the SmartBill account. */
+    listSeries(): Promise<SmartbillSeriesResponse>;
+    /** List invoices created from a proforma (conversion lookup). */
+    listEstimateInvoices(companyVatCode: string, seriesName: string, number: string): Promise<SmartbillEstimateInvoicesResponse>;
+}
+export type { SmartbillApiErrorOptions } from "./client/errors.js";
+export { SmartbillApiError, SmartbillRateLimitCircuitOpenError, SmartbillRateLimitError, } from "./client/errors.js";
+export declare function createSmartbillClient(options: SmartbillClientOptions): SmartbillClientApi;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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