@wix/himalaya-cli 0.1574.0 → 0.1575.0

package/templates/branded-lite/l10n/he.json

@@ -0,0 +1,200 @@
+{
+  "$source": "he",
+  "messages": {
+    "h_c04921f8d946": {
+      "source": "No messages yet",
+      "key": "businessChat.emptyTitle",
+      "translation": "עדיין אין הודעות"
+    },
+    "h_cf765512cc6d": {
+      "source": "Sending…",
+      "key": "businessChat.sending",
+      "translation": "שולח…"
+    },
+    "h_b9e09ae263fb": {
+      "source": "Not confirmed",
+      "key": "businessChat.unconfirmed",
+      "translation": "לא אושר"
+    },
+    "h_9443bda693df": {
+      "source": "Your member session changed. Sign in again to continue.",
+      "key": "businessChat.sessionChanged",
+      "translation": "ההתחברות שלך השתנתה. יש להתחבר שוב כדי להמשיך."
+    },
+    "h_aa36b83daad9": {
+      "source": "This app host cannot reach the inbox yet.",
+      "key": "businessChat.hostUnavailable",
+      "translation": "לא ניתן לגשת לתיבת ההודעות באפליקציה זו כרגע."
+    },
+    "h_e9b3cc0ff1a1": {
+      "source": "Message delivery could not be confirmed. Check the conversation before trying again.",
+      "key": "businessChat.sendFailed",
+      "translation": "לא ניתן לאשר שההודעה נמסרה. יש לבדוק את השיחה לפני ניסיון נוסף."
+    },
+    "h_9a5009643173": {
+      "source": "Couldn’t open the conversation. Try again.",
+      "key": "businessChat.openFailed",
+      "translation": "לא ניתן לפתוח את השיחה. נסו שוב."
+    },
+    "h_a8e08e79182b": {
+      "source": "Couldn’t load the conversation. Try again.",
+      "key": "businessChat.loadFailed",
+      "translation": "לא ניתן לטעון את השיחה. נסו שוב."
+    },
+    "h_c21b9303d41d": {
+      "source": "Sign in to send a message.",
+      "key": "businessChat.signInPrompt",
+      "translation": "יש להתחבר כדי לשלוח הודעה."
+    },
+    "h_c559b26ddd1a": {
+      "source": "The message was rejected. Your draft is retained.",
+      "key": "businessChat.rejected",
+      "translation": "ההודעה נדחתה. הטיוטה נשמרה."
+    },
+    "h_263adf949cca": {
+      "source": "No automatic retry was made. Reopen the conversation to check whether it arrived.",
+      "key": "businessChat.checkDelivery",
+      "translation": "לא בוצע ניסיון שליחה נוסף. פתחו שוב את השיחה כדי לבדוק אם ההודעה התקבלה."
+    },
+    "h_6df910132a36": {
+      "source": "Suggestion sent.",
+      "key": "businessChat.suggestionSent",
+      "translation": "ההצעה נשלחה."
+    },
+    "h_429255ed7d01": {
+      "source": "The suggestion was rejected.",
+      "key": "businessChat.suggestionRejected",
+      "translation": "ההצעה נדחתה."
+    },
+    "h_093341bec739": {
+      "source": "Suggestion delivery is unconfirmed; it will not be sent again automatically.",
+      "key": "businessChat.suggestionUnconfirmed",
+      "translation": "לא ניתן לאשר שההצעה נמסרה; היא לא תישלח שוב באופן אוטומטי."
+    },
+    "h_74c459c38758": {
+      "source": "Product image",
+      "key": "businessChat.productImage",
+      "translation": "תמונת מוצר"
+    },
+    "h_325fcc2da726": {
+      "source": "Connecting to live updates",
+      "key": "businessChat.connecting",
+      "translation": "מתחבר לעדכונים בזמן אמת"
+    },
+    "h_c23ff9c74e73": {
+      "source": "Reconnecting live updates",
+      "key": "businessChat.reconnecting",
+      "translation": "מתחבר מחדש לעדכונים בזמן אמת"
+    },
+    "h_f4531c1fb40f": {
+      "source": "Live updates unavailable for this session",
+      "key": "businessChat.liveSessionUnavailable",
+      "translation": "עדכונים בזמן אמת אינם זמינים בחיבור זה"
+    },
+    "h_42856378cbb8": {
+      "source": "Live updates unavailable in this host",
+      "key": "businessChat.liveHostUnavailable",
+      "translation": "עדכונים בזמן אמת אינם זמינים באפליקציה זו"
+    },
+    "h_2ef475c9eed8": {
+      "source": "Live connection setup failed",
+      "key": "businessChat.liveSetupFailed",
+      "translation": "הגדרת החיבור בזמן אמת נכשלה"
+    },
+    "h_40a99786c549": {
+      "source": "Live connection authentication failed",
+      "key": "businessChat.liveAuthFailed",
+      "translation": "אימות החיבור בזמן אמת נכשל"
+    },
+    "h_e601a70aa6d5": {
+      "source": "Live connection interrupted",
+      "key": "businessChat.liveInterrupted",
+      "translation": "החיבור בזמן אמת נותק"
+    },
+    "h_4e2c6bddd5ef": {
+      "source": "Live update could not be read",
+      "key": "businessChat.liveUnreadable",
+      "translation": "לא ניתן לקרוא את העדכון בזמן אמת"
+    },
+    "h_a7ada329317d": {
+      "source": "Live updates paused",
+      "key": "businessChat.livePaused",
+      "translation": "העדכונים בזמן אמת מושהים"
+    },
+    "h_45d7c3e03a77": {
+      "source": "Live updates unavailable",
+      "key": "businessChat.liveUnavailable",
+      "translation": "עדכונים בזמן אמת אינם זמינים"
+    },
+    "h_d2de1a2831e7": {
+      "source": "Open link",
+      "key": "businessChat.openLink",
+      "translation": "פתיחת קישור"
+    },
+    "h_24345a14377f": {
+      "source": "Today",
+      "key": "businessChat.today",
+      "translation": "היום"
+    },
+    "h_da24830f1f70": {
+      "source": "Yesterday",
+      "key": "businessChat.yesterday",
+      "translation": "אתמול"
+    },
+    "h_fc7ba35433ce": {
+      "source": "AI assistant",
+      "key": "businessChat.aiAssistant",
+      "translation": "עוזר בינה מלאכותית"
+    },
+    "h_798ec37b0270": {
+      "source": "Staff Response",
+      "key": "businessChat.staffResponse",
+      "translation": "תשובת הצוות"
+    },
+    "h_4f3117c17b1a": {
+      "source": "Image attachment",
+      "key": "businessChat.imageAttachment",
+      "translation": "תמונה מצורפת"
+    },
+    "h_6733d4f14f4d": {
+      "source": "Type your message…",
+      "key": "chatThread.composerPlaceholder",
+      "translation": "כתיבת הודעה…"
+    },
+    "h_08d738ca2b26": {
+      "source": "Type your message",
+      "key": "chatThread.composerLabel",
+      "translation": "לכתוב הודעה"
+    },
+    "h_9bc2575c3930": {
+      "source": "Send",
+      "key": "chatThread.sendCta",
+      "translation": "שליחה"
+    },
+    "h_8b2c12c5d4d5": {
+      "source": "Send a message to start the conversation.",
+      "key": "chatThread.emptySubtitle",
+      "translation": "שליחת הודעה תתחיל את השיחה."
+    },
+    "h_b227f5879bde": {
+      "source": "Coupon code",
+      "key": "chatThread.couponLabel",
+      "translation": "קוד קופון"
+    },
+    "h_33ce417454bf": {
+      "source": "Loading…",
+      "key": "common.detailLoadingText",
+      "translation": "בטעינה…"
+    },
+    "h_042c862e4467": {
+      "source": "Try again",
+      "key": "common.retryCta",
+      "translation": "נסו שוב"
+    },
+    "h_ada2e9e96fa9": {
+      "source": "Sign in",
+      "key": "account.signInCta",
+      "translation": "התחברות"
+    }
+  }
+}

