@teincfood/core 0.9.3 → 0.9.5

package/dist/printer/receipt.d.ts

@@ -7,6 +7,7 @@
  * Keep this file in sync with backend when template changes.
  */
 import type { SellerOrder } from "../types/api/seller.api";
+export declare function escposText(s: string | null | undefined): string;
 export declare function calloutNumber(order: SellerOrder): string;
 export declare function generateEscpos(order: SellerOrder): string;
 export declare function generateHtmlAsync(order: SellerOrder, opts?: {

package/dist/printer/receipt.js

@@ -18,9 +18,43 @@ const ESC_BOLD_OFF = "\x1B\x45\x00";
 const GS_SIZE_NORMAL = "\x1D\x21\x00";
 const GS_SIZE_DOUBLE_W = "\x1D\x21\x11";
 const GS_SIZE_DOUBLE_WH = "\x1D\x21\x33";
+const GS_BAR_HEIGHT = "\x1D\x68\x3C";
+const GS_BAR_WIDTH = "\x1D\x77\x02";
 const LF = "\x0A";
 const ESC_FEED_3 = "\x1B\x64\x03";
 const GS_CUT_FULL = "\x1D\x56\x00";
+/**
+ * Thermal printers speak bytes, not Unicode. Control sequences are pushed
+ * raw, but every human-readable text segment must pass through here first:
+ * known symbols map to ASCII, anything else non-ASCII becomes "?".
+ * Without this, ₵/═/─/accents print as gibberish (UTF-8 bytes read as CP437).
+ */
+const ESCPOS_REPLACEMENTS = [
+    [/[₵]/g, "GHc"],
+    [/[€]/g, "EUR"],
+    [/[£]/g, "GBP"],
+    [/[—–]/g, "-"],
+    [/[•·]/g, "*"],
+    [/[═╬]/g, "="],
+    [/[─│]/g, "-"],
+    [/[“”]/g, '"'],
+    [/[‘’`]/g, "'"],
+    [/[…]/g, "..."],
+    [/[×]/g, "x"],
+    [/[°]/g, "deg"],
+    [/ /g, " "],
+];
+export function escposText(s) {
+    if (s == null)
+        return "";
+    let out = String(s);
+    for (const [re, sub] of ESCPOS_REPLACEMENTS)
+        out = out.replace(re, sub);
+    // Strip any remaining non-ASCII (accents, emoji, CJK) — the printer cannot
+    // render them and would print garbage bytes.
+    out = out.replace(/[^\x20-\x7E\n]/g, "?");
+    return out;
+}
 function padR(text, width) {
     if (text.length >= width)
         return text.slice(0, width);
@@ -60,14 +94,19 @@ function formatDatetime(iso) {
     }
 }
 export function calloutNumber(order) {
+    // The backend assigns a real callout_number — always prefer it.
+    const direct = order.callout_number;
+    if (typeof direct === "number" && Number.isFinite(direct))
+        return String(Math.abs(direct));
     const num = order.order_number || "";
     if (!num)
         return "----";
-    const last4 = num.slice(-4);
-    const n = parseInt(last4, 10);
-    if (Number.isNaN(n))
-        return last4;
-    return String(n);
+    // Strip non-digits first: local DD-RRR-CCC numbers end in "-CCC" and
+    // parseInt("-005") would give -5 (the old "-5" bug).
+    const digits = num.slice(-4).replace(/\D/g, "");
+    if (!digits)
+        return num.slice(-4);
+    return String(parseInt(digits, 10));
 }
 function itemName(item) {
     return item.menu_item?.name || "(deleted item)";
@@ -115,8 +154,19 @@ function businessAddress(business) {
         return null;
     if (b.location?.address)
         return b.location.address;
-    if (b.address)
+    if (typeof b.address === "string")
         return b.address;
+    // Desktop snapshots carry a structured address object — flatten it
+    // (printing the object itself would render "[object Object]").
+    if (b.address && typeof b.address === "object") {
+        if (b.address.fullAddress)
+            return b.address.fullAddress;
+        if (b.address.full_address)
+            return b.address.full_address;
+        const parts = [b.address.street, b.address.city].filter(Boolean);
+        if (parts.length)
+            return parts.join(", ");
+    }
     return null;
 }
 function businessLogoUrl(order) {
@@ -165,39 +215,47 @@ export function generateEscpos(order) {
     const parts = [];
     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)); };
     // Header — matches receipt.ex to_escpos/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.
     push(ESC_INIT);
     push(ESC_ALIGN_CENTER);
     push(GS_SIZE_DOUBLE_WH);
-    push(business?.name || "Teinc Food");
+    pushT(business?.name || "Teinc Food");
     push(LF);
     push(GS_SIZE_NORMAL);
     const addr = businessAddress(business);
     if (addr)
-        push(addr + LF);
+        pushT(addr + LF);
     const bPhone = business?.phone;
     if (bPhone)
-        push(`Tel: ${bPhone}${LF}`);
+        pushT(`Tel: ${bPhone}${LF}`);
     push(GS_SIZE_NORMAL);
-    push(doubleLineEscpos());
+    pushT(doubleLineEscpos());
     // Order info
     push(ESC_ALIGN_LEFT);
-    push(`Order: ${order.order_number}${LF}`);
+    pushT(`Order: ${order.order_number}${LF}`);
     // callout_box_escpos
     push(ESC_ALIGN_CENTER);
     push(GS_SIZE_DOUBLE_W);
-    push(`Callout: ${calloutNumber(order)}${LF}`);
+    pushT(`Callout: ${calloutNumber(order)}${LF}`);
     push(GS_SIZE_NORMAL);
     push(LF);
     push(ESC_ALIGN_LEFT);
-    push(`Date: ${formatDatetime(order.inserted_at)}${LF}`);
-    push(`Type: ${orderTypeEscpos(order)}${LF}`);
+    pushT(`Date: ${formatDatetime(order.inserted_at)}${LF}`);
+    pushT(`Type: ${orderTypeEscpos(order)}${LF}`);
     const custLine = customerLineEscpos(order);
     if (custLine)
-        push(custLine);
+        pushT(custLine);
     push(LF);
-    // Barcode — CODE128 GS k 73
+    // Barcode — CODE128 GS k 73, sized down (default height is huge).
     push(ESC_ALIGN_CENTER);
+    push(GS_BAR_HEIGHT);
+    push(GS_BAR_WIDTH);
     const data = order.order_number || "";
     push(String.fromCharCode(0x1d, 0x6b, 0x49, data.length) + data);
     push(LF);
@@ -205,44 +263,44 @@ export function generateEscpos(order) {
     push(ESC_ALIGN_LEFT);
     push(`${padR("Item", 16)} Qty   Price`);
     push(LF);
-    push(singleLineEscpos());
+    pushT(singleLineEscpos());
     push(LF);
     for (const item of items) {
         const qty = item.quantity || 1;
         const price = formatMoney((item.unit_price ?? 0) * qty, order);
-        push(`  ${padR(itemName(item), 16)} ${padR(String(qty), 4)} ${padR(price, 9)}${LF}`);
+        pushT(`  ${padR(itemName(item), 16)} ${padR(String(qty), 4)} ${padR(price, 9)}${LF}`);
         const addons = item.order_item_addons ?? item.addons ?? [];
         for (const addon of addons) {
             const aName = addonName(addon);
             const aPriceMinor = addon.price_minor ?? addon.price ?? 0;
             const addonPrice = formatMoney(aPriceMinor, order);
-            push(`    + ${padR(aName, 12)}      ${padR(addonPrice, 9)}${LF}`);
+            pushT(`    + ${padR(aName, 12)}      ${padR(addonPrice, 9)}${LF}`);
         }
     }
-    push(singleLineEscpos());
+    pushT(singleLineEscpos());
     push(LF);
     // Subtotal section — mirrors subtotal_section_escpos/2
-    push(`${padR("Subtotal:", 20)} ${formatMoney(order.subtotal_minor, order)}${LF}`);
+    pushT(`${padR("Subtotal:", 20)} ${formatMoney(order.subtotal_minor, order)}${LF}`);
     if (order.delivery_fee_minor && order.delivery_fee_minor > 0) {
-        push(`${padR("Delivery Fee:", 20)} ${formatMoney(order.delivery_fee_minor, order)}${LF}`);
+        pushT(`${padR("Delivery Fee:", 20)} ${formatMoney(order.delivery_fee_minor, order)}${LF}`);
     }
     for (const tax of taxLines) {
         const rateStr = tax.rate_basis_points ? `(${Math.floor(tax.rate_basis_points / 100)}%)` : "";
         const label = `${tax.name || ""} ${rateStr}`.trim().slice(0, 19);
-        push(`${padR(label, 20)} ${formatMoney(tax.tax_amount_minor, order)}${LF}`);
+        pushT(`${padR(label, 20)} ${formatMoney(tax.tax_amount_minor, order)}${LF}`);
     }
     if (order.discount_minor && order.discount_minor > 0) {
-        push(`${padR("Discount:", 20)} -${formatMoney(order.discount_minor, order)}${LF}`);
+        pushT(`${padR("Discount:", 20)} -${formatMoney(order.discount_minor, order)}${LF}`);
     }
     push(ESC_BOLD_ON);
-    push(`${padR("TOTAL:", 20)} ${formatMoney(order.total_minor, order)}${LF}`);
+    pushT(`${padR("TOTAL:", 20)} ${formatMoney(order.total_minor, order)}${LF}`);
     push(ESC_BOLD_OFF);
     push(LF);
     push(ESC_ALIGN_CENTER);
-    push(paymentLineEscpos(order));
+    pushT(paymentLineEscpos(order));
     push(LF);
     // Footer
-    push(doubleLineEscpos());
+    pushT(doubleLineEscpos());
     push("Thank you for your order!" + LF);
     push("Come back soon!" + LF);
     push(ESC_FEED_3);

package/dist/sync/command-queue.service.js

@@ -13,6 +13,7 @@ import { insertCommand, getPendingCommands, markCommandInFlight, updateCommandSt
 import { syncLogger } from "../utils/sync-logger";
 import { recordAttempt } from "../utils/attempt-stats";
 import { TransitionError, isReplayDeferred, TRANSITION_ERROR_CODES } from "./transition-errors";
+import { assertBusinessOpenForCreate } from "../utils/business-hours";
 import { extractApiErrorCode } from "../utils/error";
 import { generateEventId } from "../utils/uuid";
 import { generateLocalCalloutNumber, generateOrderNumberForBusiness, generateOrderNumber, } from "./order-number";
@@ -203,6 +204,14 @@ class CommandQueueService {
      * Returns an optimistic domain event so the caller can update the UI.
      */
     async enqueue(command) {
+        // Queue-time hours gate: a closed business can never legally sync an
+        // order:create, so fail fast with BusinessHoursError instead of queuing
+        // an optimistic order that would sit pending forever. Other command
+        // types (transitions, payments, delivery) are unaffected so in-progress
+        // orders can still be completed while closed.
+        if (command.command_type === "order:create") {
+            await assertBusinessOpenForCreate(command.business_id);
+        }
         const db = getSyncDatabase();
         const preparedCommand = injectLocalOrderNumber(command);
         await insertCommand(db, { command: preparedCommand, status: "pending" });

package/dist/sync/engine.js

@@ -149,6 +149,20 @@ export class SyncEngine {
                 return events;
             }
             catch (error) {
+                // Definitive hours-guard rejection (thrown by createLocalOrder before
+                // any HTTP): the business is closed. Surface it immediately — do not
+                // mark cloud unreachable and do not fall back to the outbox, which
+                // would either re-throw from the enqueue gate or mask a real decision
+                // as a connectivity problem.
+                const code = errorCodeOf(error);
+                if (code === "BUSINESS_CLOSED" || code === "HOURS_NOT_SYNCED") {
+                    syncLogger.warn("SyncEngine", "Command blocked: business closed", {
+                        command_type: command.command_type,
+                        command_id: command.command_id,
+                        code,
+                    });
+                    throw error;
+                }
                 // Definitive server rejection (4xx): the backend answered with a real
                 // decision (e.g. INVALID_TRANSITION, PAYMENT_REQUIRED, FORBIDDEN).
                 // Surface it instead of masking it as a connectivity problem and
@@ -159,7 +173,6 @@ export class SyncEngine {
                     ? error.status
                     : undefined;
                 if (rejectionStatus !== undefined && rejectionStatus >= 400 && rejectionStatus < 500) {
-                    const code = errorCodeOf(error);
                     syncLogger.warn("SyncEngine", "Cloud command rejected by server", {
                         command_type: command.command_type,
                         command_id: command.command_id,

package/package.json

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