@teincfood/core 0.10.22 → 0.10.24

package/dist/domain/orders/service.d.ts

@@ -1,6 +1,6 @@
 /**
  * Local Orders Service — SQLite is real DB (like backend Orders).
- * Device-partitioned by UUID PK + DD-RRR-CCC per business.
+ * Device-partitioned by UUID PK + DD-NNNN-MMM per business.
  * POS orders start in the business's configured flow (staged → accepted,
  * direct → delivered); online payment requires connectivity.
  */

package/dist/domain/orders/service.js

@@ -1,6 +1,6 @@
 /**
  * Local Orders Service — SQLite is real DB (like backend Orders).
- * Device-partitioned by UUID PK + DD-RRR-CCC per business.
+ * Device-partitioned by UUID PK + DD-NNNN-MMM per business.
  * POS orders start in the business's configured flow (staged → accepted,
  * direct → delivered); online payment requires connectivity.
  */

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

@@ -43,6 +43,8 @@ export interface LocalNodeClient {
         contentType?: string | null;
         error?: string | null;
     }>;
+    /** Mirror locally cached image bytes to a connected node. */
+    putAsset?(businessId: string, url: string, base64: string): Promise<void>;
     publishEvent?(event: DomainEvent): Promise<void> | void;
 }
 export interface TransportAdapter {

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

@@ -24,6 +24,11 @@ declare class LocalNodeServiceCore {
     init(deps: LocalNodeDeps): void;
     private requestReferenceFromPeers;
     private requestAssetFromPeers;
+    /**
+     * Push locally cached image bytes to every connected node so terminals that
+     * cannot reach S3 (dark LAN) can fetch the same offline image.
+     */
+    putAsset(businessId: string, url: string, base64: string): Promise<boolean>;
     /**
      * 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).

package/dist/local-node/service.js

@@ -101,6 +101,30 @@ class LocalNodeServiceCore {
         }
         return null;
     }
+    /**
+     * Push locally cached image bytes to every connected node so terminals that
+     * cannot reach S3 (dark LAN) can fetch the same offline image.
+     */
+    async putAsset(businessId, url, base64) {
+        if (!businessId || !url || !base64)
+            return false;
+        let sent = false;
+        for (const peer of this.peers.values()) {
+            if (!peer.isConnected() || !peer.putAsset)
+                continue;
+            try {
+                await peer.putAsset(businessId, url, base64);
+                sent = true;
+            }
+            catch (error) {
+                syncLogger.debug("LocalNodeService", "asset put failed", {
+                    url,
+                    error: String(error),
+                });
+            }
+        }
+        return sent;
+    }
     async publishOrderCatchup(peerDeviceId) {
         if (!this.businessId)
             return;

package/dist/printer/receipt.js

@@ -181,7 +181,7 @@ export function calloutNumber(order) {
     const num = order.order_number || "";
     if (!num)
         return "----";
-    // Strip non-digits first: local DD-RRR-CCC numbers end in "-CCC" and
+    // Strip non-digits first: local DD-NNNN-MMM numbers end in "-MMM" and
     // parseInt("-005") would give -5 (the old "-5" bug).
     const digits = num.slice(-4).replace(/\D/g, "");
     if (!digits)

package/dist/printer/service.d.ts

@@ -7,7 +7,7 @@ import { generateEscpos, generateHtml } from "./receipt";
 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.
+ * Generate receipt locally without network — used for offline queued DD-NNNN-MMM 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, logoRasterB64?: string | null): string;

package/dist/printer/service.js

@@ -31,7 +31,7 @@ async function fetchReceipt(orderId, format = "html") {
     return resp.text();
 }
 /**
- * Generate receipt locally without network — used for offline queued DD-RRR-CCC orders.
+ * Generate receipt locally without network — used for offline queued DD-NNNN-MMM orders.
  * Pass a base64 logo raster (see resolveLogoRaster) to include the thermal header logo.
  */
 export function generateLocalReceipt(order, format = "escpos", logoDataUri, logoRasterB64) {
@@ -62,7 +62,7 @@ export async function printOrderReceipt(order, opts) {
     let html = null;
     if (isTcp) {
         try {
-            // Prefer backend escpos when we have a real UUID (not DD-RRR-CCC)
+            // Prefer backend escpos when we have a real UUID (not a local order number)
             const isLocal = /^[0-9]{2}-[0-9]{3,4}-[0-9]{3}$/.test(order.order_number) || /^[0-9A-F-]{36}$/.test(order.id) === false && order.id === order.order_number;
             if (!isLocal || order.id) {
                 try {

package/dist/repositories/order.repository.d.ts

@@ -28,7 +28,7 @@ export declare const orderRepository: {
      * Single create path: build an `order:create` command and route it through
      * the SyncEngine (cloud → LAN node → queue). Every path returns an
      * order-shaped payload: cloud/LAN execute the real create, queue returns
-     * the optimistic order (same UUID + DD-RRR-CCC, replayed idempotently).
+     * the optimistic order (same UUID + DD-NNNN-MMM, replayed idempotently).
      * Direct `createLocalOrder` bypasses sync — never call it from UI flows.
      */
     createOrder(input: CreateOrderInput): Promise<SellerOrder>;

package/dist/repositories/order.repository.js

@@ -42,7 +42,7 @@ export const orderRepository = {
      * Single create path: build an `order:create` command and route it through
      * the SyncEngine (cloud → LAN node → queue). Every path returns an
      * order-shaped payload: cloud/LAN execute the real create, queue returns
-     * the optimistic order (same UUID + DD-RRR-CCC, replayed idempotently).
+     * the optimistic order (same UUID + DD-NNNN-MMM, replayed idempotently).
      * Direct `createLocalOrder` bypasses sync — never call it from UI flows.
      */
     async createOrder(input) {

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

@@ -194,7 +194,7 @@ function injectLocalOrderNumber(command) {
     const payload = command.payload;
     if (payload.order_number)
         return command;
-    // 0.7.0: business-scoped DD-RRR-CCC; requires leased device_number
+    // Business-scoped DD-NNNN-MMM; requires a leased device_number
     const orderNumber = generateOrderNumberForBusiness(command.business_id);
     return {
         ...command,

package/dist/sync/offline-capable.js

@@ -19,6 +19,10 @@ import { getConnectivityState } from "../adapters/connectivity";
 import { CAPABILITY_BY_COMMAND } from "../reference/capabilities";
 import { openSyncDatabase } from "../db/connection";
 import { getReferenceData } from "../reference/operations";
+import { commandQueueService } from "./command-queue.service";
+import { applyMenuCommandLocal } from "../reference/menu-apply";
+import { emitReferenceChanged } from "../reference/events";
+import { isOnlineCapable } from "./online-gates";
 export async function runOfflineCapableMutation(options) {
     // Per-command capability guard before even attempting direct call
     const required = CAPABILITY_BY_COMMAND[options.commandType];
@@ -26,10 +30,10 @@ export async function runOfflineCapableMutation(options) {
         // Online-required gate first: these commands can never succeed offline —
         // throw loud immediately instead of queuing what no transport can fulfill.
         assertOnlineFor(options.commandType, options.payload);
-        // Local-first for engine-routed domains (menu:*): commit locally via the
-        // engine and resolve immediately. Network is sync transport only — never a
-        // mutation delay. The engine cloud path carries the same 2.5s cap and
-        // returns the backend response when online.
+        // Local-first for engine-routed domains (menu:*): persist to SQLite and the
+        // durable outbox immediately, update the local reference cache, and let
+        // replay upload to the cloud/LAN in the background. A slow or absent
+        // network must never hold the form open.
         if (options.commandType.startsWith("menu:")) {
             const command = buildCommand({
                 commandType: options.commandType,
@@ -37,8 +41,26 @@ export async function runOfflineCapableMutation(options) {
                 entityId: options.entityId,
                 payload: options.payload,
             });
-            const events = await syncEngine.execute(command);
-            return events[0]?.payload;
+            try {
+                const { keys } = await applyMenuCommandLocal(options.businessId, command);
+                if (keys.length)
+                    emitReferenceChanged(options.businessId, keys);
+            }
+            catch (error) {
+                syncLogger.debug("OfflineCapable", "menu local apply failed", {
+                    error: String(error),
+                });
+            }
+            const event = await commandQueueService.enqueue(command);
+            if (isOnlineCapable()) {
+                // Background only: save must return now.
+                void syncEngine.replayQueuedCommands().catch((error) => {
+                    syncLogger.debug("OfflineCapable", "menu background replay failed", {
+                        error: String(error),
+                    });
+                });
+            }
+            return event.payload;
         }
         try {
             const db = await openSyncDatabase();

package/dist/sync/startup-readiness.d.ts

@@ -25,7 +25,7 @@ export interface StartupReadiness {
     ready: boolean;
     /** Required keys with no cached payload. */
     missingKeys: ReferenceDataKey[];
-    /** True when no DD-RRR-CCC device number is available (needs one online lease). */
+    /** True when no DD-NNNN-MMM device number is available (needs one online lease). */
     needsLease: boolean;
     /**
      * True when an entitlement envelope is absent or does not evaluate as

package/package.json

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