package/templates/branded-lite/tier5-src/_shared/business-chat-copy.ts

@@ -0,0 +1,40 @@
+// Shared defaults keep descriptor copy and worker fallbacks aligned.
+import { copyParam } from "./himi-copy.js";
+
+export const BUSINESS_CHAT_COPY = {
+  "emptyTitle": "No messages yet",
+  "sending": "Sending…",
+  "unconfirmed": "Not confirmed",
+  "sessionChanged": "Your member session changed. Sign in again to continue.",
+  "hostUnavailable": "This app host cannot reach the inbox yet.",
+  "sendFailed": "Message delivery could not be confirmed. Check the conversation before trying again.",
+  "openFailed": "Couldn’t open the conversation. Try again.",
+  "loadFailed": "Couldn’t load the conversation. Try again.",
+  "signInPrompt": "Sign in to send a message.",
+  "rejected": "The message was rejected. Your draft is retained.",
+  "checkDelivery": "No automatic retry was made. Reopen the conversation to check whether it arrived.",
+  "suggestionSent": "Suggestion sent.",
+  "suggestionRejected": "The suggestion was rejected.",
+  "suggestionUnconfirmed": "Suggestion delivery is unconfirmed; it will not be sent again automatically.",
+  "productImage": "Product image",
+  "connecting": "Connecting to live updates",
+  "reconnecting": "Reconnecting live updates",
+  "liveSessionUnavailable": "Live updates unavailable for this session",
+  "liveHostUnavailable": "Live updates unavailable in this host",
+  "liveSetupFailed": "Live connection setup failed",
+  "liveAuthFailed": "Live connection authentication failed",
+  "liveInterrupted": "Live connection interrupted",
+  "liveUnreadable": "Live update could not be read",
+  "livePaused": "Live updates paused",
+  "liveUnavailable": "Live updates unavailable",
+  "openLink": "Open link",
+  "today": "Today",
+  "yesterday": "Yesterday",
+  "aiAssistant": "AI assistant",
+  "staffResponse": "Staff Response",
+  "imageAttachment": "Image attachment"
+} as const;
+
+export function businessChatCopy(key: keyof typeof BUSINESS_CHAT_COPY): string {
+  return copyParam(`businessChat.${key}`, BUSINESS_CHAT_COPY[key]);
+}

