@voyantjs/plugin-smartbill 0.77.12 → 0.77.13

package/dist/sync.js

@@ -0,0 +1,299 @@
+import { buildInvoiceIssuedEvent, financeService, } from "@voyantjs/finance";
+import { isSmartbillPdfPersistMetadataUpdateError, persistSmartbillInvoiceArtifact, recordSmartbillInvoiceArtifactFailure, retrySmartbillInvoiceArtifact, } from "./artifacts.js";
+import { createSmartbillSyncRuntime } from "./runtime.js";
+import { parseSmartbillPluginOptions } from "./validation.js";
+export async function syncSmartbillInvoice({ db, invoiceId, pluginOptions, client, issueRuntime, }) {
+    const invoice = await financeService.getInvoiceById(db, invoiceId);
+    if (!invoice)
+        return { status: "not_found", invoiceId };
+    const documentType = documentTypeForInvoice(invoice);
+    if (!documentType) {
+        return { status: "unsupported_document_type", invoiceId, invoiceType: invoice.invoiceType };
+    }
+    const validatedOptions = parseSmartbillPluginOptions(withDefaultArtifactDb(pluginOptions, db));
+    const runtime = createSmartbillSyncRuntime(validatedOptions, client ? { client } : undefined);
+    const issuedEvent = await buildInvoiceIssuedEvent(db, invoice, issueRuntime);
+    const event = { ...issuedEvent, id: issuedEvent.invoiceId };
+    return syncSmartbillInvoiceEvent({
+        event,
+        documentType,
+        runtime,
+        pluginOptions: validatedOptions,
+        operationLabel: documentType === "proforma" ? "createProforma" : "createInvoice",
+    });
+}
+export async function syncSmartbillInvoiceEvent({ event, documentType, runtime, pluginOptions, operationLabel = documentType === "proforma" ? "createProforma" : "createInvoice", }) {
+    try {
+        const body = await runtime.mapEvent(event);
+        const existingRef = await findExistingSmartbillRef(event, documentType, body, runtime);
+        if (existingRef) {
+            return handleExistingSmartbillRef(event, documentType, body, existingRef, runtime);
+        }
+        const result = documentType === "proforma"
+            ? await runtime.client.createProforma(body)
+            : await runtime.client.createInvoice(body);
+        runtime.logger.info?.(`[smartbill] ${documentType} created: ${result.series}-${result.number} for ${event.id}`, result);
+        const artifact = await persistArtifact(event, documentType, body, result, runtime);
+        await writeBackInvoiceNumberIfRequired(event, documentType, body, result, runtime);
+        await applyExternalAllocationIfRequired(event, documentType, body, result, runtime);
+        return { status: "created", invoiceId: event.id, documentType, result, artifact };
+    }
+    catch (err) {
+        runtime.logger.error(`[smartbill] ${operationLabel} failed for ${event.id}`, err);
+        await recordSyncError(event, documentType, err, runtime, pluginOptions);
+        throw err;
+    }
+}
+async function findExistingSmartbillRef(event, documentType, body, runtime) {
+    if (runtime.idempotency.skipExistingExternalRef === false)
+        return null;
+    const db = await resolveArtifactDb(event, documentType, body, undefined, runtime);
+    if (!db)
+        return null;
+    const refs = await financeService.listInvoiceExternalRefs(db, event.id);
+    return refs.find((ref) => isMatchingSmartbillRef(ref, documentType)) ?? null;
+}
+async function handleExistingSmartbillRef(event, documentType, body, externalRef, runtime) {
+    runtime.logger.info?.(`[smartbill] ${documentType} already has SmartBill ref for ${event.id}; skipping create`, externalRef);
+    await applyExternalAllocationFromRefIfRequired(event, documentType, body, externalRef, runtime);
+    await writeBackInvoiceNumberFromRefIfRequired(event, documentType, body, externalRef, runtime);
+    let artifact = null;
+    try {
+        artifact = await retrySmartbillInvoiceArtifact({
+            runtime: runtime.artifacts,
+            client: runtime.client,
+            externalRef,
+            documentType,
+        });
+        if (artifact.status === "persisted") {
+            runtime.logger.info?.(`[smartbill] ${documentType} PDF re-attached for ${event.id}`, artifact);
+        }
+    }
+    catch (err) {
+        const message = isSmartbillPdfPersistMetadataUpdateError(err)
+            ? `[smartbill] artifact re-attach metadata update failed for ${event.id}`
+            : `[smartbill] artifact re-attach failed for ${event.id}`;
+        runtime.logger.error(message, err);
+    }
+    return { status: "existing_ref", invoiceId: event.id, documentType, externalRef, artifact };
+}
+async function persistArtifact(event, documentType, body, result, runtime) {
+    try {
+        const persisted = await persistSmartbillInvoiceArtifact({
+            runtime: runtime.artifacts,
+            client: runtime.client,
+            event,
+            documentType,
+            body,
+            result,
+        });
+        if (persisted.status === "persisted") {
+            runtime.logger.info?.(`[smartbill] ${documentType} PDF persisted for ${event.id}`, persisted);
+        }
+        return persisted;
+    }
+    catch (err) {
+        if (isSmartbillPdfPersistMetadataUpdateError(err)) {
+            runtime.logger.error(`[smartbill] artifact persistence metadata update failed for ${event.id}`, err);
+            return null;
+        }
+        runtime.logger.error(`[smartbill] artifact persistence failed for ${event.id}`, err);
+        try {
+            await recordSmartbillInvoiceArtifactFailure({
+                runtime: runtime.artifacts,
+                event,
+                documentType,
+                body,
+                result,
+                error: err,
+            });
+        }
+        catch (recordError) {
+            runtime.logger.error(`[smartbill] artifact failure external-ref update failed for ${event.id}`, recordError);
+        }
+        return null;
+    }
+}
+async function applyExternalAllocationIfRequired(event, documentType, body, result, runtime) {
+    if (event.externalAllocationRequired !== true || !result.number)
+        return;
+    const db = await resolveArtifactDb(event, documentType, body, result, runtime);
+    if (!db) {
+        throw new Error("SmartBill external allocation requires artifact database access");
+    }
+    const allocation = await financeService.applyExternalInvoiceAllocation(db, event.id, {
+        invoiceNumber: formatExternalInvoiceNumber(result.series ?? body.seriesName, result.number),
+    });
+    if (allocation.status === "applied") {
+        runtime.logger.info?.(`[smartbill] external number applied for ${event.id}`, allocation.invoice);
+    }
+}
+async function applyExternalAllocationFromRefIfRequired(event, documentType, body, externalRef, runtime) {
+    if (event.externalAllocationRequired !== true)
+        return;
+    const metadata = coerceMetadata(externalRef.metadata);
+    const number = metadataString(metadata, "number") ??
+        externalRef.externalNumber ??
+        externalRef.externalId ??
+        null;
+    if (!number) {
+        throw new Error("SmartBill external allocation requires an existing external number");
+    }
+    await applyExternalAllocationIfRequired(event, documentType, body, {
+        number,
+        series: metadataString(metadata, "series") ??
+            metadataString(metadata, "seriesName") ??
+            body.seriesName,
+        url: externalRef.externalUrl ?? undefined,
+    }, runtime);
+}
+async function resolveWriteBackInvoiceNumber(event, body, result, writeBackInvoiceNumber) {
+    if (!writeBackInvoiceNumber)
+        return null;
+    if (typeof writeBackInvoiceNumber === "function") {
+        const invoiceNumber = await writeBackInvoiceNumber(event, result);
+        if (typeof invoiceNumber !== "string" || invoiceNumber.trim().length === 0) {
+            throw new Error("SmartBill invoice number write-back formatter returned an empty value");
+        }
+        return invoiceNumber;
+    }
+    if (!result.number)
+        return null;
+    return formatExternalInvoiceNumber(result.series ?? body.seriesName, result.number);
+}
+async function writeBackInvoiceNumberIfRequired(event, documentType, body, result, runtime) {
+    const invoiceNumber = await resolveWriteBackInvoiceNumber(event, body, result, runtime.writeBackInvoiceNumber);
+    if (!invoiceNumber)
+        return;
+    const db = await resolveArtifactDb(event, documentType, body, result, runtime);
+    if (!db) {
+        throw new Error("SmartBill invoice number write-back requires artifact database access");
+    }
+    const invoice = await financeService.updateInvoice(db, event.id, { invoiceNumber });
+    if (!invoice) {
+        throw new Error(`SmartBill invoice number write-back failed for missing invoice ${event.id}`);
+    }
+    runtime.logger.info?.(`[smartbill] invoice number write-back applied for ${event.id}`, invoice);
+}
+async function writeBackInvoiceNumberFromRefIfRequired(event, documentType, body, externalRef, runtime) {
+    if (!runtime.writeBackInvoiceNumber)
+        return;
+    const metadata = coerceMetadata(externalRef.metadata);
+    const number = metadataString(metadata, "number") ??
+        externalRef.externalNumber ??
+        externalRef.externalId ??
+        null;
+    if (!number)
+        return;
+    await writeBackInvoiceNumberIfRequired(event, documentType, body, {
+        number,
+        series: metadataString(metadata, "series") ??
+            metadataString(metadata, "seriesName") ??
+            body.seriesName,
+        url: externalRef.externalUrl ?? undefined,
+    }, runtime);
+}
+async function recordSyncError(event, documentType, err, runtime, pluginOptions) {
+    try {
+        await runtime.onError?.(event, err);
+    }
+    catch (handlerError) {
+        runtime.logger.error(`[smartbill] onError handler failed for ${event.id}`, handlerError);
+    }
+    try {
+        const db = await resolveArtifactDb(event, documentType, undefined, undefined, runtime, pluginOptions);
+        if (!db)
+            return;
+        const refs = await financeService.listInvoiceExternalRefs(db, event.id);
+        if (refs.some((ref) => isMatchingSmartbillRef(ref, documentType)))
+            return;
+        await financeService.registerInvoiceExternalRef(db, event.id, {
+            provider: "smartbill",
+            externalId: null,
+            externalNumber: null,
+            externalUrl: null,
+            status: "error",
+            syncedAt: new Date().toISOString(),
+            syncError: errorMessage(err),
+            metadata: { documentType },
+        });
+    }
+    catch (recordError) {
+        runtime.logger.error(`[smartbill] error external-ref recording failed for ${event.id}`, recordError);
+    }
+}
+async function resolveArtifactDb(event, documentType, body, result, runtime, pluginOptions) {
+    if (!runtime.artifacts.db)
+        return null;
+    const context = {
+        event,
+        documentType,
+        body: body ?? {
+            companyVatCode: pluginOptions?.companyVatCode ?? "",
+            client: { name: "Client" },
+            seriesName: await resolveSeriesName(pluginOptions?.seriesName, event),
+            currency: "RON",
+            products: [],
+        },
+        result: result ?? {},
+    };
+    return (await resolveMaybe(runtime.artifacts.db, context)) ?? null;
+}
+function withDefaultArtifactDb(pluginOptions, db) {
+    if (pluginOptions.artifacts?.db || pluginOptions.db)
+        return pluginOptions;
+    return {
+        ...pluginOptions,
+        artifacts: {
+            ...pluginOptions.artifacts,
+            db,
+        },
+    };
+}
+function documentTypeForInvoice(invoice) {
+    if (invoice.invoiceType === "proforma")
+        return "proforma";
+    if (invoice.invoiceType === "invoice")
+        return "invoice";
+    return null;
+}
+async function resolveSeriesName(seriesName, event) {
+    if (typeof seriesName === "function")
+        return seriesName(event);
+    return seriesName ?? "unknown";
+}
+async function resolveMaybe(value, context) {
+    return typeof value === "function"
+        ? await value(context)
+        : value;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+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 formatExternalInvoiceNumber(seriesName, number) {
+    const trimmedNumber = number.trim();
+    const trimmedSeries = seriesName?.trim();
+    if (!trimmedSeries || trimmedNumber.startsWith(`${trimmedSeries}-`))
+        return trimmedNumber;
+    return `${trimmedSeries}-${trimmedNumber}`;
+}
+function isUsableSmartbillRef(ref) {
+    return (ref.provider === "smartbill" &&
+        ref.status !== "error" &&
+        !ref.syncError &&
+        Boolean(ref.externalNumber || ref.externalId));
+}
+function isMatchingSmartbillRef(ref, documentType) {
+    if (!isUsableSmartbillRef(ref))
+        return false;
+    return metadataString(coerceMetadata(ref.metadata), "documentType") === documentType;
+}

package/dist/validation.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import type { SmartbillArtifactPersistenceOptions, SmartbillDbResolver, SmartbillDocumentStorageResolver, SmartbillStorageKeyPrefixResolver } from "./artifacts.js";
-import type { SmartbillErrorHandler, SmartbillIdempotencyOptions, SmartbillInvoiceNumberWriteBackFormatter, SmartbillLogger, SmartbillMapFn, SmartbillSyncEventNames } from "./plugin.js";
+import type { SmartbillErrorHandler, SmartbillIdempotencyOptions, SmartbillInvoiceNumberWriteBackFormatter, SmartbillLogger, SmartbillMapFn, SmartbillPluginOptions, SmartbillSyncEventNames } from "./plugin.js";
 import type { SmartbillFetch } from "./types.js";
 export declare const smartbillPluginOptionsSchema: z.ZodObject<{
     username: z.ZodString;
@@ -27,4 +27,5 @@ export declare const smartbillPluginOptionsSchema: z.ZodObject<{
     documentStorage: z.ZodOptional<z.ZodCustom<SmartbillDocumentStorageResolver | undefined, SmartbillDocumentStorageResolver | undefined>>;
     documentStorageKeyPrefix: z.ZodOptional<z.ZodCustom<SmartbillStorageKeyPrefixResolver | undefined, SmartbillStorageKeyPrefixResolver | undefined>>;
 }, z.core.$strip>;
+export declare function parseSmartbillPluginOptions(options: SmartbillPluginOptions): SmartbillPluginOptions;
 //# 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,mCAAmC,EACnC,mBAAmB,EACnB,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,gBAAgB,CAAA;AAEvB,OAAO,KAAK,EACV,qBAAqB,EACrB,2BAA2B,EAC3B,wCAAwC,EACxC,eAAe,EACf,cAAc,EAEd,uBAAuB,EACxB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAgHhD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;iBAwBK,CAAA"}
+{"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"}

package/dist/validation.js

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import { ZodError, z } from "zod";
 const optionalString = z.string().trim().min(1).optional();
 const optionalUrl = z.string().trim().url().optional();
 const requiredEventString = z.custom((value) => (typeof value === "string" && value.trim().length > 0) || typeof value === "function", "Expected a non-empty string or event resolver function");
@@ -83,3 +83,20 @@ export const smartbillPluginOptionsSchema = z.object({
     documentStorage: optionalDocumentStorage.optional(),
     documentStorageKeyPrefix: optionalDocumentStorageKeyPrefix.optional(),
 });
+export 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/plugin-smartbill",
-  "version": "0.77.12",
+  "version": "0.77.13",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -24,6 +24,16 @@
       "import": "./dist/plugin.js",
       "default": "./dist/plugin.js"
     },
+    "./hono": {
+      "types": "./dist/hono.d.ts",
+      "import": "./dist/hono.js",
+      "default": "./dist/hono.js"
+    },
+    "./sync": {
+      "types": "./dist/sync.d.ts",
+      "import": "./dist/sync.js",
+      "default": "./dist/sync.js"
+    },
     "./invoice-ui": {
       "types": "./dist/invoice-ui.d.ts",
       "import": "./dist/invoice-ui.js",
@@ -47,18 +57,20 @@
   },
   "dependencies": {
     "drizzle-orm": "^0.45.2",
+    "hono": "^4.12.10",
     "zod": "^4.3.6",
-    "@voyantjs/core": "0.77.12",
-    "@voyantjs/finance": "0.77.12",
-    "@voyantjs/storage": "0.77.12"
+    "@voyantjs/core": "0.77.13",
+    "@voyantjs/finance": "0.77.13",
+    "@voyantjs/hono": "0.77.13",
+    "@voyantjs/storage": "0.77.13"
   },
   "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.77.12",
-    "@voyantjs/ui": "0.77.12"
+    "@voyantjs/finance-react": "0.77.13",
+    "@voyantjs/ui": "0.77.13"
   },
   "peerDependenciesMeta": {
     "@tanstack/react-query": {
@@ -89,8 +101,8 @@
     "react-dom": "^19.2.4",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2",
-    "@voyantjs/finance-react": "0.77.12",
-    "@voyantjs/ui": "0.77.12",
+    "@voyantjs/finance-react": "0.77.13",
+    "@voyantjs/ui": "0.77.13",
     "@voyantjs/voyant-typescript-config": "0.1.0"
   },
   "files": [