@voyant-travel/plugin-smartbill 0.119.2

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/validation.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import type { SmartbillArtifactPersistenceOptions, SmartbillDbResolver, SmartbillDocumentStorageResolver, SmartbillStorageKeyPrefixResolver } from "./artifacts.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;
+    apiToken: z.ZodString;
+    companyVatCode: z.ZodString;
+    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>>;
+    resilience: z.ZodOptional<z.ZodCustom<import("./client.js").SmartbillResilienceOptions | undefined, import("./client.js").SmartbillResilienceOptions | 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>>>;
+    art311SpecialRegime: z.ZodOptional<z.ZodBoolean>;
+    art311SpecialRegimeText: z.ZodOptional<z.ZodString>;
+    mentions: z.ZodOptional<z.ZodCustom<import("./mapping.js").SmartbillEventValue<string | null | undefined>, import("./mapping.js").SmartbillEventValue<string | null | undefined>>>;
+    observations: z.ZodOptional<z.ZodCustom<import("./mapping.js").SmartbillEventValue<string | null | undefined>, import("./mapping.js").SmartbillEventValue<string | null | undefined>>>;
+    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>>;
+    idempotency: z.ZodOptional<z.ZodCustom<SmartbillIdempotencyOptions | undefined, SmartbillIdempotencyOptions | undefined>>;
+    onError: z.ZodOptional<z.ZodCustom<SmartbillErrorHandler | undefined, SmartbillErrorHandler | undefined>>;
+    writeBackInvoiceNumber: z.ZodOptional<z.ZodCustom<boolean | SmartbillInvoiceNumberWriteBackFormatter | undefined, boolean | SmartbillInvoiceNumberWriteBackFormatter | 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>;
+export declare function parseSmartbillPluginOptions(options: SmartbillPluginOptions): SmartbillPluginOptions;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +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;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;AAmIhD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0BK,CAAA;AAE9C,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,sBAAsB,GAC9B,sBAAsB,CAexB"}

package/dist/validation.js

