@teincfood/core 0.9.5 → 0.9.8

package/dist/index.d.ts

@@ -98,6 +98,7 @@ export * from "./reference/menu-record";
 export * from "./reference/menu-apply";
 export * from "./reference/capabilities";
 export * from "./reference/entitlements";
+export * from "./reference/entitlement-guard";
 export * from "./reference/entitlement-clock";
 export { hmacSha256Hex, sha256Hex } from "./reference/entitlement-crypto";
 export * from "./adapters/sqlite";
@@ -122,6 +123,7 @@ export { SELLER_ORDERS_KEYS, BUSINESS_DELIVERIES_KEYS, MENU_KEYS, REFERENCE_KEYS
 export * from "./printer/types";
 export * from "./printer/store";
 export * from "./printer/receipt";
+export * from "./printer/company";
 export * from "./printer/service";
 export * from "./printer/hooks";
 export * from "./cart/store";

package/dist/index.js

@@ -100,6 +100,7 @@ export * from "./reference/menu-record";
 export * from "./reference/menu-apply";
 export * from "./reference/capabilities";
 export * from "./reference/entitlements";
+export * from "./reference/entitlement-guard";
 export * from "./reference/entitlement-clock";
 export { hmacSha256Hex, sha256Hex } from "./reference/entitlement-crypto";
 // ── Adapters (for host apps to supply) ──
@@ -129,6 +130,7 @@ export { SELLER_ORDERS_KEYS, BUSINESS_DELIVERIES_KEYS, MENU_KEYS, REFERENCE_KEYS
 export * from "./printer/types";
 export * from "./printer/store";
 export * from "./printer/receipt";
+export * from "./printer/company";
 export * from "./printer/service";
 export * from "./printer/hooks";
 // ── Cart (device-local) ──

package/dist/local-node/service.js

@@ -731,6 +731,17 @@ class LocalNodeServiceCore {
                 event = events[0] ?? null;
             }
             catch (error) {
+                // A 4xx is a backend rejection of THIS command (validation, auth,
+                // state) — not evidence the cloud is down. Rethrow without touching
+                // global reachability (mirrors sync engine); only network/5xx marks
+                // unreachable. Otherwise one rejected sync poisons every later
+                // resolveStrategy() into queueing and gates unrelated API ops.
+                const rejectionStatus = error?.status;
+                if (typeof rejectionStatus === "number" &&
+                    rejectionStatus >= 400 &&
+                    rejectionStatus < 500) {
+                    throw error;
+                }
                 syncLogger.warn("LocalNodeService", "Cloud forward failed, queueing", { error: String(error) });
                 try {
                     setConnectivityState({ isCloudReachable: "unreachable" });

package/dist/printer/company.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Company footer info for receipts — platform/brand block printed under
+ * the receipt footer ("Powered by" section).
+ *
+ * Defaults match docs/receipt-template.md §4. Host apps override at boot
+ * from env (desktop: VITE_COMPANY_*, mobile: EXPO_PUBLIC_COMPANY_*) via
+ * setCompanyInfo; unset fields fall back to defaults. The backend reads
+ * COMPANY_* OS env with the same defaults.
+ */
+export interface CompanyInfo {
+    /** Company name, e.g. "TeincFood". */
+    name: string;
+    /** Consumer brand line, e.g. "TeincFood Business". */
+    brand: string;
+    address: string;
+    website: string;
+    supportEmail: string;
+    phone: string;
+}
+export declare function setCompanyInfo(partial: Partial<CompanyInfo>): void;
+export declare function getCompanyInfo(): CompanyInfo;

package/dist/printer/company.js

@@ -0,0 +1,30 @@
+/**
+ * Company footer info for receipts — platform/brand block printed under
+ * the receipt footer ("Powered by" section).
+ *
+ * Defaults match docs/receipt-template.md §4. Host apps override at boot
+ * from env (desktop: VITE_COMPANY_*, mobile: EXPO_PUBLIC_COMPANY_*) via
+ * setCompanyInfo; unset fields fall back to defaults. The backend reads
+ * COMPANY_* OS env with the same defaults.
+ */
+const DEFAULTS = {
+    name: "TeincFood",
+    brand: "TeincFood Business",
+    address: "Accra, Ghana",
+    website: "https://teincfood.com",
+    supportEmail: "support@teincfood.com",
+    phone: "+233 50 398 1913",
+};
+let override = {};
+export function setCompanyInfo(partial) {
+    const clean = {};
+    for (const [k, v] of Object.entries(partial)) {
+        if (typeof v === "string" && v.length > 0) {
+            clean[k] = v;
+        }
+    }
+    override = { ...override, ...clean };
+}
+export function getCompanyInfo() {
+    return { ...DEFAULTS, ...override };
+}

package/dist/printer/receipt.d.ts

@@ -1,15 +1,21 @@
 /**
- * Local receipt generation — 1:1 port of TeincFoodBackend.Orders.Receipt
- * Generates ESC/POS (80mm, 32 chars) and HTML from a SellerOrder snapshot.
- * Works fully offline for queued DD-RRR-CCC orders without backend fetch.
- *
- * Backend source: lib/teinc_food_backend/orders/receipt.ex
- * Keep this file in sync with backend when template changes.
+ * Local receipt generation — implements docs/receipt-template.md
+ * (single source of design; backend TeincFoodBackend.Orders.Receipt
+ * implements the same spec). Generates ESC/POS (80mm, 32 chars) and HTML
+ * (visual twin) from a SellerOrder snapshot. Works fully offline.
  */
 import type { SellerOrder } from "../types/api/seller.api";
 export declare function escposText(s: string | null | undefined): string;
+/** Word-wrap sanitized text to width. Long words hard-split. Never drops content. */
+export declare function wrapText(text: string, width: number): string[];
 export declare function calloutNumber(order: SellerOrder): string;
-export declare function generateEscpos(order: SellerOrder): string;
+/**
+ * Resolve cached logo raster (base64 `GS v 0` block) for an order: prefers
+ * `order.business.logo_escpos`, falls back to the synced `business:profile`
+ * reference. Null when none — fully offline, no network.
+ */
+export declare function resolveLogoRaster(order: SellerOrder): Promise<string | null>;
+export declare function generateEscpos(order: SellerOrder, logoRasterB64?: string | null): string;
 export declare function generateHtmlAsync(order: SellerOrder, opts?: {
     logoDataUri?: string | null;
     useCache?: boolean;

package/dist/printer/receipt.js

@@ -1,11 +1,10 @@
 /**
- * Local receipt generation — 1:1 port of TeincFoodBackend.Orders.Receipt
- * Generates ESC/POS (80mm, 32 chars) and HTML from a SellerOrder snapshot.
- * Works fully offline for queued DD-RRR-CCC orders without backend fetch.
- *
- * Backend source: lib/teinc_food_backend/orders/receipt.ex
- * Keep this file in sync with backend when template changes.
+ * Local receipt generation — implements docs/receipt-template.md
+ * (single source of design; backend TeincFoodBackend.Orders.Receipt
+ * implements the same spec). Generates ESC/POS (80mm, 32 chars) and HTML
+ * (visual twin) from a SellerOrder snapshot. Works fully offline.
  */
+import { getCompanyInfo } from "./company";
 import { openSyncDatabase } from "../db/connection";
 import { getReferenceData } from "../reference/operations";
 import { cacheRemoteImage, resolveImageSource } from "../image-cache/service";
@@ -17,7 +16,6 @@ const ESC_BOLD_ON = "\x1B\x45\x01";
 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";
@@ -60,6 +58,60 @@ function padR(text, width) {
         return text.slice(0, width);
     return text.padEnd(width, " ");
 }
+function padL(text, width) {
+    const s = String(text);
+    if (s.length >= width)
+        return s.slice(0, width);
+    return s.padStart(width, " ");
+}
+/** Word-wrap sanitized text to width. Long words hard-split. Never drops content. */
+export function wrapText(text, width) {
+    const words = [];
+    for (const word of text.split(" ").filter(Boolean)) {
+        if (word.length <= width)
+            words.push(word);
+        else
+            for (let i = 0; i < word.length; i += width)
+                words.push(word.slice(i, i + width));
+    }
+    const lines = [];
+    let cur = "";
+    for (const word of words) {
+        if (!cur)
+            cur = word;
+        else if (cur.length + 1 + word.length <= width)
+            cur += " " + word;
+        else {
+            lines.push(cur);
+            cur = word;
+        }
+    }
+    if (cur)
+        lines.push(cur);
+    return lines;
+}
+/**
+ * Business-name fit ladder (centered, never truncated):
+ * ≤16 chars → 2x, 17–64 → 1x bold (≤2 lines), longer → 1x (≤3 lines,
+ * keeps wrapping beyond that).
+ */
+function nameBlockEscpos(name) {
+    const text = escposText(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 wrapText(text, 32).flatMap((l) => [escposText(l), LF]);
+}
+function nameSizeClass(name) {
+    const len = (name || "").length;
+    if (len <= 16)
+        return "name-2x";
+    if (len <= 64)
+        return "name-1x-bold";
+    return "name-1x";
+}
 function currencySymbol(currency) {
     switch (currency) {
         case "GHS": return "₵";
@@ -112,13 +164,16 @@ function itemName(item) {
     return item.menu_item?.name || "(deleted item)";
 }
 function addonName(addon) {
-    const a = addon;
-    if (a.addon?.name)
-        return a.addon.name;
-    if (a.name)
-        return a.name;
+    if (addon.addon?.name)
+        return addon.addon.name;
+    if (addon.name)
+        return addon.name;
     return "Add-on";
 }
+function variantName(item) {
+    const n = item.variant?.name;
+    return n ? n : null;
+}
 function orderTypeText(order) {
     const t = order.order_type;
     if (t === "takeout")
@@ -194,6 +249,54 @@ async function fetchAsDataUri(url) {
         return null;
     }
 }
+/** Decode base64 raster bytes (from `business:profile` reference) to a byte string. */
+function binaryFromBase64(b64) {
+    const clean = b64.replace(/\s/g, "");
+    if (typeof atob === "function")
+        return atob(clean);
+    const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+    let out = "";
+    let buf = 0;
+    let bits = 0;
+    for (const ch of clean) {
+        if (ch === "=")
+            break;
+        const v = chars.indexOf(ch);
+        if (v < 0)
+            continue;
+        buf = (buf << 6) | v;
+        bits += 6;
+        if (bits >= 8) {
+            bits -= 8;
+            out += String.fromCharCode((buf >> bits) & 0xff);
+        }
+    }
+    if (!out)
+        throw new Error("empty raster");
+    return out;
+}
+/**
+ * Resolve cached logo raster (base64 `GS v 0` block) for an order: prefers
+ * `order.business.logo_escpos`, falls back to the synced `business:profile`
+ * reference. Null when none — fully offline, no network.
+ */
+export async function resolveLogoRaster(order) {
+    const direct = order.business?.logo_escpos;
+    if (typeof direct === "string" && direct.length > 0)
+        return direct;
+    try {
+        const bId = order.business_id;
+        if (!bId)
+            return null;
+        const db = await openSyncDatabase();
+        const ref = await getReferenceData(db, bId, "business:profile");
+        const raster = ref?.payload?.data?.logo_escpos;
+        return typeof raster === "string" && raster.length > 0 ? raster : null;
+    }
+    catch {
+        return null;
+    }
+}
 // ── ESC/POS ────────────────────────────────────────────────────────────
 function doubleLineEscpos() { return "═".repeat(LINE_WIDTH) + LF; }
 function singleLineEscpos() { return "─".repeat(LINE_WIDTH); }
@@ -208,7 +311,7 @@ function customerLineEscpos(order) {
 }
 function orderTypeEscpos(order) { return orderTypeText(order); }
 function paymentLineEscpos(order) { return paymentLineText(order); }
-export function generateEscpos(order) {
+export function generateEscpos(order, logoRasterB64) {
     const business = order.business;
     const items = order.items || [];
     const taxLines = (order.order_tax_lines ?? order.tax_lines ?? []);
@@ -219,15 +322,19 @@ export function generateEscpos(order) {
     // (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
+    // 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.
     push(ESC_INIT);
+    if (logoRasterB64) {
+        try {
+            push(binaryFromBase64(logoRasterB64));
+        }
+        catch { /* logo is decorative — never fail the receipt */ }
+    }
     push(ESC_ALIGN_CENTER);
-    push(GS_SIZE_DOUBLE_WH);
-    pushT(business?.name || "Teinc Food");
-    push(LF);
-    push(GS_SIZE_NORMAL);
+    for (const part of nameBlockEscpos(business?.name || "Teinc Food"))
+        push(part);
     const addr = businessAddress(business);
     if (addr)
         pushT(addr + LF);
@@ -239,7 +346,8 @@ export function generateEscpos(order) {
     // Order info
     push(ESC_ALIGN_LEFT);
     pushT(`Order: ${order.order_number}${LF}`);
-    // callout_box_escpos
+    // callout_box_escpos — symmetric blank lines, no border rules around it
+    push(LF);
     push(ESC_ALIGN_CENTER);
     push(GS_SIZE_DOUBLE_W);
     pushT(`Callout: ${calloutNumber(order)}${LF}`);
@@ -259,43 +367,61 @@ export function generateEscpos(order) {
     const data = order.order_number || "";
     push(String.fromCharCode(0x1d, 0x6b, 0x49, data.length) + data);
     push(LF);
-    // Items
+    // Items — template §2: name 17 | qty 3 (right) | price 10 (right) = 32
     push(ESC_ALIGN_LEFT);
-    push(`${padR("Item", 16)} Qty   Price`);
+    push(`${padR("Item", 17)} ${padL("Qty", 3)} ${padL("Price", 10)}`);
     push(LF);
     pushT(singleLineEscpos());
     push(LF);
     for (const item of items) {
         const qty = item.quantity || 1;
-        const price = formatMoney((item.unit_price ?? 0) * qty, order);
-        pushT(`  ${padR(itemName(item), 16)} ${padR(String(qty), 4)} ${padR(price, 9)}${LF}`);
+        const price = escposText(formatMoney((item.unit_price ?? 0) * qty, order));
+        const nameLines = wrapText(escposText(itemName(item)), 17);
+        const first = nameLines[0] ?? "(deleted item)";
+        const rest = nameLines.slice(1, 2);
+        pushT(`${padR(first, 17)} ${padL(qty, 3)} ${padL(price, 10)}${LF}`);
+        for (const cont of rest)
+            pushT(`${padR(cont, 17)}${LF}`);
+        const vName = variantName(item);
+        if (vName) {
+            for (const vl of wrapText(escposText(`Size: ${vName}`), 30))
+                pushT(`  ${vl}${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);
-            pushT(`    + ${padR(aName, 12)}      ${padR(addonPrice, 9)}${LF}`);
+            const addonPrice = escposText(formatMoney(aPriceMinor, order));
+            const aLines = wrapText(escposText(addonName(addon)), 17);
+            if (!aLines.length)
+                continue;
+            pushT(`  + ${padR(aLines[0], 17)} ${padL(addonPrice, 10)}${LF}`);
+            for (const aCont of aLines.slice(1, 2))
+                pushT(`      ${padR(aCont, 17)}${LF}`);
         }
     }
     pushT(singleLineEscpos());
     push(LF);
-    // Subtotal section — mirrors subtotal_section_escpos/2
-    pushT(`${padR("Subtotal:", 20)} ${formatMoney(order.subtotal_minor, order)}${LF}`);
+    // Subtotal section — template §3: label 20 + amount 11 (right)
+    pushT(`${padR("Subtotal:", 20)} ${padL(escposText(formatMoney(order.subtotal_minor, order)), 11)}${LF}`);
     if (order.delivery_fee_minor && order.delivery_fee_minor > 0) {
-        pushT(`${padR("Delivery Fee:", 20)} ${formatMoney(order.delivery_fee_minor, order)}${LF}`);
+        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 label = `${tax.name || ""} ${rateStr}`.trim().slice(0, 19);
-        pushT(`${padR(label, 20)} ${formatMoney(tax.tax_amount_minor, order)}${LF}`);
+        pushT(`${padR(label, 20)} ${padL(escposText(formatMoney(tax.tax_amount_minor, order)), 11)}${LF}`);
     }
     if (order.discount_minor && order.discount_minor > 0) {
-        pushT(`${padR("Discount:", 20)} -${formatMoney(order.discount_minor, order)}${LF}`);
+        pushT(`${padR("Discount:", 20)} ${padL("-" + escposText(formatMoney(order.discount_minor, order)), 11)}${LF}`);
     }
+    push(LF);
     push(ESC_BOLD_ON);
-    pushT(`${padR("TOTAL:", 20)} ${formatMoney(order.total_minor, order)}${LF}`);
+    pushT(`${padR("TOTAL:", 20)} ${padL(escposText(formatMoney(order.total_minor, order)), 11)}${LF}`);
     push(ESC_BOLD_OFF);
     push(LF);
+    // Footer — template §4 company block (centered, never truncated)
+    const company = getCompanyInfo();
+    const contactLine = `${company.address} | ${company.phone}`;
     push(ESC_ALIGN_CENTER);
     pushT(paymentLineEscpos(order));
     push(LF);
@@ -303,6 +429,12 @@ export function generateEscpos(order) {
     pushT(doubleLineEscpos());
     push("Thank you for your order!" + LF);
     push("Come back soon!" + LF);
+    push(LF);
+    pushT(company.brand + LF);
+    pushT(contactLine + LF);
+    pushT(company.supportEmail + LF);
+    pushT(company.website + LF);
+    pushT(`Powered by ${company.name}` + LF);
     push(ESC_FEED_3);
     push(GS_CUT_FULL);
     return parts.filter((p) => p != null).join("");
@@ -363,6 +495,7 @@ export function generateHtml(order, logoDataUri) {
     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) => {
@@ -370,13 +503,17 @@ export function generateHtml(order, logoDataUri) {
         // unit_price is already minor? backend format_money expects minor
         const price = formatMoney((item.unit_price ?? 0) * qty, order);
         const main = `<tr><td class="item-name">${escHtml(itemName(item))}</td><td class="item-qty">${qty}</td><td class="item-price">${price}</td></tr>`;
-        const addons = (item.order_item_addons ?? item.addons ?? []);
+        const vName = variantName(item);
+        const variantRow = vName
+            ? `<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 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");
-        return [main, addonRows].filter(Boolean).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)}%)` : "";
@@ -389,23 +526,28 @@ export function generateHtml(order, logoDataUri) {
 <style>
   body{font-family:monospace;max-width:320px;margin:0 auto;padding:16px;background:#fff;color:#111;}
   .header{text-align:center;border-top:2px solid #333;border-bottom:2px solid #333;padding:8px 0;margin-bottom:12px;}
-  .header .logo{max-width:180px;max-height:60px;margin:4px auto;display:block;object-fit:contain;}
-  .header h2{margin:4px 0 0;font-size:14px;}
+  .header .logo{max-width:200px;max-height:64px;margin:4px auto;display:block;object-fit:contain;}
+  .header h2{margin:4px 0 0;}
+  .header h2.name-2x{font-size:28px;font-weight:bold;}
+  .header h2.name-1x-bold{font-size:16px;font-weight:bold;}
+  .header h2.name-1x{font-size:14px;}
   .header .address{font-size:11px;color:#555;margin:2px 0;}
-  .callout{border:3px double #333;text-align:center;padding:10px;margin:10px 0;}
+  .callout{text-align:center;margin:16px 0;}
   .callout .number{font-size:36px;font-weight:bold;letter-spacing:4px;margin:0;}
   .callout .label{font-size:10px;color:#555;margin:0;}
   .order-info{font-size:12px;margin:8px 0;}
-  table{width:100%;font-size:12px;border-collapse:collapse;}
-  td{padding:2px 0;vertical-align:top;}
-  .item-name{width:50%;}
-  .item-qty{width:15%;text-align:center;}
-  .item-price{width:35%;text-align:right;}
+  table{width:100%;font-size:12px;border-collapse:collapse;table-layout:fixed;}
+  td{padding:2px 0;vertical-align:top;overflow-wrap:anywhere;}
+  .item-name{width:17ch;}
+  .item-qty{width:3ch;text-align:right;}
+  .item-price{width:10ch;text-align:right;}
   .addon-row td{font-size:11px;color:#666;padding-left:12px;}
   .addon-row td.addon-price{text-align:right;}
+  .variant-row td{font-size:11px;color:#444;padding-left:8px;}
   .totals{margin-top:8px;}
   .totals td.label{text-align:left;width:70%;}
   .totals td.amount{text-align:right;width:30%;}
+  .total-row td{padding-top:12px;}
   .total-row{font-weight:bold;font-size:15px;border-top:2px solid #333;border-bottom:2px solid #333;padding:4px 0;}
   .footer{text-align:center;margin-top:16px;padding-top:8px;font-size:12px;color:#555;}
   @media print{body{max-width:80mm;padding:0;}}
@@ -413,7 +555,7 @@ export function generateHtml(order, logoDataUri) {
 <body>
 <div class="header">
   ${hasLogo ? `<img class="logo" src="${escHtml(logoSrc)}" alt="${businessName}" />` : ""}
-  <h2>${businessName}</h2>
+  <h2 class="${nameSizeClass(business?.name)}">${businessName}</h2>
   <div class="address">${escHtml(addr || "")}</div>
   ${bPhone ? `<div class="address">Tel: ${escHtml(bPhone)}</div>` : ""}
 </div>
@@ -443,6 +585,7 @@ export function generateHtml(order, logoDataUri) {
 </div>
 <div class="footer">
   Thank you for your order!<br>Come back soon!
+  <br><br>${escHtml(company.brand)}<br>${escHtml(company.address)} | ${escHtml(company.phone)}<br>${escHtml(company.supportEmail)}<br>${escHtml(company.website)}<br>Powered by ${escHtml(company.name)}
 </div>
 </body></html>`;
 }

package/dist/printer/service.d.ts

@@ -8,8 +8,11 @@ import type { SellerOrder } from "../types/api/seller.api";
 declare function fetchReceipt(orderId: string, format?: "html" | "escpos"): Promise<string>;
 /**
  * Generate receipt locally without network — used for offline queued DD-RRR-CCC orders.
+ * Pass a base64 logo raster (see resolveLogoRaster) to include the thermal header logo.
  */
-export declare function generateLocalReceipt(order: SellerOrder, format?: "html" | "escpos", logoDataUri?: string | null): string;
+export declare function generateLocalReceipt(order: SellerOrder, format?: "html" | "escpos", logoDataUri?: string | null, logoRasterB64?: string | null): string;
+/** Async variant: resolves the cached logo raster before generating. */
+export declare function generateLocalReceiptAsync(order: SellerOrder, format?: "html" | "escpos", logoDataUri?: string | null): Promise<string>;
 /**
  * Print an order — tries TCP ESC/POS if a default printer is configured, otherwise
  * generates HTML and uses the PrintFileAdapter (expo-print / Tauri print).
@@ -23,6 +26,7 @@ export declare function sendToTcpPrinter(ip: string, port: number, text: string)
 export declare const printerService: {
     fetchReceipt: typeof fetchReceipt;
     generateLocalReceipt: typeof generateLocalReceipt;
+    generateLocalReceiptAsync: typeof generateLocalReceiptAsync;
     printOrderReceipt: typeof printOrderReceipt;
     sendToTcpPrinter: typeof sendToTcpPrinter;
     generateEscpos: typeof generateEscpos;

package/dist/printer/service.js

@@ -6,7 +6,7 @@
 import { getHttpClient } from "../adapters/http";
 import { getTcpAdapter, getPrintFileAdapter } from "../adapters/print";
 import { getPrinterState } from "./store";
-import { generateEscpos, generateHtml } from "./receipt";
+import { generateEscpos, generateHtml, resolveLogoRaster } from "./receipt";
 import { API_BASE_URL } from "../utils/constants";
 async function fetchReceipt(orderId, format = "html") {
     const http = getHttpClient();
@@ -32,9 +32,18 @@ async function fetchReceipt(orderId, format = "html") {
 }
 /**
  * Generate receipt locally without network — used for offline queued DD-RRR-CCC orders.
+ * Pass a base64 logo raster (see resolveLogoRaster) to include the thermal header logo.
  */
-export function generateLocalReceipt(order, format = "escpos", logoDataUri) {
-    return format === "escpos" ? generateEscpos(order) : generateHtml(order, logoDataUri);
+export function generateLocalReceipt(order, format = "escpos", logoDataUri, logoRasterB64) {
+    return format === "escpos"
+        ? generateEscpos(order, logoRasterB64 ?? null)
+        : generateHtml(order, logoDataUri);
+}
+/** Async variant: resolves the cached logo raster before generating. */
+export async function generateLocalReceiptAsync(order, format = "escpos", logoDataUri) {
+    if (format !== "escpos")
+        return generateHtml(order, logoDataUri);
+    return generateEscpos(order, await resolveLogoRaster(order));
 }
 /**
  * Print an order — tries TCP ESC/POS if a default printer is configured, otherwise
@@ -64,7 +73,7 @@ export async function printOrderReceipt(order, opts) {
                 }
             }
             if (!escpos)
-                escpos = generateLocalReceipt(order, "escpos", opts?.logoDataUri ?? null);
+                escpos = generateEscpos(order, await resolveLogoRaster(order));
             const tcp = getTcpAdapter();
             if (!tcp)
                 throw new Error("TCP adapter not configured");
@@ -112,6 +121,7 @@ export async function sendToTcpPrinter(ip, port, text) {
 export const printerService = {
     fetchReceipt,
     generateLocalReceipt,
+    generateLocalReceiptAsync,
     printOrderReceipt,
     sendToTcpPrinter,
     generateEscpos,

package/dist/reference/entitlement-guard.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Offline entitlement auto-guard — evaluates the cached signed
+ * `subscription:entitlements` envelope and enforces gated commands locally,
+ * before any transport is attempted. The backend remains the final authority
+ * (HTTP 402 SUBSCRIPTION_REQUIRED); this guard gives immediate feedback and
+ * keeps disallowed work out of the outbox.
+ *
+ * Fail-closed: missing envelope, missing secret, bad signature, expired, or
+ * stale (> max_offline_days) => gated commands throw SUBSCRIPTION_REQUIRED.
+ * The host app provisions the HMAC secret at boot via setEntitlementSecret
+ * and refreshes the envelope via reference sync; useEntitlements surfaces
+ * mustReconnect/paywall state for UI gates.
+ */
+import { type EntitlementEvaluation } from "./entitlements";
+/** Provisioned once at app boot from the host app's env. */
+export declare function setEntitlementSecret(secret: string | null): void;
+export declare function getEntitlementSecret(): string | null;
+export interface BusinessEntitlementState {
+    evaluation: EntitlementEvaluation;
+    features: Record<string, unknown> | null;
+}
+/** Evaluate the cached signed envelope for a business (no network). */
+export declare function evaluateBusinessEntitlements(businessId: string): Promise<BusinessEntitlementState>;
+export declare function isEntitlementGated(commandType: string): boolean;
+/**
+ * Throw SUBSCRIPTION_REQUIRED unless the cached entitlement proof covers
+ * this command. No-ops for non-gated commands — and when no envelope was
+ * ever cached (fresh terminal that never synced): the backend remains the
+ * authority there. Once proof exists, invalid/expired/stale proof denies.
+ */
+export declare function assertEntitledForCommand(businessId: string, commandType: string): Promise<void>;