@kevludwig/lexware-office 0.1.3 → 0.1.4

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { DEFAULT_APP_URL, DEFAULT_BASE_URL, LexwareApiError, createLexwareClient
 export { contactEmail, createCustomer, findContactByNumber, findContactsByName, MIN_NAME_SEARCH_LENGTH, getContact, resolveContactByName, type Contact, type CreatedCustomer, type NewCustomer, } from "./contacts.ts";
 export { addDays, berlinDay, daysSince } from "./dates.ts";
 export { downloadInvoicePdf, findOverdueInvoice, findOverdueInvoices, type OverdueInvoice, } from "./receivables.ts";
-export { DEFAULT_REMINDER_POLICY, daysPastReminderDue, earliestReminderDate, isDueImmediately, isOpenForReminder, reminderDueDate, reminderLedger, selectDueReminders, type DueReminder, type ReminderHold, type ReminderLedger, type ReminderPolicy, type ReminderRecord, type ReminderSelection, type ReminderStatus, mailContentSha256, sendReminder, type ReminderTarget, type SendReminderOutcome, } from "./reminders.ts";
+export { DEFAULT_REMINDER_POLICY, daysPastReminderDue, earliestReminderDate, isDueImmediately, isOpenForReminder, reminderDueDate, reminderLedger, selectDueReminders, type DueReminder, type ReminderHold, type ReminderLedger, type ReminderPolicy, type ReminderRecord, type ReminderSelection, type ReminderStatus, mailContentSha256, paymentReminderEffect, sendReminder, type PaymentReminderEffect, type ReminderTarget, type SendReminderOutcome, } from "./reminders.ts";
 export { MailNotSentError, defaultReminderMail, reminderSubject, type ReminderMail, type ReminderMailData, type ReminderSender, type RenderReminderMail, type SendReminderMail, } from "./reminder-mail.ts";
 export { keySegment, memoryStore, type JsonStore } from "./store.ts";
 export { DUPLICATE_TOTAL_TOLERANCE, ITEMS_TOTAL_TOLERANCE, netTotal, round2, taxFromGross, taxFromNet, type PricedLine, } from "./money.ts";

package/dist/index.js

@@ -2,7 +2,7 @@ export { DEFAULT_APP_URL, DEFAULT_BASE_URL, LexwareApiError, createLexwareClient
 export { contactEmail, createCustomer, findContactByNumber, findContactsByName, MIN_NAME_SEARCH_LENGTH, getContact, resolveContactByName, } from "./contacts.js";
 export { addDays, berlinDay, daysSince } from "./dates.js";
 export { downloadInvoicePdf, findOverdueInvoice, findOverdueInvoices, } from "./receivables.js";
-export { DEFAULT_REMINDER_POLICY, daysPastReminderDue, earliestReminderDate, isDueImmediately, isOpenForReminder, reminderDueDate, reminderLedger, selectDueReminders, mailContentSha256, sendReminder, } from "./reminders.js";
+export { DEFAULT_REMINDER_POLICY, daysPastReminderDue, earliestReminderDate, isDueImmediately, isOpenForReminder, reminderDueDate, reminderLedger, selectDueReminders, mailContentSha256, paymentReminderEffect, sendReminder, } from "./reminders.js";
 export { MailNotSentError, defaultReminderMail, reminderSubject, } from "./reminder-mail.js";
 export { keySegment, memoryStore } from "./store.js";
 export { DUPLICATE_TOTAL_TOLERANCE, ITEMS_TOTAL_TOLERANCE, netTotal, round2, taxFromGross, taxFromNet, } from "./money.js";

package/dist/reminders.d.ts

@@ -140,6 +140,34 @@ export type SendReminderOutcome = {
     sent: false;
     reason: "paid" | "taken";
 };
+/**
+ * What a sent payment reminder did, in a fixed shape an app's protocol keeps
+ * as it is. `amount` and `contentSha256` are null only when the effect is
+ * reconstructed after the fact and they are no longer known — never guessed.
+ */
+export interface PaymentReminderEffect {
+    kind: "payment_reminder";
+    to: string;
+    cc: string[];
+    test: boolean;
+    /** The invoice's voucher number. */
+    invoice: string;
+    invoiceId: string;
+    /** The open amount the mail stated. */
+    amount: number | null;
+    currency: string;
+    /** sha256 of the mail's content, see mailContentSha256. */
+    contentSha256: string | null;
+}
+/**
+ * The effect of a reminder sent to `target`. Pass the send's outcome; pass
+ * null to reconstruct it from the target alone, which leaves amount and hash
+ * unknown (null).
+ */
+export declare function paymentReminderEffect(target: ReminderTarget, sent: {
+    openAmount: number;
+    contentSha256: string;
+} | null): PaymentReminderEffect;
 /**
  * Sends one reminder, at most once per round: re-checks that the invoice is
  * still overdue, claims the round, renders and sends with the invoice PDF,

package/dist/reminders.js

@@ -122,6 +122,24 @@ export async function selectDueReminders(client, ledger, options = {}) {
         held: checked.flatMap(({ invoice, hold }) => (hold ? [{ invoice, hold }] : [])),
     };
 }
+/**
+ * The effect of a reminder sent to `target`. Pass the send's outcome; pass
+ * null to reconstruct it from the target alone, which leaves amount and hash
+ * unknown (null).
+ */
+export function paymentReminderEffect(target, sent) {
+    return {
+        kind: "payment_reminder",
+        to: target.to,
+        cc: [...(target.cc ?? [])],
+        test: target.test,
+        invoice: target.voucherNumber,
+        invoiceId: target.invoiceId,
+        amount: sent?.openAmount ?? null,
+        currency: target.currency,
+        contentSha256: sent?.contentSha256 ?? null,
+    };
+}
 /**
  * Sends one reminder, at most once per round: re-checks that the invoice is
  * still overdue, claims the round, renders and sends with the invoice PDF,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kevludwig/lexware-office",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Typed client and domain logic for the Lexware Office Public API: contacts, receivables, payment reminder rules.",
   "type": "module",
   "license": "MIT",