SquareFoodserviceAdapter maps Square Order-shaped objects to the LIP
foodservice model. Its version is pinned to Square Orders API 2026-08-19 and
the repository tests only public synthetic fixtures. This is not a claim of
Square certification or partnership.
It covers modifiers, discounts, taxes, tips, service charges, split tenders,
channel hints, voids, partial refunds, and deterministic idempotency keys.
Free-form line notes and Square customer identifiers are not copied into LIP.
A gross refund cannot prove the loyalty-eligible amount. Integrators must supply
resolveEligibleRefundAmount from item-level source facts; the adapter fails
closed on invalid values.
