@teincfood/core 0.10.7 → 0.10.9

package/dist/adapters/pending-orders.d.ts

@@ -14,6 +14,13 @@ export declare const usePendingOrdersStore: {
         hydrated: boolean;
         orders: SellerOrder[];
         addOrder: (order: SellerOrder) => void;
+        /**
+         * Replace an existing pending order in place. Used for queued
+         * transitions/payments so the optimistic overlay reflects the new state
+         * immediately. Unknown orders are ignored (a transition must never
+         * resurrect an order that was already reconciled).
+         */
+        updateOrder: (order: SellerOrder) => void;
         removeByOrderNumber: (orderNumber: string) => void;
         removeByOrderId: (orderId: string) => void;
         setHydrated: (v: boolean) => void;

package/dist/adapters/pending-orders.js

@@ -30,6 +30,25 @@ export const usePendingOrdersStore = {
                 notify();
             }
         },
+        /**
+         * Replace an existing pending order in place. Used for queued
+         * transitions/payments so the optimistic overlay reflects the new state
+         * immediately. Unknown orders are ignored (a transition must never
+         * resurrect an order that was already reconciled).
+         */
+        updateOrder: (order) => {
+            const index = orders.findIndex((o) => o.id === order.id || o.order_number === order.order_number);
+            if (index === -1)
+                return;
+            const current = orders[index];
+            if (current.status === order.status &&
+                current.is_paid === order.is_paid &&
+                current.paid_at === order.paid_at) {
+                return;
+            }
+            orders = orders.map((o, i) => (i === index ? order : o));
+            notify();
+        },
         removeByOrderNumber: (orderNumber) => {
             const next = orders.filter((o) => o.order_number !== orderNumber);
             if (next.length !== orders.length) {

package/dist/db/operations.d.ts

@@ -112,6 +112,15 @@ export declare function upsertServerOrder(db: SQLiteDatabase, order: import("../
     preserveStatus?: boolean;
     preservePayment?: boolean;
 }): Promise<void>;
+/**
+ * Recent orders plus their local HLC, for LAN catch-up.
+ *
+ * The HLC must travel with the row: `insertOrder` is HLC-guarded, so a peer
+ * replaying an older snapshot can never overwrite a newer local status.
+ */
+export declare function listOrdersWithHlc(db: SQLiteDatabase, businessId: string, limit?: number): Promise<Array<import("../types/api/seller.api").SellerOrder & {
+    hlc?: string;
+}>>;
 export declare function listOrders(db: SQLiteDatabase, businessId: string, filters?: {
     status?: string;
     q?: string;

package/dist/db/operations.js

@@ -376,6 +376,19 @@ export async function upsertServerOrder(db, order, opts = {}) {
      ON CONFLICT(id) DO UPDATE SET business_id=excluded.business_id, order_number=excluded.order_number, callout_number=excluded.callout_number, status=excluded.status, order_type=excluded.order_type, is_pos=excluded.is_pos, items=excluded.items, subtotal_minor=excluded.subtotal_minor, total_minor=excluded.total_minor, tax_minor=excluded.tax_minor, tax_lines=excluded.tax_lines, payment=excluded.payment, paid_at=COALESCE(excluded.paid_at, orders.paid_at), customer_name=excluded.customer_name, customer_phone=excluded.customer_phone, pos_payment_method=excluded.pos_payment_method, delivery_id=excluded.delivery_id, business=excluded.business, user=excluded.user, updated_at=excluded.updated_at, hlc=excluded.hlc, sync_failed_at=NULL, sync_error=NULL;`, order.id, order.business_id, order.order_number, order.callout_number, status, order.order_type, order.is_pos ? 1 : 0, JSON.stringify(order.items ?? []), order.subtotal_minor ?? 0, order.total_minor ?? 0, order.tax_minor ?? 0, JSON.stringify(order.tax_lines ?? []), JSON.stringify(payment), paidAt, order.customer_name, order.customer_phone, order.pos_payment_method, order.delivery_id, order.business ? JSON.stringify(order.business) : null, order.user ? JSON.stringify(order.user) : null, order.inserted_at, updatedAt, hlc);
     notifyDbChange(order.business_id, "orders");
 }
+/**
+ * Recent orders plus their local HLC, for LAN catch-up.
+ *
+ * The HLC must travel with the row: `insertOrder` is HLC-guarded, so a peer
+ * replaying an older snapshot can never overwrite a newer local status.
+ */
+export async function listOrdersWithHlc(db, businessId, limit = 200) {
+    const rows = await db.getAllAsync(`SELECT * FROM orders WHERE business_id = ? AND deleted_at IS NULL ORDER BY inserted_at DESC LIMIT ?;`, businessId, limit);
+    return rows.map((row) => ({
+        ...orderRowToSellerOrder(row),
+        hlc: row.hlc ?? row.updated_at ?? row.inserted_at,
+    }));
+}
 export async function listOrders(db, businessId, filters, page = 1, pageSize = 20) {
     const where = ["business_id = ?"];
     const args = [businessId];

package/dist/hooks/orders.hooks.d.ts

@@ -22,7 +22,7 @@ export interface SellerOrderFilters {
     date_to?: string;
 }
 export declare function useSellerOrdersQuery(enabled?: boolean, filters?: SellerOrderFilters): import("@tanstack/react-query").UseInfiniteQueryResult<SellerOrder[], Error>;
-export declare function useSellerOrderQuery(orderId: string, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<{
+export declare function useSellerOrderQuery(orderId: string, enabled?: boolean, placeholder?: SellerOrder | null): import("@tanstack/react-query").UseQueryResult<{
     data: SellerOrder;
 }, Error>;
 export declare function useCreatePOSOrderMutation(): import("@tanstack/react-query").UseMutationResult<SellerOrder, Error, POSOrderCreateRequest, unknown>;

package/dist/hooks/orders.hooks.js

@@ -81,7 +81,7 @@ export function useSellerOrdersQuery(enabled = true, filters) {
         select: (data) => data.pages.flatMap((p) => p.data),
     });
 }
-export function useSellerOrderQuery(orderId, enabled = true) {
+export function useSellerOrderQuery(orderId, enabled = true, placeholder) {
     const bid = useBusinessId();
     return useQuery({
         queryKey: SELLER_KEYS.order(orderId, bid),
@@ -94,6 +94,12 @@ export function useSellerOrderQuery(orderId, enabled = true) {
             return { data: order };
         },
         enabled: enabled && !!orderId && !!bid,
+        // The order list already has the full row. Seed the dialog with it so
+        // opening details is instant; the DB read still runs and replaces it.
+        placeholderData: placeholder ? { data: placeholder } : undefined,
+        // Local SQLite reads cannot recover from a transient network error; a
+        // missing row should surface immediately instead of retrying for seconds.
+        retry: false,
         staleTime: 5 * 1000,
     });
 }

package/dist/local-node/service.d.ts

@@ -24,6 +24,18 @@ declare class LocalNodeServiceCore {
     init(deps: LocalNodeDeps): void;
     private requestReferenceFromPeers;
     private requestAssetFromPeers;
+    /**
+     * Catch a newly connected peer up on orders created while the mesh was not
+     * connected (e.g. a sale rung up before Local Node was enabled).
+     *
+     * Live order events only cover changes that happen *after* the socket is
+     * up. Without this handshake a pre-existing offline sale stayed invisible
+     * on the other terminal forever. Both sides call this on connect; the
+     * cooldown dedupes the inbound/outbound callbacks for the same peer.
+     */
+    private orderCatchupAt;
+    private static readonly ORDER_CATCHUP_COOLDOWN_MS;
+    private publishOrderCatchup;
     private getDeps;
     private getDeviceId;
     private runLifecycle;

package/dist/local-node/service.js

@@ -12,7 +12,9 @@ import { REFERENCE_CHANGED_EVENT_TYPE } from "../reference/events";
 import { applyReferenceChangeEvent } from "../reference/events";
 import { referenceSyncService } from "../reference/service";
 import { openSyncDatabase } from "../db/connection";
-import { insertOrder } from "../db/operations";
+import { insertOrder, listOrdersWithHlc } from "../db/operations";
+import { getPendingOrdersSnapshot } from "../adapters/pending-orders";
+import { generateEventId } from "../utils/uuid";
 import { createLocalOrder, transitionLocalOrder } from "../domain/orders/service";
 import { getConnectivityState } from "../adapters/connectivity";
 import { deriveLanSecret as deriveSecretCore } from "./security";
@@ -46,6 +48,16 @@ class LocalNodeServiceCore {
         this.published = false;
         /** Whether discovery scanning was successfully started. */
         this.discovering = false;
+        /**
+         * Catch a newly connected peer up on orders created while the mesh was not
+         * connected (e.g. a sale rung up before Local Node was enabled).
+         *
+         * Live order events only cover changes that happen *after* the socket is
+         * up. Without this handshake a pre-existing offline sale stayed invisible
+         * on the other terminal forever. Both sides call this on connect; the
+         * cooldown dedupes the inbound/outbound callbacks for the same peer.
+         */
+        this.orderCatchupAt = new Map();
         this.storeUnsub = null;
         this.dialInFlight = new Set();
         this.dialTimers = new Map();
@@ -89,6 +101,63 @@ class LocalNodeServiceCore {
         }
         return null;
     }
+    async publishOrderCatchup(peerDeviceId) {
+        if (!this.businessId)
+            return;
+        const now = Date.now();
+        const last = this.orderCatchupAt.get(peerDeviceId) ?? 0;
+        if (now - last < LocalNodeServiceCore.ORDER_CATCHUP_COOLDOWN_MS)
+            return;
+        this.orderCatchupAt.set(peerDeviceId, now);
+        try {
+            const db = await openSyncDatabase();
+            const rows = await listOrdersWithHlc(db, this.businessId, 200);
+            const byId = new Map();
+            for (const order of rows)
+                byId.set(order.id, order);
+            // Queued offline creations have no `orders` row yet; they live in the
+            // pending overlay. Include them so a pre-linkup sale is shared too.
+            for (const order of getPendingOrdersSnapshot().orders) {
+                if (order.business_id === this.businessId)
+                    byId.set(order.id, order);
+            }
+            const peer = this.peers.get(peerDeviceId);
+            const canTarget = !!peer?.isConnected() && typeof peer.publishEvent === "function";
+            for (const order of byId.values()) {
+                if (!order?.id || !order.order_number)
+                    continue;
+                const event = {
+                    event_id: generateEventId(),
+                    event_type: "order:sync",
+                    event_version: "1",
+                    entity_id: order.id,
+                    user_id: "",
+                    device_id: this.cachedDeviceId ?? "",
+                    payload: order,
+                    timestamp: order.updated_at ?? order.inserted_at ?? new Date().toISOString(),
+                };
+                if (canTarget) {
+                    await peer.publishEvent(event);
+                }
+                else {
+                    this.server?.broadcast(event);
+                }
+            }
+            syncLogger.info("LocalNodeService", "Order catch-up published", {
+                peer: peerDeviceId,
+                orders: byId.size,
+                targeted: canTarget,
+            });
+        }
+        catch (error) {
+            syncLogger.warn("LocalNodeService", "Order catch-up failed", {
+                peer: peerDeviceId,
+                error: String(error),
+            });
+            // Allow a later reconnect to retry after a transient DB/socket failure.
+            this.orderCatchupAt.delete(peerDeviceId);
+        }
+    }
     getDeps() {
         if (!this.deps)
             throw new Error("LocalNodeService not initialised: call initLocalNodeService(deps) first");
@@ -200,6 +269,7 @@ class LocalNodeServiceCore {
             catch { }
         this.peers.clear();
         this.peerInfos.clear();
+        this.orderCatchupAt.clear();
         if (this.server) {
             await withTimeout(this.server.stop(), LIFECYCLE_TIMEOUT_MS).catch((e) => syncLogger.warn("LocalNodeService", "Server stop timed out", { error: String(e) }));
             this.server = null;
@@ -359,6 +429,9 @@ class LocalNodeServiceCore {
             onClientConnected: (info) => {
                 localNodeStore.getState().addConnectedClient({ deviceId: info.deviceId, deviceName: info.deviceName, host: info.host, connectedAt: new Date().toISOString() });
                 syncLogger.info("LocalNodeService", "Client connected", { deviceId: info.deviceId, connected_clients: localNodeStore.getState().connectedClients.length });
+                // Inbound connect: push this node's pre-existing orders to the new
+                // peer (covers mDNS asymmetry where only one side dials).
+                void this.publishOrderCatchup(info.deviceId);
             },
             onClientDisconnected: (deviceId) => {
                 localNodeStore.getState().removeConnectedClient(deviceId);
@@ -602,6 +675,8 @@ class LocalNodeServiceCore {
                 syncLogger.info("LocalNodeService", "Connected to peer", { deviceId: node.deviceId });
                 this.peerInfos.set(node.deviceId, { deviceId: node.deviceId, host: node.host, port: node.port });
                 localNodeStore.getState().addConnectedClient({ deviceId: node.deviceId, deviceName: node.deviceName, host: node.host, connectedAt: new Date().toISOString() });
+                // Outbound connect: push orders created before this socket existed.
+                void this.publishOrderCatchup(node.deviceId);
                 // A terminal may have missed `reference_data.changed` while it was
                 // disconnected. Compare versions with the peer on reconnect so menu,
                 // members, hours and tax changes converge even on a dark LAN.
@@ -817,6 +892,7 @@ class LocalNodeServiceCore {
     }
     getState() { return { isLocalNode: this.isLocalNode(), isConnectedToNode: this.isConnectedToNode(), electedNode: this.getElectedNode(), client: this.getClient() }; }
 }
+LocalNodeServiceCore.ORDER_CATCHUP_COOLDOWN_MS = 10000;
 LocalNodeServiceCore.MISMATCH_BACKOFF_MS = 60000;
 export const localNodeService = new LocalNodeServiceCore();
 export function initLocalNodeService(deps) { localNodeService.init(deps); return localNodeService; }

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/sync/command-queue.service.js

@@ -18,6 +18,7 @@ import { assertBusinessOpenForCreate } from "../utils/business-hours";
 import { extractApiErrorCode } from "../utils/error";
 import { generateEventId } from "../utils/uuid";
 import { buildItemSnapshots, snapshotsToOrderLines } from "../domain/orders/snapshots";
+import { DEFAULT_ORDER_FLOW_MODE, getBusinessOrderFlowMode, initialPosOrderStatus, } from "../domain/orders/order-flow";
 import { generateLocalCalloutNumber, generateOrderNumberForBusiness, generateOrderNumber, } from "./order-number";
 import { getConnectivityState, subscribeConnectivity } from "../adapters/connectivity";
 import { canBusinessSync } from "./sync-guard";
@@ -53,7 +54,7 @@ const PAYMENT_QUEUED_PAYLOAD = {
 export function getQueuedStatus(commandType) {
     return QUEUED_STATUS_BY_COMMAND[commandType] ?? null;
 }
-function buildOptimisticEvent(command) {
+function buildOptimisticEvent(command, flowMode = DEFAULT_ORDER_FLOW_MODE) {
     const payload = command.payload;
     if (command.command_type === "order:create") {
         return {
@@ -63,7 +64,7 @@ function buildOptimisticEvent(command) {
             entity_id: command.entity_id ?? command.command_id,
             user_id: command.user_id,
             device_id: command.device_id,
-            payload: buildOptimisticOrder(command, payload),
+            payload: buildOptimisticOrder(command, payload, flowMode),
             timestamp: new Date().toISOString(),
         };
     }
@@ -77,6 +78,7 @@ function buildOptimisticEvent(command) {
             device_id: command.device_id,
             payload: {
                 ...payload,
+                business_id: command.business_id,
                 command_id: command.command_id,
                 is_paid: true,
                 paid_at: new Date().toISOString(),
@@ -95,6 +97,9 @@ function buildOptimisticEvent(command) {
         device_id: command.device_id,
         payload: {
             ...payload,
+            // Required by the offline read-model patch so queued transitions update
+            // the canonical orders table (not just seller_orders snapshots).
+            business_id: command.business_id,
             command_id: command.command_id,
             status: "pending",
             // Used by offline read-model patching so the list reflects the queued transition.
@@ -106,7 +111,7 @@ function buildOptimisticEvent(command) {
         timestamp: new Date().toISOString(),
     };
 }
-function buildOptimisticOrder(command, payload) {
+function buildOptimisticOrder(command, payload, flowMode) {
     const snapshots = buildItemSnapshots((payload.item_snapshots ?? payload.items ?? []));
     const totalMinor = payload.total_minor ?? 0;
     const subtotalMinor = payload.subtotal_minor ?? totalMinor;
@@ -114,6 +119,8 @@ function buildOptimisticOrder(command, payload) {
     const taxLines = payload.tax_lines ?? [];
     const currencyCode = payload.currency_code ?? "GHS";
     const now = new Date().toISOString();
+    const method = payload.pos_payment_method ?? "cash";
+    const isCash = method === "cash";
     const orderNumber = payload.order_number ?? generateOrderNumberForBusiness(command.business_id);
     return {
         id: command.entity_id ?? command.command_id,
@@ -123,20 +130,23 @@ function buildOptimisticOrder(command, payload) {
         is_pos: true,
         customer_name: payload.customer_name ?? null,
         customer_phone: payload.customer_phone ?? null,
-        pos_payment_method: payload.pos_payment_method ?? "cash",
-        paid_at: null,
-        status: "accepted",
+        pos_payment_method: method,
+        paid_at: isCash ? now : null,
+        // Must match createLocalOrder: direct-flow cash sales are born delivered,
+        // even when the command is parked in the offline outbox. Hardcoding
+        // "accepted" made a completed sale show up on the preparing board.
+        status: initialPosOrderStatus(method, flowMode),
         delivery_id: null,
         delivery_status: null,
-        is_paid: payload.pos_payment_method === "cash",
+        is_paid: isCash,
         payment: {
-            is_paid: payload.pos_payment_method === "cash",
+            is_paid: isCash,
             reference: null,
             amount_minor: totalMinor,
             currency: currencyCode,
-            paid_at: payload.pos_payment_method === "cash" ? now : null,
+            paid_at: isCash ? now : null,
         },
-        payment_mode: "pos_cash",
+        payment_mode: isCash ? "pos_cash" : "prepaid",
         total_minor: totalMinor,
         subtotal_minor: subtotalMinor,
         delivery_fee_minor: payload.delivery_fee_minor ?? 0,
@@ -268,7 +278,13 @@ class CommandQueueService {
             order_number: preparedCommand.payload.order_number ?? null,
             outbox_size: pending.length,
         });
-        const event = buildOptimisticEvent(preparedCommand);
+        // Direct-flow cash sales are complete on creation. The optimistic order
+        // must use the same cached business setting as createLocalOrder, otherwise
+        // an offline direct sale appears as "accepted" and offers kitchen steps.
+        const flowMode = preparedCommand.command_type === "order:create"
+            ? await getBusinessOrderFlowMode(preparedCommand.business_id)
+            : DEFAULT_ORDER_FLOW_MODE;
+        const event = buildOptimisticEvent(preparedCommand, flowMode);
         syncLogger.info("CommandQueueService", "Optimistic event built", {
             event_type: event.event_type,
             entity_id: event.entity_id,

package/dist/sync/pending-orders.service.js

@@ -220,7 +220,7 @@ function patchPendingStatus(event) {
         if (!target)
             return;
         const patched = { ...target, status: toStatus };
-        store.addOrder(patched);
+        store.updateOrder(patched);
     }
     catch { }
 }
@@ -244,7 +244,7 @@ function patchPendingPaid(event) {
             paid_at: paidAt,
             payment: { ...t.payment, is_paid: true, paid_at: paidAt },
         };
-        store.addOrder(patched);
+        store.updateOrder(patched);
     }
     catch { }
 }
@@ -277,7 +277,7 @@ export async function applyPendingOrderEvent(event, origin = "local") {
                     const store = usePendingOrdersStore.getState();
                     const target = store.orders.find((o) => o.id === orderId || o.order_number === orderId);
                     if (target)
-                        store.addOrder({ ...target, status: toStatus });
+                        store.updateOrder({ ...target, status: toStatus });
                 }
             }
             catch { }

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.9",
   "description": "TeincFood shared offline-first core — types, sync engine, local DB, reference data, and repositories for mobile + desktop",
   "type": "module",
   "main": "dist/index.js",