@helpai/elements 0.16.0 → 0.17.0

package/index.d.ts

@@ -1,4 +1,4 @@
-export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, L as Link, S as ServerConfig, b as SiteConfig, c as StartConversationResponse, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial } from './deployment-DvzmRV7E.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, L as Link, S as ServerConfig, b as SiteConfig, c as StartConversationResponse, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial } from './deployment-BvNoqfIC.js';
 import 'zod';
 
 /**
@@ -141,11 +141,13 @@ interface WireMessage {
     role: "user" | "assistant" | "system";
     parts: WirePart[];
     /**
-     * Epoch milliseconds the message was created. Optional so older backends
-     * still parse; when present, the widget shows the real send time (and groups
-     * messages by day) on reload instead of falling back to "now".
+     * ISO-8601 timestamp the message was created (a serialized Mongo ISODate,
+     * e.g. `2026-06-10T07:50:55.816Z`) — every wire date uses this format.
+     * Optional so older backends still parse; when present, the widget shows
+     * the real send time (and groups messages by day) on reload instead of
+     * falling back to "now". Parse with {@link parseWireDate}.
      */
-    createdAt?: number;
+    createdAt?: string;
 }
 type WirePart = {
     type: "text";
@@ -190,8 +192,8 @@ interface FormSubmissionRecord {
     trigger: string;
     /** True when the visitor skipped instead of answering. */
     skipped?: boolean;
-    /** Epoch ms — same clock + name as {@link WireMessage.createdAt}. */
-    createdAt?: number;
+    /** ISO-8601 — same format + name as {@link WireMessage.createdAt}. */
+    createdAt?: string;
 }
 /** One-shot bot persona shown in the panel header. */
 interface ConversationAgent {

package/index.mjs

@@ -1214,6 +1214,11 @@ function encodeContext(user, page) {
 }
 
 // src/stream/protocol.ts
+function parseWireDate(value) {
+  if (!value) return void 0;
+  const ms = Date.parse(value);
+  return Number.isFinite(ms) ? ms : void 0;
+}
 var DEFAULT_PATHS = {
   /** Conversation bootstrap. `POST` → deployment config + per-visitor state. */
   startConversation: "/ai/agent/start-conversation",
@@ -1263,7 +1268,8 @@ function buildSendMessageRequest(params) {
     id: m.id,
     parts: messageToWireParts(m),
     role: m.role,
-    createdAt: m.createdAt
+    // Internal clock is epoch ms; the wire speaks ISO-8601 (Mongo ISODate).
+    createdAt: m.createdAt !== void 0 ? new Date(m.createdAt).toISOString() : void 0
   }));
   const body = {
     messages: wire,
@@ -1912,7 +1918,7 @@ function fromWireMessage(w) {
     role: w.role,
     // Real send time when the backend provides it; otherwise fall back to now
     // (older backends) so the timestamp + day divider still render.
-    createdAt: w.createdAt ?? Date.now(),
+    createdAt: parseWireDate(w.createdAt) ?? Date.now(),
     status: "complete",
     partsSig: signal(parts)
   };
@@ -6464,7 +6470,7 @@ function App({ options, hostElement, bus }) {
               key: `wire:${rec.formId}:${rec.createdAt ?? i}`,
               formId: rec.formId,
               outcome: rec.skipped ? "skipped" : "submitted",
-              createdAt: rec.createdAt
+              createdAt: parseWireDate(rec.createdAt)
             }))
           );
           const tail = resumeBubbleRef.current ? [resumeBubbleRef.current] : [];

package/package.json

@@ -80,5 +80,5 @@
   ],
   "type": "module",
   "types": "./index.d.ts",
-  "version": "0.16.0"
+  "version": "0.17.0"
 }

package/schema.d.ts

