@kevludwig/lexware-office 0.1.1 → 0.1.2

package/dist/contacts.d.ts

@@ -19,7 +19,13 @@ export interface Contact {
 export declare function getContact(client: LexwareClient, id: string, signal?: AbortSignal): Promise<Contact>;
 /** The contact with this customer number, or null. */
 export declare function findContactByNumber(client: LexwareClient, customerNumber: number, signal?: AbortSignal): Promise<Contact | null>;
-/** Contacts whose name matches — fuzzy, up to `size` (default 10). */
+/** Lexware searches names from three characters on; shorter ones it refuses with a 400. */
+export declare const MIN_NAME_SEARCH_LENGTH = 3;
+/**
+ * Contacts whose name matches — fuzzy, up to `size` (default 10). A name
+ * shorter than MIN_NAME_SEARCH_LENGTH finds nothing (no request): callers
+ * that must not mistake that for "no match" check the length themselves.
+ */
 export declare function findContactsByName(client: LexwareClient, name: string, options?: {
     customer?: boolean;
     vendor?: boolean;

package/dist/contacts.js

@@ -28,8 +28,16 @@ export async function findContactByNumber(client, customerNumber, signal) {
     const raw = page.content?.[0];
     return raw ? toContact(raw) : null;
 }
-/** Contacts whose name matches — fuzzy, up to `size` (default 10). */
+/** Lexware searches names from three characters on; shorter ones it refuses with a 400. */
+export const MIN_NAME_SEARCH_LENGTH = 3;
+/**
+ * Contacts whose name matches — fuzzy, up to `size` (default 10). A name
+ * shorter than MIN_NAME_SEARCH_LENGTH finds nothing (no request): callers
+ * that must not mistake that for "no match" check the length themselves.
+ */
 export async function findContactsByName(client, name, options = {}) {
+    if (name.trim().length < MIN_NAME_SEARCH_LENGTH)
+        return [];
     const page = await client.request(`/contacts${query({ name, customer: options.customer, vendor: options.vendor, size: options.size ?? 10 })}`, { signal: options.signal });
     return (page.content ?? []).map(toContact);
 }

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { DEFAULT_APP_URL, DEFAULT_BASE_URL, LexwareApiError, createLexwareClient, describeError, query, type FileUpload, type LexwareClient, type LexwareClientOptions, } from "./client.ts";
-export { contactEmail, createCustomer, findContactByNumber, findContactsByName, getContact, resolveContactByName, type Contact, type CreatedCustomer, type NewCustomer, } from "./contacts.ts";
+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, sendReminder, type ReminderTarget, type SendReminderOutcome, } from "./reminders.ts";

package/dist/index.js

@@ -1,5 +1,5 @@
 export { DEFAULT_APP_URL, DEFAULT_BASE_URL, LexwareApiError, createLexwareClient, describeError, query, } from "./client.js";
-export { contactEmail, createCustomer, findContactByNumber, findContactsByName, getContact, resolveContactByName, } from "./contacts.js";
+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, sendReminder, } from "./reminders.js";

package/package.json

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