@teincfood/core 0.9.10 → 0.9.11

package/dist/reference/menu-record.d.ts

@@ -49,6 +49,21 @@ export interface MenuItemEnvelopeInput extends MenuItemRecordInput {
     /** Extra wire-only keys (e.g. entity id). */
     wireExtra?: Record<string, unknown>;
 }
+/**
+ * Image value for a menu-item UPDATE wire payload. The server is the source
+ * of truth for the stored key — never re-send a loaded URL and risk
+ * overwriting the key with a URL-shaped value. Returns `undefined` when the
+ * caller must OMIT `image_url` (server keeps its key untouched):
+ * - fresh upload → the bare S3 key;
+ * - user removed the photo (had one, now empty) → explicit null (clear it);
+ * - loaded an un-storable scheme (tfimg:/blob:/file: poison) → null (heal);
+ * - otherwise (loaded URL or bare key, no new upload) → omit (preserve).
+ */
+export declare function imageUrlForUpdateWire(opts: {
+    freshKey?: string | null;
+    loadedUrl?: string | null;
+    hadImage: boolean;
+}): string | null | undefined;
 /**
  * Build the { wire, cacheRecord } pair for a menu item write. Callers pass
  * absolute variant prices (backend model) — the form layer owns the field.

package/dist/reference/menu-record.js

@@ -122,6 +122,26 @@ const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/
 function wireId(id) {
     return id && UUID_RE.test(id) ? id : undefined;
 }
+/**
+ * Image value for a menu-item UPDATE wire payload. The server is the source
+ * of truth for the stored key — never re-send a loaded URL and risk
+ * overwriting the key with a URL-shaped value. Returns `undefined` when the
+ * caller must OMIT `image_url` (server keeps its key untouched):
+ * - fresh upload → the bare S3 key;
+ * - user removed the photo (had one, now empty) → explicit null (clear it);
+ * - loaded an un-storable scheme (tfimg:/blob:/file: poison) → null (heal);
+ * - otherwise (loaded URL or bare key, no new upload) → omit (preserve).
+ */
+export function imageUrlForUpdateWire(opts) {
+    if (opts.freshKey)
+        return opts.freshKey;
+    const loaded = opts.loadedUrl ?? null;
+    if (!loaded)
+        return opts.hadImage ? null : undefined;
+    if (toStorableImageUrl(loaded) === null)
+        return null;
+    return undefined;
+}
 /**
  * Build the { wire, cacheRecord } pair for a menu item write. Callers pass
  * absolute variant prices (backend model) — the form layer owns the field.

package/package.json

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