@@ -1,4 +1,4 @@
-export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, E as Endpoints, L as Link, P as PAGE_AREA_SUGGESTIONS, g as PageContext, S as ServerConfig, b as SiteConfig, c as StartConversationResponse, U as UserContext, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial, h as assetSchema, i as blocksConfigSchema, j as connectionConfigPartialSchema, k as connectionConfigSchema, l as cssColorSchema, m as cssLengthSchema, n as endpointsSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, t as startConversationResponseSchema, u as userContextSchema, v as uuid7Schema, w as widgetConfigPartialSchema, x as widgetConfigSchema, y as widgetSettingsPartialSchema, z as widgetSettingsSchema } from './deployment-DvzmRV7E.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, E as Endpoints, L as Link, P as PAGE_AREA_SUGGESTIONS, g as PageContext, S as ServerConfig, b as SiteConfig, c as StartConversationResponse, U as UserContext, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial, h as assetSchema, i as blocksConfigSchema, j as connectionConfigPartialSchema, k as connectionConfigSchema, l as cssColorSchema, m as cssLengthSchema, n as endpointsSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, t as startConversationResponseSchema, u as userContextSchema, v as uuid7Schema, w as widgetConfigPartialSchema, x as widgetConfigSchema, y as widgetSettingsPartialSchema, z as widgetSettingsSchema } from './deployment-BvNoqfIC.js';
 import { z } from 'zod';
 
 /**
@@ -56,9 +56,9 @@ declare const presentationSchema: z.ZodObject<{
         inset: z.ZodOptional<z.ZodString>;
         initialSize: z.ZodDefault<z.ZodEnum<{
             fullscreen: "fullscreen";
-            normal: "normal";
             expanded: "expanded";
             auto: "auto";
+            normal: "normal";
         }>>;
         autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
     }, z.core.$loose>>;
@@ -148,9 +148,9 @@ declare const launcherSizeSchema: z.ZodEnum<{
 }>;
 type LauncherSize = z.infer<typeof launcherSizeSchema>;
 declare const calloutShapeSchema: z.ZodEnum<{
+    callout: "callout";
     pill: "pill";
     bubble: "bubble";
-    callout: "callout";
 }>;
 type CalloutShape = z.infer<typeof calloutShapeSchema>;
 declare const calloutPositionSchema: z.ZodEnum<{
@@ -162,9 +162,9 @@ type CalloutPosition = z.infer<typeof calloutPositionSchema>;
 declare const launcherCalloutSchema: z.ZodObject<{
     text: z.ZodDefault<z.ZodString>;
     shape: z.ZodDefault<z.ZodEnum<{
+        callout: "callout";
         pill: "pill";
         bubble: "bubble";
-        callout: "callout";
     }>>;
     position: z.ZodDefault<z.ZodEnum<{
         auto: "auto";
@@ -195,9 +195,9 @@ declare const launcherOptionsSchema: z.ZodObject<{
     callout: z.ZodOptional<z.ZodObject<{
         text: z.ZodDefault<z.ZodString>;
         shape: z.ZodDefault<z.ZodEnum<{
+            callout: "callout";
             pill: "pill";
             bubble: "bubble";
-            callout: "callout";
         }>>;
         position: z.ZodDefault<z.ZodEnum<{
             auto: "auto";
@@ -240,9 +240,9 @@ type LauncherOptions = z.infer<typeof launcherOptionsSchema>;
 
 declare const initialSizeSchema: z.ZodEnum<{
     fullscreen: "fullscreen";
-    normal: "normal";
     expanded: "expanded";
     auto: "auto";
+    normal: "normal";
 }>;
 declare const resizeOptionsSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
@@ -269,9 +269,9 @@ declare const sizeOptionsSchema: z.ZodObject<{
     inset: z.ZodOptional<z.ZodString>;
     initialSize: z.ZodDefault<z.ZodEnum<{
         fullscreen: "fullscreen";
-        normal: "normal";
         expanded: "expanded";
         auto: "auto";
+        normal: "normal";
     }>>;
     autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
 }, z.core.$loose>;
@@ -323,43 +323,43 @@ type FeatureFlags = z.infer<typeof featureFlagsSchema>;
  */
 
 declare const actionNameSchema: z.ZodEnum<{
+    close: "close";
     expand: "expand";
     fullscreen: "fullscreen";
     popOut: "popOut";
-    close: "close";
-    language: "language";
+    clear: "clear";
     theme: "theme";
+    language: "language";
     textSize: "textSize";
     history: "history";
-    clear: "clear";
     sound: "sound";
 }>;
 type ActionName = z.infer<typeof actionNameSchema>;
 declare const headerActionsSchema: z.ZodArray<z.ZodEnum<{
+    close: "close";
     expand: "expand";
     fullscreen: "fullscreen";
     popOut: "popOut";
-    close: "close";
-    language: "language";
+    clear: "clear";
     theme: "theme";
+    language: "language";
     textSize: "textSize";
     history: "history";
-    clear: "clear";
     sound: "sound";
 }>>;
 type HeaderActions = z.infer<typeof headerActionsSchema>;
 /** Section wrapper — `actions` list wrapped under `header` in the dashboard form. */
 declare const headerSchema: z.ZodObject<{
     actions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        close: "close";
         expand: "expand";
         fullscreen: "fullscreen";
         popOut: "popOut";
-        close: "close";
-        language: "language";
+        clear: "clear";
         theme: "theme";
+        language: "language";
         textSize: "textSize";
         history: "history";
-        clear: "clear";
         sound: "sound";
     }>>>;
 }, z.core.$loose>;
