@amplifyup/sdk 0.1.25 → 0.1.27

package/dist/react.mjs

@@ -1,5 +1,5 @@
 'use client';
-import { createContext, useState, useEffect, useContext, Fragment as Fragment$1, Component } from 'react';
+import { createContext, useState, useEffect, useContext, Fragment as Fragment$1, useRef, Component } from 'react';
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
 import { marked } from 'marked';
 
@@ -58,7 +58,10 @@ var AWSAdapter = class {
         headers: {
           "Content-Type": "application/json"
         },
-        body: JSON.stringify(eventData)
+        body: JSON.stringify(eventData),
+        // Keep the request alive through tab close so the single Time on Page
+        // flush on pagehide is not cancelled with the document.
+        keepalive: true
       });
       if (!response.ok) {
         if (this.config.debug) {
@@ -517,8 +520,6 @@ async function fetchContent(options) {
 
 // src/index.ts
 var SESSION_IDLE_GAP_MS = 30 * 60 * 1e3;
-var DWELL_MILESTONES_SEC = [15, 30, 60, 120, 300];
-var DWELL_CHECKPOINT_SEC = 15 * 60;
 var DWELL_ACTIVITY_IDLE_MS = 2 * 60 * 1e3;
 var DWELL_POLL_MS = 5e3;
 function readPreviewQueryOverrides() {
@@ -589,7 +590,8 @@ var AmplifyUpSDK = class {
       reached: /* @__PURE__ */ new Set(),
       visibleMs: 0,
       visibleSince: null,
-      lastDwellSecondsSent: 0,
+      /** True after Time on Page has been sent for the current visit. */
+      dwellEmitted: false,
       /** When the tab last became hidden — used for idle-resume re-page. */
       hiddenAt: null,
       /** Last user interaction — freezes dwell when stale while visible. */
@@ -818,9 +820,9 @@ var AmplifyUpSDK = class {
   }
   /**
    * Automatic page-level Scroll Depth + Time on Page.
-   * Dwell uses milestones / sparse checkpoints (not a fixed 15s heartbeat),
-   * freezes while the tab is visible but the user is idle, and always flushes
-   * on hide / unload / SPA route change.
+   * Time on Page fires once per visit when the visit ends (route change,
+   * tab close, or 30-minute idle resume). Hidden tabs pause the clock;
+   * visible-but-idle tabs freeze after DWELL_ACTIVITY_IDLE_MS.
    */
   setupPageEngagement() {
     if (typeof window === "undefined" || typeof document === "undefined") return;
@@ -831,7 +833,7 @@ var AmplifyUpSDK = class {
     state.reached = /* @__PURE__ */ new Set();
     state.visibleMs = 0;
     state.visibleSince = document.visibilityState === "visible" ? Date.now() : null;
-    state.lastDwellSecondsSent = 0;
+    state.dwellEmitted = false;
     state.hiddenAt = document.visibilityState === "hidden" ? Date.now() : null;
     state.lastActivityAt = Date.now();
     state.activityIdle = false;
@@ -893,48 +895,34 @@ var AmplifyUpSDK = class {
         }
       }
     };
-    const nextEmitTarget = (lastSent) => {
-      for (const m of DWELL_MILESTONES_SEC) {
-        if (m > lastSent) return { seconds: m, reason: "milestone" };
-      }
-      const nextCheckpoint = Math.floor(lastSent / DWELL_CHECKPOINT_SEC) * DWELL_CHECKPOINT_SEC + DWELL_CHECKPOINT_SEC;
-      const target = nextCheckpoint > lastSent ? nextCheckpoint : lastSent + DWELL_CHECKPOINT_SEC;
-      return { seconds: target, reason: "checkpoint" };
-    };
-    const emitDwell = (reason, force = false) => {
+    const emitDwell = (reason) => {
       if (this.isPreviewMode()) return;
+      if (state.dwellEmitted) return;
       if (!state.activityIdle) {
         accumulateVisible();
       }
       const seconds = Math.floor(state.visibleMs / 1e3);
       if (seconds <= 0) return;
-      if (seconds <= state.lastDwellSecondsSent) return;
-      if (!force) {
-        const target = nextEmitTarget(state.lastDwellSecondsSent);
-        if (!target || seconds < target.seconds) return;
-        reason = target.reason;
-      }
-      state.lastDwellSecondsSent = seconds;
+      state.dwellEmitted = true;
       this.track("Time on Page", {
         seconds,
         path: this.lastTrackedPath || path(),
         reason
       });
     };
-    const evaluateDwell = () => {
+    const evaluateIdle = () => {
       if (document.visibilityState !== "visible") return;
       if (Date.now() - state.lastActivityAt >= DWELL_ACTIVITY_IDLE_MS) {
         freezeActivityIdle();
-        return;
       }
-      emitDwell("milestone", false);
     };
-    this._emitPageDwell = (force) => emitDwell("route", force !== false);
+    this._emitPageDwell = () => emitDwell("route");
     const onVisibility = () => {
       if (document.visibilityState === "visible") {
         const idleMs = state.hiddenAt != null ? Date.now() - state.hiddenAt : 0;
         state.hiddenAt = null;
         if (idleMs >= SESSION_IDLE_GAP_MS) {
+          emitDwell("idle-resume");
           this.resetEngagementQuiet();
           const resumePath = path();
           this.page(resumePath, { resumed: true });
@@ -951,14 +939,14 @@ var AmplifyUpSDK = class {
         state.visibleSince = Date.now();
         state.activityIdle = false;
       } else {
-        emitDwell("hidden", true);
+        accumulateVisible();
         state.hiddenAt = Date.now();
         state.visibleSince = null;
         state.activityIdle = false;
       }
     };
     const onPageHide = () => {
-      emitDwell("unload", true);
+      emitDwell("unload");
       if (state.hiddenAt == null) {
         state.hiddenAt = Date.now();
       }
@@ -979,10 +967,10 @@ var AmplifyUpSDK = class {
       window.addEventListener(evt, onActivity, { passive: true });
     }
     checkScroll();
-    const heartbeat = setInterval(() => {
-      evaluateDwell();
+    const idlePoll = setInterval(() => {
+      evaluateIdle();
     }, DWELL_POLL_MS);
-    this.trackingIntervals.push(heartbeat);
+    this.trackingIntervals.push(idlePoll);
     const previousCleanup = this.trackingCleanup;
     this.trackingCleanup = () => {
       window.removeEventListener("scroll", onScroll);
@@ -1010,12 +998,12 @@ var AmplifyUpSDK = class {
     emit?.(true);
     this.resetEngagementQuiet();
   }
-  /** Reset dwell/scroll state without emitting (idle resume already flushed on hide). */
+  /** Reset dwell/scroll state without emitting (idle resume already flushed). */
   resetEngagementQuiet() {
     const state = this.pageEngagementState;
     state.reached = /* @__PURE__ */ new Set();
     state.visibleMs = 0;
-    state.lastDwellSecondsSent = 0;
+    state.dwellEmitted = false;
     state.hiddenAt = null;
     state.lastActivityAt = Date.now();
     state.activityIdle = false;
@@ -1793,6 +1781,12 @@ Available Console Commands:
         return;
       }
       try {
+        if (event.data?.type === "AMPLIFYUP_FIELD_PATCH") {
+          window.dispatchEvent(
+            new CustomEvent("amplifyup:field-patch", { detail: event.data })
+          );
+          return;
+        }
         if (event.data?.type === "COMPONENT_DELETABLE_STATUS") {
           const { componentId, deletable, nodeId } = event.data;
           const element = document.querySelector(`[data-component-id="${componentId}"]`);
@@ -1979,6 +1973,10 @@ Available Console Commands:
   setEventSelectionMode(enabled) {
     if (typeof document === "undefined") return;
     this.eventSelectionMode = enabled;
+    if (typeof window !== "undefined") {
+      window.__AMPLIFYUP_EVENT_SELECTION__ = enabled;
+      window.dispatchEvent(new CustomEvent("amplifyup:composer-edit"));
+    }
     if (this.eventSelectionClickHandler) {
       document.removeEventListener("click", this.eventSelectionClickHandler, true);
       this.eventSelectionClickHandler = null;
@@ -2216,6 +2214,14 @@ Available Console Commands:
         el.classList.add("amplifyup-selected");
       }
     });
+    if (typeof window !== "undefined") {
+      window.__AMPLIFYUP_COMPOSER_EDIT__ = highlightComponents;
+      window.dispatchEvent(
+        new CustomEvent("amplifyup:composer-edit", {
+          detail: { enabled: highlightComponents }
+        })
+      );
+    }
   }
   /** Document-level drag/drop for cross-iframe drags from Composer sidebar. */
   setupComposerDragDrop() {
@@ -2524,6 +2530,12 @@ Available Console Commands:
     const clearSelection = opts?.clearSelection !== false;
     this.highlightingEnabled = false;
     this.teardownComposerDragDrop();
+    if (opts?.clearSelection !== false && typeof window !== "undefined") {
+      window.__AMPLIFYUP_COMPOSER_EDIT__ = false;
+      window.dispatchEvent(
+        new CustomEvent("amplifyup:composer-edit", { detail: { enabled: false } })
+      );
+    }
     if (this.mutationObserver) {
       this.mutationObserver.disconnect();
       this.mutationObserver = null;
@@ -3391,6 +3403,152 @@ function Slot({
     }
   );
 }
+function isComposerEditMode() {
+  if (typeof window === "undefined") return false;
+  return isComposerPreview() && window.__AMPLIFYUP_COMPOSER_EDIT__ === true && window.__AMPLIFYUP_EVENT_SELECTION__ !== true;
+}
+function isLikelyNonTextFieldName(name) {
+  const n = name.toLowerCase();
+  return n.includes("href") || n.includes("url") || n.includes("src") || n.includes("image") || n.includes("icon") || n.includes("overlay") || n.includes("color");
+}
+function canInlineEdit(name, value) {
+  if (isLikelyNonTextFieldName(name)) return false;
+  if (value !== void 0 && value !== null && typeof value === "object") {
+    return false;
+  }
+  if (typeof value === "boolean") return false;
+  return true;
+}
+function useComposerEditMode() {
+  const [enabled, setEnabled] = useState(false);
+  useEffect(() => {
+    const sync = () => setEnabled(isComposerEditMode());
+    sync();
+    window.addEventListener("amplifyup:composer-edit", sync);
+    return () => window.removeEventListener("amplifyup:composer-edit", sync);
+  }, []);
+  return enabled;
+}
+function useFieldOverlay(layoutNodeId, name, source) {
+  const [overlay, setOverlay] = useState(void 0);
+  useEffect(() => {
+    const onPatch = (event) => {
+      const detail = event.detail || {};
+      if (detail.fieldName !== name) return;
+      if (detail.layoutNodeId && layoutNodeId && String(detail.layoutNodeId) !== String(layoutNodeId)) {
+        return;
+      }
+      setOverlay(detail.value);
+    };
+    window.addEventListener("amplifyup:field-patch", onPatch);
+    return () => window.removeEventListener("amplifyup:field-patch", onPatch);
+  }, [layoutNodeId, name]);
+  return overlay !== void 0 ? overlay : source;
+}
+function commitComposerField(layoutNodeId, componentId, name, value) {
+  if (typeof window === "undefined" || window.parent === window) return;
+  window.parent.postMessage(
+    {
+      type: "AMPLIFYUP_FIELD_COMMIT",
+      layoutNodeId,
+      componentId,
+      fieldName: name,
+      value
+    },
+    "*"
+  );
+}
+function ComposerInlineField({
+  name,
+  value,
+  fallback,
+  className,
+  render,
+  layoutNodeId,
+  componentId
+}) {
+  const [editing, setEditing] = useState(false);
+  const elRef = useRef(null);
+  const text = formatFieldValue(value);
+  const fallbackText = typeof fallback === "string" || typeof fallback === "number" ? String(fallback) : "";
+  const display = text || fallbackText;
+  const showRendered = !!render && !editing;
+  useEffect(() => {
+    const el = elRef.current;
+    if (!el || showRendered) return;
+    if (document.activeElement === el) return;
+    const next = display || "";
+    if (el.textContent !== next) el.textContent = next;
+  }, [display, showRendered]);
+  useEffect(() => {
+    if (!editing || !elRef.current) return;
+    const el = elRef.current;
+    el.textContent = display || "";
+    el.focus();
+    const range = document.createRange();
+    range.selectNodeContents(el);
+    const sel = window.getSelection();
+    sel?.removeAllRanges();
+    sel?.addRange(range);
+  }, [editing]);
+  const finishEdit = () => {
+    const raw = (elRef.current?.innerText ?? "").replace(/\u00a0/g, " ").replace(/\n+$/g, "");
+    const next = raw.trim() === "" ? "" : raw;
+    setEditing(false);
+    if (next === text) return;
+    if (!text && next === fallbackText) return;
+    commitComposerField(layoutNodeId, componentId, name, next);
+  };
+  return /* @__PURE__ */ jsx(
+    "span",
+    {
+      ref: elRef,
+      className,
+      "data-amplifyup-field": name,
+      "data-amplifyup-node-id": layoutNodeId || void 0,
+      contentEditable: !showRendered,
+      suppressContentEditableWarning: true,
+      role: "textbox",
+      tabIndex: 0,
+      onMouseDown: (event) => {
+        event.stopPropagation();
+      },
+      onClick: (event) => {
+        const link = event.target?.closest?.("a");
+        if (link) event.preventDefault();
+        if (render && isComposerEditMode()) {
+          setEditing(true);
+        }
+      },
+      onFocus: () => {
+        if (!isComposerEditMode()) return;
+        if (render) setEditing(true);
+      },
+      onBlur: finishEdit,
+      onKeyDown: (event) => {
+        event.stopPropagation();
+        if (event.key === "Enter" && !event.shiftKey) {
+          event.preventDefault();
+          event.currentTarget.blur();
+        }
+        if (event.key === "Escape") {
+          event.preventDefault();
+          if (elRef.current) elRef.current.textContent = display || "";
+          setEditing(false);
+          event.currentTarget.blur();
+        }
+      },
+      style: {
+        cursor: "text",
+        outline: "1px dashed color-mix(in srgb, currentColor 40%, transparent)",
+        outlineOffset: "2px",
+        minWidth: "1ch",
+        display: render ? void 0 : "inline"
+      },
+      children: showRendered ? value != null && value !== "" ? render(value) : fallback ?? display : null
+    }
+  );
+}
 function formatFieldValue(value) {
   if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
     return String(value);
@@ -3417,11 +3575,30 @@ function Field({
   render
 }) {
   const context = useContext(ComponentContext);
+  const composerEdit = useComposerEditMode();
+  const fieldValue = useFieldOverlay(
+    context?.layoutNodeId,
+    name,
+    context?.props?.[name]
+  );
   if (!context) {
     console.warn(`[AmplifyUp SDK] Field "${name}" used outside ComponentContextProvider`);
     return fallback ? /* @__PURE__ */ jsx(Fragment, { children: fallback }) : null;
   }
-  const fieldValue = context.props?.[name];
+  if (composerEdit && canInlineEdit(name, fieldValue)) {
+    return /* @__PURE__ */ jsx(
+      ComposerInlineField,
+      {
+        name,
+        value: fieldValue,
+        fallback,
+        className,
+        render,
+        layoutNodeId: context.layoutNodeId,
+        componentId: context.componentId
+      }
+    );
+  }
   if (fieldValue === void 0 || fieldValue === null) {
     return fallback ? /* @__PURE__ */ jsx("span", { className, children: fallback }) : null;
   }
@@ -3449,11 +3626,29 @@ function RichText({
   as: Tag = "div"
 }) {
   const context = useContext(ComponentContext);
+  const composerEdit = useComposerEditMode();
+  const fieldValue = useFieldOverlay(
+    context?.layoutNodeId,
+    name,
+    context?.props?.[name]
+  );
   if (!context) {
     console.warn(`[AmplifyUp SDK] RichText "${name}" used outside ComponentContextProvider`);
     return fallback ? /* @__PURE__ */ jsx(Fragment, { children: fallback }) : null;
   }
-  const fieldValue = context.props?.[name];
+  if (composerEdit && canInlineEdit(name, fieldValue)) {
+    return /* @__PURE__ */ jsx(
+      ComposerInlineField,
+      {
+        name,
+        value: fieldValue,
+        fallback,
+        className,
+        layoutNodeId: context.layoutNodeId,
+        componentId: context.componentId
+      }
+    );
+  }
   if (fieldValue === void 0 || fieldValue === null || fieldValue === "") {
     return fallback ? /* @__PURE__ */ jsx(Tag, { className, children: fallback }) : null;
   }