@teincfood/core 0.10.23 → 0.10.25

package/dist/sync/offline-capable.js

@@ -19,6 +19,11 @@ 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 { assertEntitledForCommand } from "../reference/entitlement-guard";
+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,19 +31,40 @@ 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:")) {
+            // Preserve the entitlement gate that the engine normally applies before
+            // queueing: local-first must not weaken subscription enforcement.
+            await assertEntitledForCommand(options.businessId, options.commandType);
             const command = buildCommand({
                 commandType: options.commandType,
                 businessId: options.businessId,
                 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/package.json

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