@teincfood/core 0.10.7 → 0.10.8

package/dist/printer/receipt.js

@@ -100,7 +100,11 @@ function nameBlockEscpos(name) {
     if (text.length <= 16)
         return [GS_SIZE_DOUBLE_W, text, LF, GS_SIZE_NORMAL];
     if (text.length <= 64) {
-        return [ESC_BOLD_ON, ...wrapText(text, 32).flatMap((l) => [escposText(l), LF]), ESC_BOLD_OFF];
+        return [
+            ESC_BOLD_ON,
+            ...wrapText(text, 32).flatMap((l) => [escposText(l), LF]),
+            ESC_BOLD_OFF,
+        ];
     }
     return wrapText(text, 32).flatMap((l) => [escposText(l), LF]);
 }
@@ -114,11 +118,16 @@ function nameSizeClass(name) {
 }
 function currencySymbol(currency) {
     switch (currency) {
-        case "GHS": return "₵";
-        case "USD": return "$";
-        case "EUR": return "€";
-        case "GBP": return "£";
-        default: return currency ? currency + " " : "";
+        case "GHS":
+            return "₵";
+        case "USD":
+            return "$";
+        case "EUR":
+            return "€";
+        case "GBP":
+            return "£";
+        default:
+            return currency ? currency + " " : "";
     }
 }
 function formatMoney(amountMinor, order) {
@@ -134,7 +143,20 @@ function formatDatetime(iso) {
         const d = new Date(iso);
         // Backend: Calendar.strftime(dt, "%d %b %Y %H:%M") e.g. "03 Sep 2026 14:05"
         const day = String(d.getDate()).padStart(2, "0");
-        const months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
+        const months = [
+            "Jan",
+            "Feb",
+            "Mar",
+            "Apr",
+            "May",
+            "Jun",
+            "Jul",
+            "Aug",
+            "Sep",
+            "Oct",
+            "Nov",
+            "Dec",
+        ];
         const mon = months[d.getMonth()];
         const year = d.getFullYear();
         const hh = String(d.getHours()).padStart(2, "0");
@@ -147,7 +169,8 @@ function formatDatetime(iso) {
 }
 export function calloutNumber(order) {
     // The backend assigns a real callout_number — always prefer it.
-    const direct = order.callout_number;
+    const direct = order
+        .callout_number;
     if (typeof direct === "number" && Number.isFinite(direct))
         return String(Math.abs(direct));
     const num = order.order_number || "";
@@ -211,7 +234,11 @@ function paymentLineText(order) {
 function escHtml(s) {
     if (!s)
         return "";
-    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
 }
 function businessAddress(business) {
     const b = business;
@@ -238,7 +265,9 @@ function businessLogoUrl(order) {
     const b = order.business;
     if (!b)
         return null;
-    return (b.logo_url ?? b.logoUrl ?? null);
+    return (b.logo_url ??
+        b.logoUrl ??
+        null);
 }
 /** Fetch remote URL (or tfimg://) and return data URI, or null on failure. Uses Web fetch; works for http(s) and for cached tfimg via Rust protocol. */
 async function fetchAsDataUri(url) {
@@ -291,7 +320,8 @@ function binaryFromBase64(b64) {
  * reference. Null when none — fully offline, no network.
  */
 export async function resolveLogoRaster(order) {
-    const direct = order.business?.logo_escpos;
+    const direct = order.business
+        ?.logo_escpos;
     if (typeof direct === "string" && direct.length > 0)
         return direct;
     try {
@@ -308,30 +338,50 @@ export async function resolveLogoRaster(order) {
     }
 }
 // ── ESC/POS ────────────────────────────────────────────────────────────
-function doubleLineEscpos() { return "═".repeat(LINE_WIDTH) + LF; }
-function singleLineEscpos() { return "─".repeat(LINE_WIDTH); }
+function doubleLineEscpos() {
+    return "═".repeat(LINE_WIDTH) + LF;
+}
+function singleLineEscpos() {
+    return "─".repeat(LINE_WIDTH);
+}
 function customerLineEscpos(order) {
     if (order.customer_name)
         return `Customer: ${order.customer_name}${LF}`;
     if (order.customer_phone)
         return `Phone: ${order.customer_phone}${LF}`;
-    if (order.user?.full_name)
+    // POS orders link the teller, not a customer account. Never print staff as
+    // the customer; non-POS orders may fall back to the ordering user.
+    if (!order.is_pos && order.user?.full_name)
         return `Customer: ${order.user.full_name}${LF}`;
     return null;
 }
-function orderTypeEscpos(order) { return orderTypeText(order); }
-function paymentLineEscpos(order) { return paymentLineText(order); }
+function tellerLineEscpos(order) {
+    const teller = order.teller?.full_name ?? (order.is_pos ? order.user?.full_name : null);
+    return order.is_pos && teller ? `Served by: ${teller}${LF}` : null;
+}
+function orderTypeEscpos(order) {
+    return orderTypeText(order);
+}
+function paymentLineEscpos(order) {
+    return paymentLineText(order);
+}
 export function generateEscpos(order, logoRasterB64) {
     const business = order.business;
     const items = order.items || [];
-    const taxLines = (order.order_tax_lines ?? order.tax_lines ?? []);
+    const taxLines = (order.order_tax_lines ??
+        order.tax_lines ??
+        []);
     const parts = [];
-    const push = (s) => { if (s != null)
-        parts.push(s); };
+    const push = (s) => {
+        if (s != null)
+            parts.push(s);
+    };
     // Sanitized text push: every human-readable segment goes through escposText
     // (control codes and barcode data use raw push).
-    const pushT = (s) => { if (s != null)
-        parts.push(escposText(s)); };
+    const pushT = (s) => {
+        if (s != null)
+            parts.push(escposText(s));
+    };
     // Header — implements docs/receipt-template.md §1
     // NOTE: no logo in ESC/POS text mode — a logo URL cannot be rendered without
     // a raster pipeline (GS v 0). HTML receipts embed the logo instead.
@@ -340,7 +390,9 @@ export function generateEscpos(order, logoRasterB64) {
         try {
             push(binaryFromBase64(logoRasterB64));
         }
-        catch { /* logo is decorative — never fail the receipt */ }
+        catch {
+            /* logo is decorative — never fail the receipt */
+        }
     }
     push(ESC_ALIGN_CENTER);
     for (const part of nameBlockEscpos(business?.name || "Teinc Food"))
@@ -369,6 +421,9 @@ export function generateEscpos(order, logoRasterB64) {
     const custLine = customerLineEscpos(order);
     if (custLine)
         pushT(custLine);
+    const tellerLine = tellerLineEscpos(order);
+    if (tellerLine)
+        pushT(tellerLine);
     push(LF);
     // Barcode — CODE128 GS k 73, sized down (default height is huge).
     push(ESC_ALIGN_CENTER);
@@ -417,7 +472,9 @@ export function generateEscpos(order, logoRasterB64) {
         pushT(`${padR("Delivery Fee:", 20)} ${padL(escposText(formatMoney(order.delivery_fee_minor, order)), 11)}${LF}`);
     }
     for (const tax of taxLines) {
-        const rateStr = tax.rate_basis_points ? `(${Math.floor(tax.rate_basis_points / 100)}%)` : "";
+        const rateStr = tax.rate_basis_points
+            ? `(${Math.floor(tax.rate_basis_points / 100)}%)`
+            : "";
         const label = `${tax.name || ""} ${rateStr}`.trim().slice(0, 19);
         pushT(`${padR(label, 20)} ${padL(escposText(formatMoney(tax.tax_amount_minor, order)), 11)}${LF}`);
     }
@@ -499,15 +556,20 @@ export async function generateHtmlAsync(order, opts) {
 export function generateHtml(order, logoDataUri) {
     const business = order.business;
     const items = order.items || [];
-    const taxLines = ((order.order_tax_lines) ?? order.tax_lines ?? []);
+    const taxLines = (order.order_tax_lines ??
+        order.tax_lines ??
+        []);
     const callout = calloutNumber(order);
-    const logoSrc = logoDataUri || business?.logo_url || "";
+    const logoSrc = logoDataUri ||
+        business?.logo_url ||
+        "";
     const hasLogo = !!logoSrc;
     const businessName = escHtml(business?.name || "Teinc Food");
     const company = getCompanyInfo();
     const addr = businessAddress(business);
     const bPhone = business?.phone;
-    const itemRows = items.map((item) => {
+    const itemRows = items
+        .map((item) => {
         const qty = item.quantity || 1;
         // unit_price is already minor? backend format_money expects minor
         const price = formatMoney((item.unit_price ?? 0) * qty, order);
@@ -517,17 +579,24 @@ export function generateHtml(order, logoDataUri) {
             ? `<tr class="variant-row"><td class="item-name" colspan="2">Size: ${escHtml(vName)}</td><td class="item-price"></td></tr>`
             : "";
         const addons = item.order_item_addons ?? item.addons ?? [];
-        const addonRows = addons.map((addon) => {
+        const addonRows = addons
+            .map((addon) => {
             const aName = escHtml(addonName(addon));
             const aPriceMinor = addon.price_minor ?? addon.price ?? 0;
             return `<tr class="addon-row"><td class="item-name">+ ${aName}</td><td class="item-qty"></td><td class="addon-price">${formatMoney(aPriceMinor, order)}</td></tr>`;
-        }).join("\n");
+        })
+            .join("\n");
         return [main, variantRow, addonRows].filter(Boolean).join("\n");
-    }).join("\n");
-    const taxRowsHtml = taxLines.map((tax) => {
-        const rateStr = tax.rate_basis_points ? `(${Math.floor(tax.rate_basis_points / 100)}%)` : "";
+    })
+        .join("\n");
+    const taxRowsHtml = taxLines
+        .map((tax) => {
+        const rateStr = tax.rate_basis_points
+            ? `(${Math.floor(tax.rate_basis_points / 100)}%)`
+            : "";
         return `<tr><td class="label">${escHtml(tax.name || "")} ${escHtml(rateStr)}</td><td class="amount">${formatMoney(tax.tax_amount_minor, order)}</td></tr>`;
-    }).join("\n");
+    })
+        .join("\n");
     // Exact style from receipt.ex to_html/2
     return `<!DOCTYPE html>
 <html>
@@ -572,7 +641,14 @@ export function generateHtml(order, logoDataUri) {
   <strong>Order:</strong> ${escHtml(order.order_number)}<br>
   <strong>Date:</strong> ${escHtml(formatDatetime(order.inserted_at))}<br>
   <strong>Type:</strong> ${escHtml(orderTypeText(order))}<br>
-  ${order.customer_name ? `<strong>Customer:</strong> ${escHtml(order.customer_name)}<br>` : order.user?.full_name ? `<strong>Customer:</strong> ${escHtml(order.user.full_name)}<br>` : ""}
+  ${order.customer_name
+        ? `<strong>Customer:</strong> ${escHtml(order.customer_name)}<br>`
+        : !order.is_pos && order.user?.full_name
+            ? `<strong>Customer:</strong> ${escHtml(order.user.full_name)}<br>`
+            : ""}
+  ${order.is_pos && (order.teller?.full_name || order.user?.full_name)
+        ? `<strong>Served by:</strong> ${escHtml(order.teller?.full_name || order.user.full_name)}<br>`
+        : ""}
 </div>
 <div class="callout">
   <div class="number">${escHtml(callout)}</div>

package/dist/types/api/seller.api.d.ts

@@ -1,4 +1,4 @@
-import type { PaginatedResponse } from './pagination';
+import type { PaginatedResponse } from "./pagination";
 export interface OrderUser {
     id: string;
     full_name: string;
@@ -6,6 +6,19 @@ export interface OrderUser {
     phone: string;
     avatar_url: string | null;
 }
+/** Explicit customer identity. POS customers are typed names only, not users. */
+export interface OrderCustomer {
+    user_id: string | null;
+    name: string | null;
+    phone: string | null;
+    avatar_url: string | null;
+}
+/** Business member who rang up a POS order. Distinct from the customer. */
+export interface OrderTeller {
+    id: string;
+    full_name: string;
+    email?: string | null;
+}
 export interface OrderPayment {
     is_paid: boolean;
     reference: string | null;
@@ -123,6 +136,9 @@ export interface SellerOrder {
     delivery_lat: number | null;
     delivery_lng: number | null;
     user: OrderUser | null;
+    /** Explicit customer vs staff split; older payloads may omit this. */
+    customer?: OrderCustomer | null;
+    teller?: OrderTeller | null;
     items: OrderItem[];
     inserted_at: string;
     updated_at?: string;

package/dist/utils/customer-display.d.ts

@@ -16,6 +16,14 @@ type OrderLike = Pick<SellerOrder, "customer_name"> & {
         avatar_url?: string;
         phone?: string;
     } | null;
+    customer?: {
+        name?: string | null;
+        phone?: string | null;
+        avatar_url?: string | null;
+    } | null;
+    teller?: {
+        full_name?: string | null;
+    } | null;
     customer_phone?: string | null;
     is_pos?: boolean;
 };

package/dist/utils/customer-display.js

@@ -11,30 +11,39 @@
  */
 export function getCustomerDisplay(order) {
     if (order.is_pos) {
-        const walkName = order.customer_name?.trim() ? order.customer_name.trim() : "Walk-in";
+        const typedName = order.customer?.name?.trim() || order.customer_name?.trim();
         return {
-            name: walkName,
+            name: typedName || "Walk-in",
             avatarUrl: null,
-            phone: order.customer_phone ?? null,
+            phone: order.customer?.phone ?? order.customer_phone ?? null,
             isWalkIn: true,
-            tellerName: order.user?.full_name?.trim() ?? null,
+            tellerName: order.teller?.full_name?.trim() ??
+                order.user?.full_name?.trim() ??
+                null,
         };
     }
-    const rawName = order.customer_name?.trim()
-        ? order.customer_name.trim()
-        : order.user?.full_name?.trim() ?? "";
+    const rawName = order.customer?.name?.trim() ||
+        order.customer_name?.trim() ||
+        order.user?.full_name?.trim() ||
+        "";
     if (rawName) {
         return {
             name: rawName,
-            avatarUrl: order.user?.avatar_url ?? null,
-            phone: order.customer_phone ?? order.user?.phone ?? null,
+            avatarUrl: order.customer?.avatar_url ?? order.user?.avatar_url ?? null,
+            phone: order.customer?.phone ??
+                order.customer_phone ??
+                order.user?.phone ??
+                null,
             isWalkIn: false,
         };
     }
     return {
         name: "Customer",
-        avatarUrl: order.user?.avatar_url ?? null,
-        phone: order.customer_phone ?? order.user?.phone ?? null,
+        avatarUrl: order.customer?.avatar_url ?? order.user?.avatar_url ?? null,
+        phone: order.customer?.phone ??
+            order.customer_phone ??
+            order.user?.phone ??
+            null,
         isWalkIn: false,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teincfood/core",
-  "version": "0.10.7",
+  "version": "0.10.8",
   "description": "TeincFood shared offline-first core — types, sync engine, local DB, reference data, and repositories for mobile + desktop",
   "type": "module",
   "main": "dist/index.js",