package/templates/branded-lite/tier5-src/_shared/business-chat-message-model.ts

@@ -57,7 +57,7 @@ function media(id: string, kind: 'image' | 'file' | 'audio' | 'video', input: un
   const url = safeUrl(candidate); const mime = first(m.mimeType, m.contentType);
   const resolvedKind = kind === 'file' && /^audio\//i.test(mime) ? 'audio' : kind === 'file' && /^video\//i.test(mime) ? 'video' : kind;
   const missing = url ? '' : candidate ? 'Attachment URL is unavailable: only safe HTTPS links are supported.' : 'Attachment requires a download URL.';
-  return { ...base(id, resolvedKind, first(m.text, m.title)), url, fileName: first(m.filename, m.fileName, m.name), caption: first(m.caption, m.alt, missing, resolvedKind === 'image' ? 'Image attachment' : ''), mimeType: mime, mediaId: first(m.mediaFileId, m.id, m._id, m.fileId), mediaProvider: str(m.mediaProvider), thumbnailUrl: safeUrl(m.thumbnailUrl), urlExpiration: str(m.urlExpiration), ...(missing ? { unavailableReason: missing } : {}) };
+  return { ...base(id, resolvedKind, first(m.text, m.title)), url, fileName: first(m.filename, m.fileName, m.name), caption: first(m.caption, m.alt, missing), mimeType: mime, mediaId: first(m.mediaFileId, m.id, m._id, m.fileId), mediaProvider: str(m.mediaProvider), thumbnailUrl: safeUrl(m.thumbnailUrl), urlExpiration: str(m.urlExpiration), ...(missing ? { unavailableReason: missing } : {}) };
 }
 function buttons(value: unknown, prefix: string): MessageButton[] {
   if (!Array.isArray(value)) return [];

package/templates/branded-lite/tier5-src/_shared/business-chat-model.ts

@@ -5,8 +5,9 @@ import { mergeMessages, normalizeMessages, type MessageRow } from './business-ch
  *  time) or unconfirmed (the request failed without a definite answer). The server names the stored message, so the
  *  new one is recognised by its text, among the messages after `afterId` (the newest stored message on screen when it
  *  was sent), or among all of them when the room was loaded and empty (`fromStart`); `priorCount` is how many earlier
