@voyantjs/plugin-smartbill 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -4,5 +4,7 @@ export type { SmartbillMappingOptions } from "./mapping.js";
 export { mapClient, mapLineItems, mapVoyantInvoiceToSmartbill } from "./mapping.js";
 export type { SmartbillLogger, SmartbillMapFn, SmartbillPluginOptions, SmartbillSyncEventNames, } from "./plugin.js";
 export { smartbillPlugin } from "./plugin.js";
+export type { SmartbillInvoiceSettlementPoller, SmartbillInvoiceSettlementPollerOptions, SmartbillSettlementExternalRef, SmartbillSettlementInvoice, SmartbillSettlementPollerContext, SmartbillSettlementPollerResult, } from "./settlement.js";
+export { createSmartbillInvoiceSettlementPoller } from "./settlement.js";
 export type { SmartbillClient, SmartbillFetch, SmartbillInvoiceBody, SmartbillInvoiceResponse, SmartbillPdfResponse, SmartbillProduct, SmartbillStatusResponse, VoyantInvoiceEvent, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAA;AACnF,YAAY,EACV,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,YAAY,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAA;AACnF,YAAY,EACV,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,YAAY,EACV,gCAAgC,EAChC,uCAAuC,EACvC,8BAA8B,EAC9B,0BAA0B,EAC1B,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,sCAAsC,EAAE,MAAM,iBAAiB,CAAA;AACxE,YAAY,EACV,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export { createSmartbillClient } from "./client.js";
 export { mapClient, mapLineItems, mapVoyantInvoiceToSmartbill } from "./mapping.js";
 export { smartbillPlugin } from "./plugin.js";
+export { createSmartbillInvoiceSettlementPoller } from "./settlement.js";

package/dist/settlement.d.ts

@@ -0,0 +1,30 @@
+import type { SmartbillClientOptions } from "./client.js";
+export interface SmartbillInvoiceSettlementPollerOptions extends SmartbillClientOptions {
+    companyVatCode?: string;
+    seriesName?: string;
+}
+export interface SmartbillSettlementInvoice {
+    invoiceNumber: string;
+}
+export interface SmartbillSettlementExternalRef {
+    externalId: string | null;
+    externalNumber: string | null;
+    metadata?: unknown;
+}
+export interface SmartbillSettlementPollerContext {
+    invoice: SmartbillSettlementInvoice;
+    externalRef: SmartbillSettlementExternalRef;
+}
+export interface SmartbillSettlementPollerResult {
+    externalId?: string | null;
+    externalNumber?: string | null;
+    status?: string | null;
+    paidAmountCents?: number | null;
+    unpaidAmountCents?: number | null;
+    settledAt?: string | null;
+    syncError?: string | null;
+    metadata?: Record<string, unknown> | null;
+}
+export type SmartbillInvoiceSettlementPoller = (context: SmartbillSettlementPollerContext) => Promise<SmartbillSettlementPollerResult>;
+export declare function createSmartbillInvoiceSettlementPoller(options: SmartbillInvoiceSettlementPollerOptions): SmartbillInvoiceSettlementPoller;
+//# sourceMappingURL=settlement.d.ts.map

package/dist/settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.d.ts","sourceRoot":"","sources":["../src/settlement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAGzD,MAAM,WAAW,uCAAwC,SAAQ,sBAAsB;IACrF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,8BAA8B;IAC7C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,0BAA0B,CAAA;IACnC,WAAW,EAAE,8BAA8B,CAAA;CAC5C;AAED,MAAM,WAAW,+BAA+B;IAC9C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAC1C;AAED,MAAM,MAAM,gCAAgC,GAAG,CAC7C,OAAO,EAAE,gCAAgC,KACtC,OAAO,CAAC,+BAA+B,CAAC,CAAA;AAuD7C,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,uCAAuC,GAC/C,gCAAgC,CA0ClC"}

package/dist/settlement.js

@@ -0,0 +1,63 @@
+import { createSmartbillClient } from "./client.js";
+function coerceString(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function coerceMetadata(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function resolveCompanyVatCode(metadata, options) {
+    return (coerceString(metadata?.companyVatCode) ??
+        coerceString(metadata?.vatCode) ??
+        options.companyVatCode ??
+        null);
+}
+function resolveSeriesName(metadata, options) {
+    return (coerceString(metadata?.seriesName) ??
+        coerceString(metadata?.series) ??
+        options.seriesName ??
+        null);
+}
+function resolveInvoiceNumber(metadata, externalNumber, externalId, invoiceNumber) {
+    return (coerceString(metadata?.number) ??
+        coerceString(metadata?.invoiceNumber) ??
+        externalNumber ??
+        externalId ??
+        invoiceNumber);
+}
+function toCents(value) {
+    return typeof value === "number" && Number.isFinite(value) ? Math.round(value * 100) : null;
+}
+export function createSmartbillInvoiceSettlementPoller(options) {
+    const client = createSmartbillClient(options);
+    return async ({ invoice, externalRef }) => {
+        const metadata = coerceMetadata(externalRef.metadata);
+        const companyVatCode = resolveCompanyVatCode(metadata, options);
+        const seriesName = resolveSeriesName(metadata, options);
+        const number = resolveInvoiceNumber(metadata, externalRef.externalNumber, externalRef.externalId, invoice.invoiceNumber);
+        if (!companyVatCode) {
+            return { syncError: "SmartBill settlement polling requires companyVatCode" };
+        }
+        if (!seriesName) {
+            return { syncError: "SmartBill settlement polling requires seriesName" };
+        }
+        const status = await client.getPaymentStatus(companyVatCode, seriesName, number);
+        return {
+            externalId: externalRef.externalId ?? null,
+            externalNumber: number,
+            status: status.status ?? null,
+            paidAmountCents: toCents(status.paidAmount),
+            unpaidAmountCents: toCents(status.unpaidAmount),
+            settledAt: status.status === "paid" && typeof status.paidAmount === "number" && status.paidAmount > 0
+                ? new Date().toISOString()
+                : null,
+            syncError: status.errorText ?? null,
+            metadata: {
+                ...(metadata ?? {}),
+                companyVatCode,
+                seriesName,
+            },
+        };
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/plugin-smartbill",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",
   "exports": {
@@ -16,13 +16,17 @@
       "types": "./dist/plugin.d.ts",
       "import": "./dist/plugin.js"
     },
+    "./settlement": {
+      "types": "./dist/settlement.d.ts",
+      "import": "./dist/settlement.js"
+    },
     "./types": {
       "types": "./dist/types.d.ts",
       "import": "./dist/types.js"
     }
   },
   "dependencies": {
-    "@voyantjs/core": "0.3.0"
+    "@voyantjs/core": "0.4.0"
   },
   "devDependencies": {
     "typescript": "^6.0.2",