@voyantjs/plugin-smartbill 0.31.2 → 0.31.4

package/README.md

@@ -29,6 +29,10 @@ const smartbillSync = smartbillPlugin({
   companyVatCode: "RO12345678",
   seriesName: "A",
   // optional: language, art311SpecialRegime, events, mapEvent, logger
+  artifacts: {
+    db: appDb,
+    documentStorage,
+  },
 })
 
 const app = createApp({
@@ -38,11 +42,22 @@ const app = createApp({
 
 `smartbillPlugin(...)` is the packaged distribution helper. At runtime, the
 package behaves primarily as a subscriber-driven SmartBill sync adapter. By
-default it wires up 3 subscribers (`invoice.issued`, `invoice.voided`,
+default it wires up 4 subscribers (`invoice.issued`,
+`invoice.proforma.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.
 
+When `artifacts.db` is configured, successful invoice/proforma creation also
+registers the SmartBill external reference through `@voyantjs/finance`. When
+`artifacts.documentStorage` is configured, the plugin downloads the generated
+SmartBill PDF, uploads it to document storage, and records both a ready
+`invoice_renditions` row and a `smartbill_pdf` `invoice_attachments` row. The
+upload path defaults to `invoices/<invoiceId>/smartbill/...`; pass
+`artifacts.documentStorageKeyPrefix` to customize it. Existing
+`smartbill_pdf` attachments are reused so repeat event delivery does not upload
+the same PDF again.
+
 ## Exports
 
 | Entry | Description |

package/dist/artifacts.d.ts

@@ -0,0 +1,101 @@
+import type { StorageProvider } from "@voyantjs/storage";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { SmartbillClientApi } from "./client.js";
+import type { SmartbillInvoiceBody, SmartbillInvoiceResponse, VoyantInvoiceEvent } from "./types.js";
+export type SmartbillDocumentType = "invoice" | "proforma";
+export interface SmartbillArtifactStorageContext {
+    event: VoyantInvoiceEvent;
+    documentType: SmartbillDocumentType;
+    body: SmartbillInvoiceBody;
+    result: SmartbillInvoiceResponse;
+}
+export type SmartbillDbResolver = PostgresJsDatabase | ((context: SmartbillArtifactStorageContext) => PostgresJsDatabase | null | Promise<PostgresJsDatabase | null>);
+export type SmartbillDocumentStorageResolver = StorageProvider | null | ((context: SmartbillArtifactStorageContext) => StorageProvider | null | Promise<StorageProvider | null>);
+export type SmartbillStorageKeyPrefixResolver = string | ((context: SmartbillArtifactStorageContext) => string | Promise<string>);
+export interface SmartbillArtifactPersistenceOptions {
+    db?: SmartbillDbResolver;
+    documentStorage?: SmartbillDocumentStorageResolver;
+    documentStorageKeyPrefix?: SmartbillStorageKeyPrefixResolver;
+}
+export interface SmartbillArtifactPersistenceRuntime {
+    db?: SmartbillDbResolver;
+    documentStorage?: SmartbillDocumentStorageResolver;
+    documentStorageKeyPrefix?: SmartbillStorageKeyPrefixResolver;
+}
+export interface PersistSmartbillInvoiceArtifactInput {
+    runtime: SmartbillArtifactPersistenceRuntime;
+    client: SmartbillClientApi;
+    event: VoyantInvoiceEvent;
+    documentType: SmartbillDocumentType;
+    body: SmartbillInvoiceBody;
+    result: SmartbillInvoiceResponse;
+}
+export declare function persistSmartbillInvoiceArtifact({ runtime, client, event, documentType, body, result, }: PersistSmartbillInvoiceArtifactInput): Promise<{
+    status: "skipped";
+    reason: "missing_db";
+    attachment?: undefined;
+    rendition?: undefined;
+} | {
+    status: "skipped";
+    reason: "missing_invoice";
+    attachment?: undefined;
+    rendition?: undefined;
+} | {
+    status: "registered_ref";
+    reason?: undefined;
+    attachment?: undefined;
+    rendition?: undefined;
+} | {
+    status: "registered_ref";
+    reason: "missing_number";
+    attachment?: undefined;
+    rendition?: undefined;
+} | {
+    status: "already_exists";
+    attachment: {
+        id: string;
+        invoiceId: string;
+        kind: string;
+        name: string;
+        mimeType: string | null;
+        fileSize: number | null;
+        storageKey: string | null;
+        checksum: string | null;
+        metadata: unknown;
+        createdAt: Date;
+    };
+    reason?: undefined;
+    rendition?: undefined;
+} | {
+    status: "persisted";
+    rendition: {
+        metadata: unknown;
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        status: "pending" | "failed" | "ready" | "stale";
+        format: "json" | "pdf" | "html" | "xml";
+        errorMessage: string | null;
+        templateId: string | null;
+        language: string | null;
+        invoiceId: string;
+        storageKey: string | null;
+        fileSize: number | null;
+        checksum: string | null;
+        generatedAt: Date | null;
+    } | null;
+    attachment: {
+        metadata: unknown;
+        name: string;
+        id: string;
+        createdAt: Date;
+        kind: string;
+        invoiceId: string;
+        storageKey: string | null;
+        fileSize: number | null;
+        checksum: string | null;
+        mimeType: string | null;
+    } | null;
+    reason?: undefined;
+}>;
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpG,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,UAAU,CAAA;AAE1D,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,kBAAkB,CAAA;IACzB,YAAY,EAAE,qBAAqB,CAAA;IACnC,IAAI,EAAE,oBAAoB,CAAA;IAC1B,MAAM,EAAE,wBAAwB,CAAA;CACjC;AAED,MAAM,MAAM,mBAAmB,GAC3B,kBAAkB,GAClB,CAAC,CACC,OAAO,EAAE,+BAA+B,KACrC,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC,CAAA;AAExE,MAAM,MAAM,gCAAgC,GACxC,eAAe,GACf,IAAI,GACJ,CAAC,CACC,OAAO,EAAE,+BAA+B,KACrC,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,CAAA;AAElE,MAAM,MAAM,iCAAiC,GACzC,MAAM,GACN,CAAC,CAAC,OAAO,EAAE,+BAA+B,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;AAE5E,MAAM,WAAW,mCAAmC;IAClD,EAAE,CAAC,EAAE,mBAAmB,CAAA;IACxB,eAAe,CAAC,EAAE,gCAAgC,CAAA;IAClD,wBAAwB,CAAC,EAAE,iCAAiC,CAAA;CAC7D;AAED,MAAM,WAAW,mCAAmC;IAClD,EAAE,CAAC,EAAE,mBAAmB,CAAA;IACxB,eAAe,CAAC,EAAE,gCAAgC,CAAA;IAClD,wBAAwB,CAAC,EAAE,iCAAiC,CAAA;CAC7D;AAED,MAAM,WAAW,oCAAoC;IACnD,OAAO,EAAE,mCAAmC,CAAA;IAC5C,MAAM,EAAE,kBAAkB,CAAA;IAC1B,KAAK,EAAE,kBAAkB,CAAA;IACzB,YAAY,EAAE,qBAAqB,CAAA;IACnC,IAAI,EAAE,oBAAoB,CAAA;IAC1B,MAAM,EAAE,wBAAwB,CAAA;CACjC;AAwCD,wBAAsB,+BAA+B,CAAC,EACpD,OAAO,EACP,MAAM,EACN,KAAK,EACL,YAAY,EACZ,IAAI,EACJ,MAAM,GACP,EAAE,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiGtC"}

package/dist/artifacts.js

@@ -0,0 +1,114 @@
+import { financeService } from "@voyantjs/finance";
+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`;
+}
+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 financeService.registerInvoiceExternalRef(db, event.id, {
+        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: {
+            companyVatCode: body.companyVatCode,
+            seriesName: body.seriesName,
+            series: seriesName,
+            number: number ?? null,
+            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 existingAttachments = await financeService.listInvoiceAttachments(db, event.id);
+    const existingSmartbillAttachment = existingAttachments.find((attachment) => attachment.kind === SMARTBILL_ATTACHMENT_KIND);
+    if (existingSmartbillAttachment) {
+        return { status: "already_exists", attachment: existingSmartbillAttachment };
+    }
+    const pdf = documentType === "proforma"
+        ? await client.viewEstimatePdf(body.companyVatCode, seriesName, number)
+        : await client.viewInvoicePdf(body.companyVatCode, seriesName, number);
+    const defaultPrefix = `invoices/${event.id}/smartbill`;
+    const keyPrefix = (await resolveMaybe(runtime.documentStorageKeyPrefix, context)) ?? defaultPrefix;
+    const key = `${keyPrefix.replace(/\/$/, "")}/${documentType}-${sanitizeKeyPart(seriesName)}-${sanitizeKeyPart(number)}.pdf`;
+    const contentType = pdf.contentType || "application/pdf";
+    const checksum = await sha256(pdf.bytes);
+    const uploaded = await storage.upload(pdf.bytes, {
+        key,
+        contentType,
+        metadata: {
+            provider: "smartbill",
+            documentType,
+            invoiceId: event.id,
+            seriesName,
+            number,
+        },
+    });
+    const commonMetadata = {
+        provider: "smartbill",
+        documentType,
+        companyVatCode: body.companyVatCode,
+        seriesName,
+        number,
+        storageProvider: storage.name,
+        ...(uploaded.url ? { url: uploaded.url } : {}),
+    };
+    const rendition = await financeService.createInvoiceRendition(db, event.id, {
+        format: "pdf",
+        status: "ready",
+        storageKey: uploaded.key,
+        fileSize: pdf.bytes.byteLength,
+        checksum,
+        language: body.language ?? null,
+        generatedAt: new Date().toISOString(),
+        metadata: commonMetadata,
+    });
+    const attachment = await financeService.createInvoiceAttachment(db, event.id, {
+        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/index.d.ts

@@ -1,3 +1,4 @@
+export type { SmartbillArtifactPersistenceOptions, SmartbillArtifactStorageContext, SmartbillDbResolver, SmartbillDocumentStorageResolver, SmartbillDocumentType, SmartbillStorageKeyPrefixResolver, } from "./artifacts.js";
 export type { SmartbillClientApi, SmartbillClientOptions } from "./client.js";
 export { createSmartbillClient } from "./client.js";
 export type { SmartbillMappingOptions } 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,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,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,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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mCAAmC,EACnC,+BAA+B,EAC/B,mBAAmB,EACnB,gCAAgC,EAChC,qBAAqB,EACrB,iCAAiC,GAClC,MAAM,gBAAgB,CAAA;AACvB,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,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,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,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"}

package/dist/plugin.d.ts

@@ -1,4 +1,5 @@
 import type { Plugin } from "@voyantjs/core";
+import { type SmartbillArtifactPersistenceOptions } from "./artifacts.js";
 import type { SmartbillClientOptions } from "./client.js";
 import type { mapVoyantInvoiceToSmartbill, SmartbillMappingOptions } from "./mapping.js";
 import type { VoyantInvoiceEvent } from "./types.js";
@@ -17,6 +18,19 @@ export interface SmartbillPluginOptions extends SmartbillClientOptions, Smartbil
     events?: SmartbillSyncEventNames;
     mapEvent?: SmartbillMapFn;
     logger?: SmartbillLogger;
+    /**
+     * Optional finance artifact persistence. When `db` is supplied, the plugin
+     * registers the SmartBill external ref after creation. When
+     * `documentStorage` is also supplied, it downloads and stores the generated
+     * SmartBill PDF as both an invoice rendition and attachment.
+     */
+    artifacts?: SmartbillArtifactPersistenceOptions;
+    /** @deprecated Use `artifacts.db`. */
+    db?: SmartbillArtifactPersistenceOptions["db"];
+    /** @deprecated Use `artifacts.documentStorage`. */
+    documentStorage?: SmartbillArtifactPersistenceOptions["documentStorage"];
+    /** @deprecated Use `artifacts.documentStorageKeyPrefix`. */
+    documentStorageKeyPrefix?: SmartbillArtifactPersistenceOptions["documentStorageKeyPrefix"];
 }
 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;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,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,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,CA8HvE"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,gBAAgB,CAAA;AAGxD,OAAO,EAEL,KAAK,mCAAmC,EAEzC,MAAM,gBAAgB,CAAA;AACvB,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,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,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;IACxB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,mCAAmC,CAAA;IAC/C,sCAAsC;IACtC,EAAE,CAAC,EAAE,mCAAmC,CAAC,IAAI,CAAC,CAAA;IAC9C,mDAAmD;IACnD,eAAe,CAAC,EAAE,mCAAmC,CAAC,iBAAiB,CAAC,CAAA;IACxE,4DAA4D;IAC5D,wBAAwB,CAAC,EAAE,mCAAmC,CAAC,0BAA0B,CAAC,CAAA;CAC3F;AAYD,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAwJvE"}

package/dist/plugin.js

@@ -1,17 +1,39 @@
 import { ZodError } from "zod";
+import { persistSmartbillInvoiceArtifact, } from "./artifacts.js";
 import { createSmartbillSyncRuntime } from "./runtime.js";
 import { smartbillPluginOptionsSchema } from "./validation.js";
 function coerceEvent(data) {
     if (data == null || typeof data !== "object")
         return null;
     const maybe = data;
-    if (typeof maybe.id !== "string")
-        return null;
-    return maybe;
+    if (typeof maybe.id === "string")
+        return maybe;
+    if (typeof maybe.invoiceId === "string") {
+        return { ...maybe, id: maybe.invoiceId };
+    }
+    return null;
 }
 export function smartbillPlugin(options) {
     const validatedOptions = parseSmartbillPluginOptions(options);
-    const { client, logger, mapEvent, eventNames } = createSmartbillSyncRuntime(validatedOptions);
+    const { client, logger, mapEvent, eventNames, artifacts } = createSmartbillSyncRuntime(validatedOptions);
+    async function persistArtifact(event, documentType, body, result) {
+        try {
+            const persisted = await persistSmartbillInvoiceArtifact({
+                runtime: artifacts,
+                client,
+                event,
+                documentType,
+                body,
+                result,
+            });
+            if (persisted.status === "persisted") {
+                logger.info?.(`[smartbill] ${documentType} PDF persisted for ${event.id}`, persisted);
+            }
+        }
+        catch (err) {
+            logger.error(`[smartbill] artifact persistence failed for ${event.id}`, err);
+        }
+    }
     const subscribers = [
         {
             event: eventNames.issued,
@@ -23,6 +45,7 @@ export function smartbillPlugin(options) {
                     const body = mapEvent(event);
                     const result = await client.createInvoice(body);
                     logger.info?.(`[smartbill] invoice created: ${result.series}-${result.number} for ${event.id}`, result);
+                    await persistArtifact(event, "invoice", body, result);
                 }
                 catch (err) {
                     logger.error(`[smartbill] createInvoice on "${eventNames.issued}" failed for ${event.id}`, err);
@@ -41,6 +64,7 @@ export function smartbillPlugin(options) {
                     const body = mapEvent(event);
                     const result = await client.createProforma(body);
                     logger.info?.(`[smartbill] proforma created: ${result.series}-${result.number} for ${event.id}`, result);
+                    await persistArtifact(event, "proforma", body, result);
                 }
                 catch (err) {
                     logger.error(`[smartbill] createProforma on "${eventNames.proformaIssued}" failed for ${event.id}`, err);

package/dist/runtime.d.ts

@@ -1,3 +1,4 @@
+import type { SmartbillArtifactPersistenceOptions } from "./artifacts.js";
 import { createSmartbillClient } from "./client.js";
 import type { SmartbillLogger, SmartbillMapFn, SmartbillPluginOptions } from "./plugin.js";
 export interface ResolvedSmartbillSyncEventNames {
@@ -11,6 +12,7 @@ export interface SmartbillSyncRuntime {
     logger: SmartbillLogger;
     mapEvent: SmartbillMapFn;
     eventNames: ResolvedSmartbillSyncEventNames;
+    artifacts: SmartbillArtifactPersistenceOptions;
 }
 export declare function createSmartbillSyncRuntime(options: SmartbillPluginOptions): SmartbillSyncRuntime;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -1 +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,cAAc,EAAE,MAAM,CAAA;IACtB,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,CA0BhG"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,gBAAgB,CAAA;AACzE,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,cAAc,EAAE,MAAM,CAAA;IACtB,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;IAC3C,SAAS,EAAE,mCAAmC,CAAA;CAC/C;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,sBAAsB,GAAG,oBAAoB,CAgChG"}

package/dist/runtime.js

@@ -23,5 +23,10 @@ export function createSmartbillSyncRuntime(options) {
         logger,
         mapEvent,
         eventNames,
+        artifacts: {
+            db: options.artifacts?.db ?? options.db,
+            documentStorage: options.artifacts?.documentStorage ?? options.documentStorage,
+            documentStorageKeyPrefix: options.artifacts?.documentStorageKeyPrefix ?? options.documentStorageKeyPrefix,
+        },
     };
 }

package/dist/validation.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import type { SmartbillArtifactPersistenceOptions, SmartbillDbResolver, SmartbillDocumentStorageResolver, SmartbillStorageKeyPrefixResolver } from "./artifacts.js";
 import type { SmartbillLogger, SmartbillMapFn, SmartbillSyncEventNames } from "./plugin.js";
 import type { SmartbillFetch } from "./types.js";
 export declare const smartbillPluginOptionsSchema: z.ZodObject<{
@@ -14,5 +15,9 @@ export declare const smartbillPluginOptionsSchema: z.ZodObject<{
     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>>;
+    artifacts: z.ZodOptional<z.ZodCustom<SmartbillArtifactPersistenceOptions | undefined, SmartbillArtifactPersistenceOptions | undefined>>;
+    db: z.ZodOptional<z.ZodCustom<SmartbillDbResolver | undefined, SmartbillDbResolver | undefined>>;
+    documentStorage: z.ZodOptional<z.ZodCustom<SmartbillDocumentStorageResolver | undefined, SmartbillDocumentStorageResolver | undefined>>;
+    documentStorageKeyPrefix: z.ZodOptional<z.ZodCustom<SmartbillStorageKeyPrefixResolver | undefined, SmartbillStorageKeyPrefixResolver | undefined>>;
 }, z.core.$strip>;
 //# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -1 +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"}
+{"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,mCAAmC,EACnC,mBAAmB,EACnB,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAEd,uBAAuB,EACxB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AA+EhD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;iBAiBK,CAAA"}

package/dist/validation.js

@@ -9,13 +9,39 @@ const optionalLogger = z.custom((value) => value === undefined ||
         ((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 optionalDb = z.custom((value) => value === undefined ||
+    typeof value === "function" ||
+    (typeof value === "object" && value !== null), "Expected a database handle or resolver function");
+function isStorageProvider(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.upload === "function" &&
+        typeof value.delete === "function" &&
+        typeof value.signedUrl === "function" &&
+        typeof value.get === "function");
+}
+const optionalDocumentStorage = z.custom((value) => value === undefined ||
+    value === null ||
+    typeof value === "function" ||
+    isStorageProvider(value), "Expected a storage provider or resolver function");
+const optionalDocumentStorageKeyPrefix = z.custom((value) => value === undefined || typeof value === "string" || typeof value === "function", "Expected a storage key prefix string or resolver function");
+const optionalArtifacts = z.custom((value) => {
+    if (value === undefined)
+        return true;
+    if (typeof value !== "object" || value === null)
+        return false;
+    const artifacts = value;
+    return (optionalDb.safeParse(artifacts.db).success &&
+        optionalDocumentStorage.safeParse(artifacts.documentStorage).success &&
+        optionalDocumentStorageKeyPrefix.safeParse(artifacts.documentStorageKeyPrefix).success);
+}, "Expected valid SmartBill artifact persistence options");
 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));
+    return [events.issued, events.proformaIssued, 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),
@@ -30,4 +56,8 @@ export const smartbillPluginOptionsSchema = z.object({
     events: optionalEvents.optional(),
     mapEvent: optionalMapEvent.optional(),
     logger: optionalLogger.optional(),
+    artifacts: optionalArtifacts.optional(),
+    db: optionalDb.optional(),
+    documentStorage: optionalDocumentStorage.optional(),
+    documentStorageKeyPrefix: optionalDocumentStorageKeyPrefix.optional(),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/plugin-smartbill",
-  "version": "0.31.2",
+  "version": "0.31.4",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -36,8 +36,11 @@
     }
   },
   "dependencies": {
+    "drizzle-orm": "^0.45.2",
     "zod": "^4.3.6",
-    "@voyantjs/core": "0.31.2"
+    "@voyantjs/core": "0.31.4",
+    "@voyantjs/finance": "0.31.4",
+    "@voyantjs/storage": "0.31.4"
   },
   "devDependencies": {
     "typescript": "^6.0.2",