@@ -0,0 +1,120 @@
+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");
+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 optionalResilience = z.custom((value) => value === undefined || (typeof value === "object" && value !== null), "Expected valid resilience options");
+const optionalLogger = z.custom((value) => value === undefined ||
+    (typeof value === "object" &&
+        value !== null &&
+        typeof value.error === "function" &&
+        ((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 optionalOnError = z.custom((value) => value === undefined || typeof value === "function", "Expected an onError function");
+const optionalWriteBackInvoiceNumber = z.custom((value) => value === undefined || typeof value === "boolean" || typeof value === "function", "Expected a boolean or invoice number formatter 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.proformaIssued,
+        events.proformaConverted,
+        events.voided,
+        events.syncRequested,
+    ].every((entry) => entry === undefined || (typeof entry === "string" && entry.trim().length > 0));
+}, "Expected event names to be non-empty strings");
+const optionalIdempotency = z.custom((value) => {
+    if (value === undefined)
+        return true;
+    if (typeof value !== "object" || value === null)
+        return false;
+    const options = value;
+    return (options.skipExistingExternalRef === undefined ||
+        typeof options.skipExistingExternalRef === "boolean");
+}, "Expected valid SmartBill idempotency options");
+export const smartbillPluginOptionsSchema = z.object({
+    username: z.string().trim().min(1),
+    apiToken: z.string().trim().min(1),
+    companyVatCode: z.string().trim().min(1),
+    seriesName: requiredEventString,
+    apiUrl: optionalUrl,
+    fetch: optionalFetch.optional(),
+    rateLimit: optionalRateLimit.optional(),
+    resilience: optionalResilience.optional(),
+    language: optionalString,
+    isTaxIncluded: z.boolean().optional(),
+    measuringUnitName: optionalEventText.optional(),
+    art311SpecialRegime: z.boolean().optional(),
+    art311SpecialRegimeText: optionalString,
+    mentions: optionalEventText.optional(),
+    observations: optionalEventText.optional(),
+    events: optionalEvents.optional(),
+    mapEvent: optionalMapEvent.optional(),
+    logger: optionalLogger.optional(),
+    idempotency: optionalIdempotency.optional(),
+    onError: optionalOnError.optional(),
+    writeBackInvoiceNumber: optionalWriteBackInvoiceNumber.optional(),
+    artifacts: optionalArtifacts.optional(),
+    db: optionalDb.optional(),
+    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/dist/workflow-candidates.d.ts

@@ -0,0 +1,36 @@
+import { type Invoice } from "@voyant-travel/finance";
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import type { SmartbillReferenceParts, SmartbillWorkflowDocumentType, SmartbillWorkflowExternalRef } from "./workflows.js";
+export type SmartbillWorkflowCandidateSource = "external_refs" | "invoices";
+export interface SmartbillCandidateInvoice {
+    invoiceId: string;
+    invoiceNumber: string;
+    invoiceType?: Invoice["invoiceType"];
+    documentType?: SmartbillWorkflowDocumentType;
+    companyVatCode?: string | null;
+    seriesName?: string | null;
+    series?: string | null;
+    number?: string | null;
+    sequence?: number | null;
+    status?: Invoice["status"];
+    currency?: string | null;
+    totalCents?: number | null;
+    paidCents?: number | null;
+    balanceDueCents?: number | null;
+    metadata?: Record<string, unknown> | null;
+}
+export interface SmartbillCandidateExternalRefRecorderContext {
+    candidate: SmartbillCandidateInvoice;
+    document: SmartbillReferenceParts;
+    ref: SmartbillWorkflowExternalRef;
+}
+export type SmartbillCandidateExternalRefRecorder = (context: SmartbillCandidateExternalRefRecorderContext) => Promise<SmartbillWorkflowExternalRef | null | undefined>;
+export interface SmartbillCandidateSourceOptions {
+    db?: PostgresJsDatabase;
+    limit?: number;
+    companyVatCode?: string;
+    listCandidateInvoices?: () => Promise<SmartbillCandidateInvoice[]>;
+    recordCandidateExternalRef?: SmartbillCandidateExternalRefRecorder;
+}
+export declare function loadSmartbillCandidateRefs(options: SmartbillCandidateSourceOptions): Promise<SmartbillWorkflowExternalRef[]>;
+//# sourceMappingURL=workflow-candidates.d.ts.map

package/dist/workflow-candidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-candidates.d.ts","sourceRoot":"","sources":["../src/workflow-candidates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,OAAO,EAAiC,MAAM,wBAAwB,CAAA;AAEpG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,OAAO,KAAK,EACV,uBAAuB,EACvB,6BAA6B,EAC7B,4BAA4B,EAE7B,MAAM,gBAAgB,CAAA;AAEvB,MAAM,MAAM,gCAAgC,GAAG,eAAe,GAAG,UAAU,CAAA;AAE3E,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IACpC,YAAY,CAAC,EAAE,6BAA6B,CAAA;IAC5C,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAC1C;AAED,MAAM,WAAW,4CAA4C;IAC3D,SAAS,EAAE,yBAAyB,CAAA;IACpC,QAAQ,EAAE,uBAAuB,CAAA;IACjC,GAAG,EAAE,4BAA4B,CAAA;CAClC;AAED,MAAM,MAAM,qCAAqC,GAAG,CAClD,OAAO,EAAE,4CAA4C,KAClD,OAAO,CAAC,4BAA4B,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAE7D,MAAM,WAAW,+BAA+B;IAC9C,EAAE,CAAC,EAAE,kBAAkB,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAA;IAClE,0BAA0B,CAAC,EAAE,qCAAqC,CAAA;CACnE;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAazC"}

package/dist/workflow-candidates.js

@@ -0,0 +1,182 @@
+import { financeService, invoiceNumberSeries, invoices } from "@voyant-travel/finance";
+import { and, desc, eq, inArray } from "drizzle-orm";
+export async function loadSmartbillCandidateRefs(options) {
+    const candidates = options.listCandidateInvoices
+        ? await options.listCandidateInvoices()
+        : await loadDbCandidateInvoices(options);
+    const refs = [];
+    for (const candidate of candidates) {
+        const document = resolveCandidateReferenceParts(candidate, options.companyVatCode);
+        const ref = toCandidateWorkflowExternalRef(candidate, document);
+        refs.push(document ? await recordCandidateExternalRef(options, candidate, document, ref) : ref);
+    }
+    return refs;
+}
+async function loadDbCandidateInvoices(options) {
+    if (!options.db) {
+        throw new Error("SmartBill invoice candidate source requires db or listCandidateInvoices");
+    }
+    const rows = await options.db
+        .select({
+        invoice: {
+            id: invoices.id,
+            invoiceNumber: invoices.invoiceNumber,
+            invoiceType: invoices.invoiceType,
+            status: invoices.status,
+            currency: invoices.currency,
+            totalCents: invoices.totalCents,
+            paidCents: invoices.paidCents,
+            balanceDueCents: invoices.balanceDueCents,
+            sequence: invoices.sequence,
+        },
+        seriesName: invoiceNumberSeries.externalConfigKey,
+    })
+        .from(invoices)
+        .leftJoin(invoiceNumberSeries, eq(invoices.seriesId, invoiceNumberSeries.id))
+        .where(and(inArray(invoices.invoiceType, ["invoice", "proforma"]), inArray(invoices.status, ["issued", "partially_paid", "paid", "overdue"])))
+        .orderBy(desc(invoices.createdAt))
+        .limit(options.limit ?? 500);
+    return rows
+        .filter((row) => !isPendingExternalAllocationPlaceholder(row.invoice.invoiceNumber))
+        .map((row) => ({
+        invoiceId: row.invoice.id,
+        invoiceNumber: row.invoice.invoiceNumber,
+        invoiceType: row.invoice.invoiceType,
+        documentType: row.invoice.invoiceType === "proforma" ? "proforma" : "invoice",
+        seriesName: row.seriesName,
+        sequence: row.invoice.sequence,
+        status: row.invoice.status,
+        currency: row.invoice.currency,
+        totalCents: row.invoice.totalCents,
+        paidCents: row.invoice.paidCents,
+        balanceDueCents: row.invoice.balanceDueCents,
+    }));
+}
+function resolveCandidateReferenceParts(candidate, fallbackCompanyVatCode) {
+    const metadata = candidate.metadata ?? null;
+    const parsed = parseInvoiceNumber(candidate.invoiceNumber);
+    const documentType = coerceCandidateDocumentType(candidate.documentType ?? candidate.invoiceType ?? metadataString(metadata, "documentType"));
+    const companyVatCode = candidate.companyVatCode ??
+        metadataString(metadata, "companyVatCode") ??
+        metadataString(metadata, "vatCode") ??
+        fallbackCompanyVatCode;
+    const seriesName = candidate.seriesName ??
+        candidate.series ??
+        metadataString(metadata, "seriesName") ??
+        metadataString(metadata, "series") ??
+        parsed?.seriesName;
+    const number = candidate.number ??
+        metadataString(metadata, "number") ??
+        numberFromInvoiceNumber(candidate.invoiceNumber, seriesName) ??
+        (candidate.sequence !== null && candidate.sequence !== undefined
+            ? String(candidate.sequence)
+            : null) ??
+        parsed?.number;
+    if (!documentType || !companyVatCode || !seriesName || !number)
+        return null;
+    return { companyVatCode, seriesName, number, documentType };
+}
+async function recordCandidateExternalRef(options, candidate, document, ref) {
+    if (options.recordCandidateExternalRef) {
+        const recorded = await options.recordCandidateExternalRef({ candidate, document, ref });
+        return recorded ?? ref;
+    }
+    if (!options.db)
+        return ref;
+    const row = await financeService.registerInvoiceExternalRef(options.db, candidate.invoiceId, {
+        provider: "smartbill",
+        externalId: document.number,
+        externalNumber: document.number,
+        status: ref.status,
+        syncedAt: new Date().toISOString(),
+        syncError: null,
+        metadata: coerceMetadata(ref.metadata),
+    });
+    return row ? toRegisteredWorkflowExternalRef(row, ref.invoice ?? null) : ref;
+}
+function toCandidateWorkflowExternalRef(candidate, document) {
+    return {
+        id: `candidate:${candidate.invoiceId}`,
+        invoiceId: candidate.invoiceId,
+        provider: "smartbill",
+        externalId: document?.number ?? candidate.number ?? null,
+        externalNumber: document?.number ?? candidate.number ?? null,
+        externalUrl: null,
+        status: "candidate",
+        syncError: null,
+        metadata: {
+            ...(candidate.metadata ?? {}),
+            source: "invoices",
+            invoiceNumber: candidate.invoiceNumber,
+            ...(document
+                ? {
+                    companyVatCode: document.companyVatCode,
+                    seriesName: document.seriesName,
+                    series: document.seriesName,
+                    number: document.number,
+                    documentType: document.documentType,
+                }
+                : {}),
+        },
+        invoice: candidateToWorkflowInvoice(candidate),
+    };
+}
+function toRegisteredWorkflowExternalRef(ref, invoice) {
+    if (!ref)
+        throw new Error("SmartBill candidate external ref registration returned no row");
+    return {
+        id: ref.id,
+        invoiceId: ref.invoiceId,
+        provider: ref.provider,
+        externalId: ref.externalId,
+        externalNumber: ref.externalNumber,
+        externalUrl: ref.externalUrl,
+        status: ref.status,
+        metadata: coerceMetadata(ref.metadata),
+        syncError: ref.syncError,
+        createdAt: ref.createdAt,
+        updatedAt: ref.updatedAt,
+        invoice,
+    };
+}
+function candidateToWorkflowInvoice(candidate) {
+    if (!candidate.status || !candidate.currency)
+        return null;
+    return {
+        id: candidate.invoiceId,
+        invoiceNumber: candidate.invoiceNumber,
+        invoiceType: candidate.invoiceType ?? candidate.documentType ?? "invoice",
+        status: candidate.status,
+        currency: candidate.currency,
+        totalCents: candidate.totalCents ?? 0,
+        paidCents: candidate.paidCents ?? 0,
+        balanceDueCents: candidate.balanceDueCents ?? 0,
+    };
+}
+function coerceCandidateDocumentType(value) {
+    return value === "invoice" || value === "proforma" ? value : null;
+}
+function metadataString(metadata, key) {
+    const value = metadata?.[key];
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function coerceMetadata(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function numberFromInvoiceNumber(invoiceNumber, seriesName) {
+    if (!seriesName || !invoiceNumber.startsWith(seriesName))
+        return null;
+    const number = invoiceNumber.slice(seriesName.length).replace(/^[\s._/-]+/, "");
+    return number.length > 0 ? number : null;
+}
+function parseInvoiceNumber(invoiceNumber) {
+    const match = /^(.+?)[\s._/-]+(.+)$/.exec(invoiceNumber);
+    if (!match?.[1] || !match[2])
+        return null;
+    return { seriesName: match[1], number: match[2] };
+}
+function isPendingExternalAllocationPlaceholder(invoiceNumber) {
+    return invoiceNumber.toUpperCase().startsWith("PENDING-");
+}

package/dist/workflow-remote-discovery.d.ts

@@ -0,0 +1,6 @@
+import { type SmartbillClientApi } from "./client.js";
+import type { SmartbillStatusResponse } from "./types.js";
+import type { SmartbillRemoteDocument, SmartbillRemoteDocumentStatus } from "./workflows.js";
+export declare function discoverRemoteDocuments(client: SmartbillClientApi, companyVatCode: string): Promise<SmartbillRemoteDocument[]>;
+export declare function paymentStatusToRemoteStatus(status: SmartbillStatusResponse): SmartbillRemoteDocumentStatus;
+//# sourceMappingURL=workflow-remote-discovery.d.ts.map

package/dist/workflow-remote-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-remote-discovery.d.ts","sourceRoot":"","sources":["../src/workflow-remote-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACxE,OAAO,KAAK,EAA2B,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAClF,OAAO,KAAK,EAEV,uBAAuB,EAEvB,6BAA6B,EAC9B,MAAM,gBAAgB,CAAA;AAEvB,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,kBAAkB,EAC1B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CA2BpC;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,uBAAuB,GAC9B,6BAA6B,CAS/B"}

package/dist/workflow-remote-discovery.js

@@ -0,0 +1,83 @@
+import { SmartbillApiError } from "./client.js";
+export async function discoverRemoteDocuments(client, companyVatCode) {
+    const response = await client.listSeries();
+    const documents = [];
+    for (const series of discoverableSeries(response)) {
+        for (let number = 1; number < series.nextNumber; number += 1) {
+            const document = {
+                companyVatCode,
+                seriesName: series.name,
+                number: String(number),
+                documentType: series.type === "f" ? "invoice" : "proforma",
+            };
+            try {
+                const remote = document.documentType === "invoice"
+                    ? await discoverInvoiceDocument(client, document)
+                    : await discoverProformaDocument(client, document);
+                documents.push(remote);
+            }
+            catch (error) {
+                if (isMissingRemoteDocumentError(error))
+                    continue;
+                throw error;
+            }
+        }
+    }
+    return documents;
+}
+export function paymentStatusToRemoteStatus(status) {
+    const providerStatus = `${status.message ?? ""} ${status.errorText ?? ""}`.toLowerCase();
+    if (providerStatus.includes("cancel"))
+        return "cancelled";
+    if (providerStatus.includes("reverse"))
+        return "reversed";
+    if (providerStatus.includes("void"))
+        return "voided";
+    if (providerStatus.includes("delete"))
+        return "deleted";
+    if (status.paid)
+        return "paid";
+    if ((status.paidAmount ?? 0) > 0)
+        return "partially_paid";
+    return "unpaid";
+}
+function discoverableSeries(response) {
+    return (response.list ?? []).filter((series) => typeof series.name === "string" &&
+        series.name.length > 0 &&
+        Number.isInteger(series.nextNumber) &&
+        series.nextNumber > 1 &&
+        (series.type === "f" || series.type === "p"));
+}
+async function discoverInvoiceDocument(client, document) {
+    const paymentStatus = await client.getPaymentStatus(document.companyVatCode, document.seriesName, document.number);
+    return {
+        ...document,
+        status: paymentStatusToRemoteStatus(paymentStatus),
+        metadata: { paymentStatus },
+        accessors: remoteDocumentAccessors(client, document),
+    };
+}
+async function discoverProformaDocument(client, document) {
+    const estimateInvoices = await client.listEstimateInvoices(document.companyVatCode, document.seriesName, document.number);
+    return {
+        ...document,
+        status: "present",
+        metadata: { estimateInvoices },
+        accessors: remoteDocumentAccessors(client, document),
+    };
+}
+function remoteDocumentAccessors(client, document) {
+    if (document.documentType === "proforma") {
+        return {
+            viewPdf: () => client.viewEstimatePdf(document.companyVatCode, document.seriesName, document.number),
+            listEstimateInvoices: () => client.listEstimateInvoices(document.companyVatCode, document.seriesName, document.number),
+        };
+    }
+    return {
+        viewPdf: () => client.viewInvoicePdf(document.companyVatCode, document.seriesName, document.number),
+        getPaymentStatus: () => client.getPaymentStatus(document.companyVatCode, document.seriesName, document.number),
+    };
+}
+function isMissingRemoteDocumentError(error) {
+    return error instanceof SmartbillApiError && error.status === 404;
+}

package/dist/workflows/refs.d.ts

@@ -0,0 +1,13 @@
+import type { PostgresJsDatabase } from "drizzle-orm/postgres-js";
+import { type SmartbillCandidateExternalRefRecorder, type SmartbillCandidateInvoice, type SmartbillWorkflowCandidateSource } from "../workflow-candidates.js";
+import type { SmartbillWorkflowExternalRef } from "./types.js";
+export declare function loadSmartbillWorkflowRefs(options: {
+    db?: PostgresJsDatabase;
+    limit?: number;
+    companyVatCode?: string;
+    source?: SmartbillWorkflowCandidateSource;
+    listExternalRefs?: () => Promise<SmartbillWorkflowExternalRef[]>;
+    listCandidateInvoices?: () => Promise<SmartbillCandidateInvoice[]>;
+    recordCandidateExternalRef?: SmartbillCandidateExternalRefRecorder;
+}): Promise<SmartbillWorkflowExternalRef[]>;
+//# sourceMappingURL=refs.d.ts.map

package/dist/workflows/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/workflows/refs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,OAAO,EAEL,KAAK,qCAAqC,EAC1C,KAAK,yBAAyB,EAC9B,KAAK,gCAAgC,EACtC,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,4BAA4B,EAA4B,MAAM,YAAY,CAAA;AAExF,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,EAAE,CAAC,EAAE,kBAAkB,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,gCAAgC,CAAA;IACzC,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAAA;IAChE,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAA;IAClE,0BAA0B,CAAC,EAAE,qCAAqC,CAAA;CACnE,2CAKA"}

package/dist/workflows/refs.js

@@ -0,0 +1,51 @@
+import { invoiceExternalRefs, invoices } from "@voyant-travel/finance";
+import { desc, eq } from "drizzle-orm";
+import { loadSmartbillCandidateRefs, } from "../workflow-candidates.js";
+export async function loadSmartbillWorkflowRefs(options) {
+    if (options.listCandidateInvoices || options.source === "invoices") {
+        return loadSmartbillCandidateRefs(options);
+    }
+    return loadSmartbillExternalRefs(options);
+}
+async function loadSmartbillExternalRefs(options) {
+    if (options.listExternalRefs)
+        return options.listExternalRefs();
+    if (!options.db)
+        throw new Error("SmartBill workflow requires db or listExternalRefs");
+    const rows = await options.db
+        .select({
+        ref: invoiceExternalRefs,
+        invoice: {
+            id: invoices.id,
+            invoiceNumber: invoices.invoiceNumber,
+            invoiceType: invoices.invoiceType,
+            status: invoices.status,
+            currency: invoices.currency,
+            totalCents: invoices.totalCents,
+            paidCents: invoices.paidCents,
+            balanceDueCents: invoices.balanceDueCents,
+        },
+    })
+        .from(invoiceExternalRefs)
+        .leftJoin(invoices, eq(invoiceExternalRefs.invoiceId, invoices.id))
+        .where(eq(invoiceExternalRefs.provider, "smartbill"))
+        .orderBy(desc(invoiceExternalRefs.createdAt))
+        .limit(options.limit ?? 500);
+    return rows.map((row) => toWorkflowExternalRef(row.ref, row.invoice));
+}
+function toWorkflowExternalRef(ref, invoice) {
+    return {
+        id: ref.id,
+        invoiceId: ref.invoiceId,
+        provider: ref.provider,
+        externalId: ref.externalId,
+        externalNumber: ref.externalNumber,
+        externalUrl: ref.externalUrl,
+        status: ref.status,
+        metadata: ref.metadata,
+        syncError: ref.syncError,
+        createdAt: ref.createdAt,
+        updatedAt: ref.updatedAt,
+        invoice,
+    };
+}

package/dist/workflows/spaced-client.d.ts

@@ -0,0 +1,5 @@
+import type { SmartbillClientApi } from "../client.js";
+import { SmartbillRateLimitCircuitOpenError, SmartbillRateLimitError } from "../client.js";
+export declare function createSpacedSmartbillClient(client: SmartbillClientApi, requestSpacingMs: number | undefined): SmartbillClientApi;
+export declare function isSmartbillRateLimitError(error: unknown): error is SmartbillRateLimitError | SmartbillRateLimitCircuitOpenError;
+//# sourceMappingURL=spaced-client.d.ts.map

package/dist/workflows/spaced-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaced-client.d.ts","sourceRoot":"","sources":["../../src/workflows/spaced-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACtD,OAAO,EAAE,kCAAkC,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAE1F,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,kBAAkB,EAC1B,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,kBAAkB,CAyDpB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,yEAIvD"}

package/dist/workflows/spaced-client.js

@@ -0,0 +1,44 @@
+import { SmartbillRateLimitCircuitOpenError, SmartbillRateLimitError } from "../client.js";
+export function createSpacedSmartbillClient(client, requestSpacingMs) {
+    const minIntervalMs = typeof requestSpacingMs === "number" && Number.isFinite(requestSpacingMs)
+        ? Math.max(0, requestSpacingMs)
+        : 0;
+    if (minIntervalMs === 0)
+        return client;
+    let lastRequestStartedAt = null;
+    let pendingRequest = Promise.resolve();
+    const spaceRequest = async (request) => {
+        const run = pendingRequest.then(async () => {
+            if (lastRequestStartedAt !== null) {
+                const elapsedMs = Date.now() - lastRequestStartedAt;
+                const delayMs = minIntervalMs - elapsedMs;
+                if (delayMs > 0) {
+                    await new Promise((resolve) => setTimeout(resolve, delayMs));
+                }
+            }
+            lastRequestStartedAt = Date.now();
+            return request();
+        });
+        pendingRequest = run.then(() => undefined, () => undefined);
+        return run;
+    };
+    return {
+        createInvoice: (body) => spaceRequest(() => client.createInvoice(body)),
+        createProforma: (body) => spaceRequest(() => client.createProforma(body)),
+        convertEstimateToInvoice: (companyVatCode, estimateSeriesName, estimateNumber, body) => spaceRequest(() => client.convertEstimateToInvoice(companyVatCode, estimateSeriesName, estimateNumber, body)),
+        cancelInvoice: (companyVatCode, seriesName, number) => spaceRequest(() => client.cancelInvoice(companyVatCode, seriesName, number)),
+        restoreInvoice: (companyVatCode, seriesName, number) => spaceRequest(() => client.restoreInvoice(companyVatCode, seriesName, number)),
+        deleteInvoice: (companyVatCode, seriesName, number) => spaceRequest(() => client.deleteInvoice(companyVatCode, seriesName, number)),
+        reverseInvoice: (companyVatCode, seriesName, number) => spaceRequest(() => client.reverseInvoice(companyVatCode, seriesName, number)),
+        viewInvoicePdf: (companyVatCode, seriesName, number) => spaceRequest(() => client.viewInvoicePdf(companyVatCode, seriesName, number)),
+        viewPdf: (companyVatCode, seriesName, number) => spaceRequest(() => client.viewPdf(companyVatCode, seriesName, number)),
+        viewEstimatePdf: (companyVatCode, seriesName, number) => spaceRequest(() => client.viewEstimatePdf(companyVatCode, seriesName, number)),
+        getPaymentStatus: (companyVatCode, seriesName, number) => spaceRequest(() => client.getPaymentStatus(companyVatCode, seriesName, number)),
+        listTaxes: () => spaceRequest(() => client.listTaxes()),
+        listSeries: () => spaceRequest(() => client.listSeries()),
+        listEstimateInvoices: (companyVatCode, seriesName, number) => spaceRequest(() => client.listEstimateInvoices(companyVatCode, seriesName, number)),
+    };
+}
+export function isSmartbillRateLimitError(error) {
+    return (error instanceof SmartbillRateLimitError || error instanceof SmartbillRateLimitCircuitOpenError);
+}