- *  sends with the same text were still waiting for their stored copy. */
-export interface BusinessChatIntent { id:string; text:string; roomId:string; principal:string; createdDate:string; delivery:'sending'|'sent'|'unconfirmed'; senderName?:string; storedId?:string; afterId?:string; fromStart?:boolean; priorCount?:number }
+ *  sends with the same text were still waiting for their stored copy. `smartChatFromStart` records a successful empty
+ *  Smart Chat read before sending from Members history; it selects that anchor only for accepted delivery viewed in Smart Chat history. */
+export interface BusinessChatIntent { id:string; text:string; roomId:string; principal:string; createdDate:string; delivery:'sending'|'sent'|'unconfirmed'; senderName?:string; storedId?:string; afterId?:string; fromStart?:boolean; priorCount?:number; smartChatFromStart?:boolean }
 
 export function newBusinessChatIntent(text:string,roomId:string,principal:string,random=Math.random):BusinessChatIntent{
  return {id:'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g,c=>{const r=Math.floor(random()*16);return(c==='x'?r:(r&3)|8).toString(16);}),text,roomId,principal,createdDate:new Date().toISOString(),delivery:'sending'};

package/templates/branded-lite/tier5-src/_shared/business-chat-presenter.ts

@@ -1,3 +1,4 @@
+import { businessChatCopy } from "./business-chat-copy.js";
 import { formatMonthDay } from "./engine-intl.js";
 type RecordValue = Record<string, unknown>;
 
@@ -59,16 +60,16 @@ export type BusinessRoomSummary = {
 /** Keep host capability failures visible without exposing runtime error details. */
 export function businessRealtimeStatusLabel(state: string, reason = ""): string {
   if (state === "connected") return "";
-  if (state === "connecting") return "Connecting to live updates";
-  if (state === "reconnecting") return "Reconnecting live updates";
-  if (reason === "chat_setup_scope_unavailable") return "Live updates unavailable for this session";
-  if (reason === "runtime_unavailable") return "Live updates unavailable in this host";
-  if (reason === "invalid_setup_response") return "Live connection setup failed";
-  if (reason === "firebase_auth_failed") return "Live connection authentication failed";
-  if (reason === "firebase_connection_failed") return "Live connection interrupted";
-  if (reason === "invalid_event") return "Live update could not be read";
-  if (reason === "event_overflow") return "Live updates paused";
-  return "Live updates unavailable";
+  if (state === "connecting") return businessChatCopy('connecting');
+  if (state === "reconnecting") return businessChatCopy('reconnecting');
+  if (reason === "chat_setup_scope_unavailable") return businessChatCopy('liveSessionUnavailable');
+  if (reason === "runtime_unavailable") return businessChatCopy('liveHostUnavailable');
+  if (reason === "invalid_setup_response") return businessChatCopy('liveSetupFailed');
+  if (reason === "firebase_auth_failed") return businessChatCopy('liveAuthFailed');
+  if (reason === "firebase_connection_failed") return businessChatCopy('liveInterrupted');
+  if (reason === "invalid_event") return businessChatCopy('liveUnreadable');
+  if (reason === "event_overflow") return businessChatCopy('livePaused');
+  return businessChatCopy('liveUnavailable');
 }
 
 const object = (value: unknown): RecordValue =>
@@ -76,7 +77,7 @@ const object = (value: unknown): RecordValue =>
 
 /** Return a sole existing two-party business room, or a unique business-name match among several;
  * never create a room or guess among remaining matches. */
-export function selectExistingBusinessRoom(rooms: unknown[], businessName?: string): { id: string; participantId: string } | undefined {
+export function selectExistingBusinessRoom(rooms: unknown[], businessName?: string, requireUnambiguous = false): { id: string; participantId: string } | undefined {
   let candidates = rooms.filter((value) => {
     const room = object(value);
     return typeof room.id === "string" && !!room.id &&
@@ -84,7 +85,8 @@ export function selectExistingBusinessRoom(rooms: unknown[], businessName?: stri
       room.participantCount === 2 && room.clientReferenceType === "contactId" &&
       Object.keys(object(room.businessContext)).length > 0;
   });
-  if (candidates.length > 1 && businessName?.trim()) {
+  const candidateCount = candidates.length;
+  if (candidateCount > 1 && businessName?.trim()) {
     // Keep case significant so differently named businesses are not conflated.
     const name = businessName.trim();
     candidates = candidates.filter((value) => {
@@ -92,7 +94,10 @@ export function selectExistingBusinessRoom(rooms: unknown[], businessName?: stri
       return typeof roomName === "string" && roomName.trim() === name;
     });
   }
-  if (candidates.length !== 1) return undefined;
+  if (candidates.length !== 1) {
+    if (requireUnambiguous && candidateCount > 1) throw new Error("business_room_selection_ambiguous");
+    return undefined;
+  }
   const room = object(candidates[0]);
   return { id: room.id as string, participantId: room.participantId as string };
 }
@@ -163,7 +168,7 @@ export function businessVisitorOptionSuggestions(options: BusinessVisitorOptions
 /** Wix Chat realtime currently sends `{type, timestamp, summary, message?}` events. */
 export function isBusinessMessageEvent(envelope: unknown, roomId: string, smartChat = false): boolean {
   const event = object(object(envelope).event);
-  if (!roomId || typeof event.type !== "string" || !/^(message|messagesent)$/i.test(event.type)) return false;
+  if ((!roomId && !smartChat) || typeof event.type !== "string" || !/^(message|messagesent)$/i.test(event.type)) return false;
   const message = object(event.message);
   const data = object(event.data);
   const nested = object(data.message);
@@ -180,7 +185,7 @@ export function shouldRefreshBusinessHistory(
   session: { member: boolean; principal: string; currentPrincipal: string; scope: string; currentScope: string },
   smartChat = false,
 ): boolean {
-  return !!session.member && !!roomId && !!session.principal && session.principal === session.currentPrincipal &&
+  return !!session.member && (!!roomId || smartChat) && !!session.principal && session.principal === session.currentPrincipal &&
     session.scope === session.currentScope && isBusinessMessageEvent(envelope, roomId, smartChat);
 }
 
@@ -364,7 +369,7 @@ export function extractBusinessMessageExtras(markdown: string, options: { liftCo
   // True only when a button was really added: a repeated link, or one past the sixth, stays in the text.
   const addLink = (label: string, url: string): boolean => {
     if (links.length >= 6 || links.some((link) => link.url === url)) return false;
-    links.push({ label: label.replace(/[*_`]/g, "").trim().slice(0, 40) || "Open link", url });
+    links.push({ label: label.replace(/[*_`]/g, "").trim().slice(0, 40) || businessChatCopy('openLink'), url });
     return true;
   };
   for (const line of markdown.split("\n")) {
@@ -454,7 +459,7 @@ export function presentBusinessMessages<T extends Pick<BusinessMessage, "id" | "
     const key = Number.isFinite(timestamp.getTime()) ? dateKey(timestamp) : "";
     const startsDay = !!key && key !== previousDay;
     const dayLabel = startsDay
-      ? key === today ? "Today" : key === yesterdayKey ? "Yesterday" : formatMonthDay(timestamp)
+      ? key === today ? businessChatCopy('today') : key === yesterdayKey ? businessChatCopy('yesterday') : formatMonthDay(timestamp)
       : "";
     if (key) previousDay = key;
 
@@ -523,10 +528,10 @@ export function presentBusinessMessages<T extends Pick<BusinessMessage, "id" | "
       senderAvatar,
       senderName,
       senderInitials: typeof display.initials === "string" && display.initials.trim() ? display.initials.trim() : initials(senderName),
-      senderBadge: participantId && !mine ? isAiGenerated ? "AI assistant" : "Staff Response" : "",
+      senderBadge: participantId && !mine ? isAiGenerated ? businessChatCopy('aiAssistant') : businessChatCopy('staffResponse') : "",
       imageUrl,
       // A card's own picture is named by the card (a product's name), not as an anonymous attachment.
-      imageDescription: imagePart?.caption || (imageUrl && !imagePart?.url && first ? first.replace(/\*/g, "") : "Image attachment"),
+      imageDescription: imagePart?.caption || (imageUrl && !imagePart?.url && first ? first.replace(/\*/g, "") : businessChatCopy('imageAttachment')),
       noImage: !imageUrl,
       bodyText,
       bodyRuns,
@@ -568,9 +573,9 @@ export async function dispatchBusinessSuggestion<T extends { suggestions?: Busin
   session: { member: boolean; roomId: string; principal: string; currentPrincipal: string; scope: string; currentScope: string },
   submit: (suggestion: BusinessSuggestion) => Promise<unknown>,
 ): Promise<boolean> {
-  if (!session.member || !session.roomId || !session.principal || session.principal !== session.currentPrincipal || session.scope !== session.currentScope) return false;
+  if (!session.member || !session.principal || session.principal !== session.currentPrincipal || session.scope !== session.currentScope) return false;
   const suggestion = findBusinessSuggestion(rows, suggestionId);
-  if (!suggestion) return false;
+  if (!suggestion || (suggestion.kind === "postback" && !session.roomId)) return false;
   // A submit that reports `false` (a stale quick reply nobody posted) is not a send.
   return (await submit(suggestion)) !== false;
 }

package/templates/branded-lite/tier5-src/_shared/exclusive-writes.ts

@@ -0,0 +1,66 @@
+import { defineService as register, type ServiceDefinition } from '@himalaya/state';
+
+/** Reject repeated taps until the accepted write's result is committed. A promise
+ * queue alone releases before the host applies the reducer result, so the next
+ * write can still read an old revision/id. The private synchronous reducer below
+ * publishes busy and commits completion through the ordinary service handle;
+ * awaiting that handle guarantees the host has stored the result before unlock.
+ * Skipped actions return undefined, so they cannot roll back the accepted write.
+ */
+export function withExclusiveWrites<S extends object = Record<string, unknown>>(
+  registerService: typeof register, names: readonly string[],
+  options: { prepare?: (action: string, args: readonly unknown[]) => void; coalesce?: readonly string[]; settle?: (before: S, next: S, live: S) => S } = {},
+): typeof register {
+  return ((name: string, definition: ServiceDefinition<Record<string, unknown>>) => {
+    let busy = false;
+    let activeAction = "";
+    let completion = Promise.resolve();
+    let complete = () => {};
+    let handle: { getState(): Record<string, unknown>; exclusiveWriteState(next: Record<string, unknown>): Promise<unknown> };
+    const wrapped: ServiceDefinition<Record<string, unknown>> = {
+      ...definition,
+      state: { ...definition.state, writeBusy: false },
+      notHydrated: [...(definition.notHydrated ?? []), 'writeBusy'],
+      actions: {
+        ...Object.fromEntries(Object.entries(definition.actions ?? {}).map(([action, reduce]) => [action,
+          names.includes(action) ? async (state: Record<string, unknown>, ...args: never[]) => {
+            // Intake request metadata even when its state replacement is skipped.
+            options.prepare?.(action, args);
+            if (busy) {
+              // Repeated initial loads must await the accepted load, so callers
+              // observe its committed rows rather than the initial skeleton.
+              if (activeAction === action && options.coalesce?.includes(action)) await completion;
+              return;
+            }
+            busy = true;
+            activeAction = action;
+            completion = new Promise<void>(resolve => { complete = resolve; });
+            try {
+              await handle.exclusiveWriteState({ ...handle.getState(), writeBusy: true });
+              const next = await reduce(state, ...args);
+              const live = handle.getState();
+              // Non-write actions (for example editing a draft field) can still run
+              // during I/O. Let the owning service preserve those newer edits.
+              const settled = options.settle ? options.settle(state as S, (next ?? live) as S, live as S) : next ?? live;
+              await handle.exclusiveWriteState({ ...settled, writeBusy: false });
+            } catch (error) {
+              await handle.exclusiveWriteState({ ...handle.getState(), writeBusy: false });
+              throw error;
+            } finally {
+              busy = false;
+              complete();
+            }
+          } : reduce,
+        ])),
+        exclusiveWriteState: (_state, next: Record<string, unknown>) => next,
+      },
+    };
+    const registered = registerService(name, wrapped);
+    // Registration preserves this private action, but the dynamic action map
+    // cannot express its payload to the generic service handle.
+    handle = registered as unknown as typeof handle;
+    // Older hosts ignore notHydrated. A fresh worker has no pending write.
+    handle.getState().writeBusy = false;
+    return registered;
+  }) as typeof register;
+}