@@ -375,33 +375,33 @@ type HeaderOptions = z.infer<typeof headerSchema>;
  */
 
 declare const feedbackEventSchema: z.ZodEnum<{
+    voiceStart: "voiceStart";
+    voiceStop: "voiceStop";
     error: "error";
     messageReceived: "messageReceived";
     messageSent: "messageSent";
-    voiceStart: "voiceStart";
-    voiceStop: "voiceStop";
 }>;
 type FeedbackEvent = z.infer<typeof feedbackEventSchema>;
 declare const soundOptionsSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     volume: z.ZodDefault<z.ZodNumber>;
     events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
         error: "error";
         messageReceived: "messageReceived";
         messageSent: "messageSent";
-        voiceStart: "voiceStart";
-        voiceStop: "voiceStop";
     }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
 }, z.core.$loose>;
 type SoundOptions = z.infer<typeof soundOptionsSchema>;
 declare const hapticsOptionsSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
         error: "error";
         messageReceived: "messageReceived";
         messageSent: "messageSent";
-        voiceStart: "voiceStart";
-        voiceStop: "voiceStop";
     }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodNumber>]>>>;
 }, z.core.$loose>;
 type HapticsOptions = z.infer<typeof hapticsOptionsSchema>;
@@ -410,21 +410,21 @@ declare const feedbackSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         volume: z.ZodDefault<z.ZodNumber>;
         events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            voiceStart: "voiceStart";
+            voiceStop: "voiceStop";
             error: "error";
             messageReceived: "messageReceived";
             messageSent: "messageSent";
-            voiceStart: "voiceStart";
-            voiceStop: "voiceStop";
         }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
     }, z.core.$loose>>;
     haptics: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            voiceStart: "voiceStart";
+            voiceStop: "voiceStop";
             error: "error";
             messageReceived: "messageReceived";
             messageSent: "messageSent";
-            voiceStart: "voiceStart";
-            voiceStop: "voiceStop";
         }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodNumber>]>>>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
@@ -565,16 +565,16 @@ type FooterOptions = z.infer<typeof footerSchema>;
 
 declare const fieldTypeSchema: z.ZodEnum<{
     number: "number";
+    select: "select";
+    textarea: "textarea";
+    time: "time";
     text: "text";
+    checkbox: "checkbox";
+    radio: "radio";
     url: "url";
     email: "email";
     tel: "tel";
     date: "date";
-    time: "time";
-    textarea: "textarea";
-    select: "select";
-    radio: "radio";
-    checkbox: "checkbox";
     multiselect: "multiselect";
 }>;
 type FieldType = z.infer<typeof fieldTypeSchema>;
@@ -599,16 +599,16 @@ declare const formFieldSchema: z.ZodObject<{
     label: z.ZodString;
     type: z.ZodEnum<{
         number: "number";
+        select: "select";
+        textarea: "textarea";
+        time: "time";
         text: "text";
+        checkbox: "checkbox";
+        radio: "radio";
         url: "url";
         email: "email";
         tel: "tel";
         date: "date";
-        time: "time";
-        textarea: "textarea";
-        select: "select";
-        radio: "radio";
-        checkbox: "checkbox";
         multiselect: "multiselect";
     }>;
     placeholder: z.ZodOptional<z.ZodString>;
@@ -659,16 +659,16 @@ declare const formDefSchema: z.ZodObject<{
         label: z.ZodString;
         type: z.ZodEnum<{
             number: "number";
+            select: "select";
+            textarea: "textarea";
+            time: "time";
             text: "text";
+            checkbox: "checkbox";
+            radio: "radio";
             url: "url";
             email: "email";
             tel: "tel";
             date: "date";
-            time: "time";
-            textarea: "textarea";
-            select: "select";
-            radio: "radio";
-            checkbox: "checkbox";
             multiselect: "multiselect";
         }>;
         placeholder: z.ZodOptional<z.ZodString>;
@@ -717,16 +717,16 @@ declare const formsSchema: z.ZodArray<z.ZodObject<{
         label: z.ZodString;
         type: z.ZodEnum<{
             number: "number";
+            select: "select";
+            textarea: "textarea";
+            time: "time";
             text: "text";
+            checkbox: "checkbox";
+            radio: "radio";
             url: "url";
             email: "email";
             tel: "tel";
             date: "date";
-            time: "time";
-            textarea: "textarea";
-            select: "select";
-            radio: "radio";
-            checkbox: "checkbox";
             multiselect: "multiselect";
         }>;
         placeholder: z.ZodOptional<z.ZodString>;
@@ -798,18 +798,18 @@ type I18nOptions = z.infer<typeof i18nSchema>;
  */
 
 declare const moduleLayoutSchema: z.ZodEnum<{
+    home: "home";
     chat: "chat";
     help: "help";
-    home: "home";
     news: "news";
 }>;
 type ModuleLayout = z.infer<typeof moduleLayoutSchema>;
 declare const moduleSchema: z.ZodObject<{
     label: z.ZodString;
     layout: z.ZodEnum<{
+        home: "home";
         chat: "chat";
         help: "help";
-        home: "home";
         news: "news";
     }>;
     contentTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -835,9 +835,9 @@ type ModuleOptions = z.infer<typeof moduleSchema>;
 declare const modulesSchema: z.ZodArray<z.ZodObject<{
     label: z.ZodString;
     layout: z.ZodEnum<{
+        home: "home";
         chat: "chat";
         help: "help";
-        home: "home";
         news: "news";
     }>;
     contentTags: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/schema.json

@@ -3867,7 +3867,9 @@
                 "type": "boolean"
               },
               "createdAt": {
-                "type": "number"
+                "type": "string",
+                "format": "date-time",
+                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
               }
             },
             "required": [

package/schema.mjs

@@ -775,15 +775,15 @@ var startConversationResponseSchema = z17.object({
   /**
    * Form submissions recorded for this conversation — echoed like
    * `messages` so the widget reconstructs the collapsed "form submitted"
-   * timeline markers on resume. `createdAt` is epoch ms (same clock as
-   * message `createdAt`).
+   * timeline markers on resume. `createdAt` is ISO-8601 (a serialized
+   * Mongo ISODate — same format as message `createdAt`).
    */
   formSubmissions: z17.array(
     z17.object({
       formId: z17.string(),
       trigger: z17.string(),
       skipped: z17.boolean().optional(),
-      createdAt: z17.number().optional()
+      createdAt: z17.iso.datetime().optional()
     }).loose()
   ).optional(),
   /**

package/web-component.mjs

@@ -1269,6 +1269,11 @@ function encodeContext(user, page) {
 }
 
 // src/stream/protocol.ts
+function parseWireDate(value) {
+  if (!value) return void 0;
+  const ms = Date.parse(value);
+  return Number.isFinite(ms) ? ms : void 0;
+}
 var DEFAULT_PATHS = {
   /** Conversation bootstrap. `POST` → deployment config + per-visitor state. */
   startConversation: "/ai/agent/start-conversation",
@@ -1318,7 +1323,8 @@ function buildSendMessageRequest(params) {
     id: m.id,
     parts: messageToWireParts(m),
     role: m.role,
-    createdAt: m.createdAt
+    // Internal clock is epoch ms; the wire speaks ISO-8601 (Mongo ISODate).
+    createdAt: m.createdAt !== void 0 ? new Date(m.createdAt).toISOString() : void 0
   }));
   const body = {
     messages: wire,
@@ -1967,7 +1973,7 @@ function fromWireMessage(w) {
     role: w.role,
     // Real send time when the backend provides it; otherwise fall back to now
     // (older backends) so the timestamp + day divider still render.
-    createdAt: w.createdAt ?? Date.now(),
+    createdAt: parseWireDate(w.createdAt) ?? Date.now(),
     status: "complete",
     partsSig: signal(parts)
   };
@@ -6519,7 +6525,7 @@ function App({ options, hostElement, bus }) {
               key: `wire:${rec.formId}:${rec.createdAt ?? i}`,
               formId: rec.formId,
               outcome: rec.skipped ? "skipped" : "submitted",
-              createdAt: rec.createdAt
+              createdAt: parseWireDate(rec.createdAt)
             }))
           );
           const tail = resumeBubbleRef.current ? [resumeBubbleRef.current] : [];