@amplifyup/sdk 0.1.21 → 0.1.23

package/dist/AmplifyRenderer.mjs

@@ -151,17 +151,42 @@ var AWSAdapter = class {
     };
     this.sendEvent("/v1/track", eventData);
   }
-  identify(userId, traits) {
+  identify(userIdOrIdentifiers, traits = {}) {
     if (!this.initialized) {
       console.warn("AmplifyUp SDK: Not initialized. Call init() first.");
       return;
     }
+    const isMap = userIdOrIdentifiers !== null && typeof userIdOrIdentifiers === "object" && !Array.isArray(userIdOrIdentifiers);
+    const identifiers = isMap ? userIdOrIdentifiers : traits.identifiers;
+    const userId = isMap ? void 0 : String(userIdOrIdentifiers);
     const eventData = {
       type: "identify",
-      userId,
       anonymousId: traits.instanceId,
       traits: {
-        ...traits
+        ...traits,
+        ...identifiers ? { identifiers } : {}
+      },
+      ...identifiers ? { identifiers } : {},
+      ...userId ? { userId } : {},
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    this.sendEvent("/v1/track", eventData);
+  }
+  setProfileFields(fields, context = {}) {
+    if (!this.initialized) {
+      console.warn("AmplifyUp SDK: Not initialized. Call init() first.");
+      return;
+    }
+    const eventData = {
+      type: "set_fields",
+      anonymousId: context.instanceId,
+      fields,
+      traits: {
+        instanceId: context.instanceId,
+        trackingId: context.trackingId
+      },
+      properties: {
+        trackingId: context.trackingId
       },
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
     };
@@ -223,6 +248,7 @@ function clearIds() {
 var AWS_DEV_API = "https://api-dev.amplifyup.ai";
 var AWS_PROD_API = "https://api.amplifyup.ai";
 var PROD_ORCHESTRATOR = "https://amplifyup.ai";
+var PROD_EDGE = "https://edge.amplifyup.ai";
 function isAmplifyUpTarget(value) {
   return value === "local" || value === "dev" || value === "production";
 }
@@ -258,6 +284,10 @@ function localAwsApiUrl() {
   const fromEnv = typeof process !== "undefined" ? process.env.NEXT_PUBLIC_AMPLIFYUP_API_URL : void 0;
   return (fromEnv || AWS_DEV_API).replace(/\/$/, "");
 }
+function localEdgeUrl() {
+  const fromEnv = typeof process !== "undefined" ? process.env.NEXT_PUBLIC_EDGE_URL : void 0;
+  return (fromEnv || "http://localhost:8787").replace(/\/$/, "");
+}
 function resolveAmplifyUpUrls(target) {
   if (target === "local") {
     const orchestratorUrl2 = localOrchestratorUrl();
@@ -268,18 +298,22 @@ function resolveAmplifyUpUrls(target) {
       orchestratorUrl: orchestratorUrl2,
       // Events + personalize → AWS development stack
       apiGatewayUrl,
-      decisionApiUrl: `${apiGatewayUrl}/v1/personalize`
+      decisionApiUrl: `${apiGatewayUrl}/v1/personalize`,
+      edgeUrl: localEdgeUrl()
     };
   }
   const resolvedApi = typeof process !== "undefined" && process.env.NEXT_PUBLIC_AMPLIFYUP_API_URL?.replace(/\/$/, "") || AWS_PROD_API;
   const orchestratorFromEnv = typeof process !== "undefined" ? process.env.NEXT_PUBLIC_ORCHESTRATOR_URL : void 0;
   const isLocalOrchestrator = !!orchestratorFromEnv && (orchestratorFromEnv.includes("localhost") || orchestratorFromEnv.includes("127.0.0.1"));
   const orchestratorUrl = isLocalOrchestrator || !orchestratorFromEnv ? PROD_ORCHESTRATOR : orchestratorFromEnv.replace(/\/$/, "");
+  const edgeFromEnv = typeof process !== "undefined" ? process.env.NEXT_PUBLIC_EDGE_URL?.replace(/\/$/, "") : void 0;
+  const edgeUrl = edgeFromEnv && !edgeFromEnv.includes("localhost") && !edgeFromEnv.includes("127.0.0.1") ? edgeFromEnv : PROD_EDGE;
   return {
     target: "production",
     apiGatewayUrl: resolvedApi,
     orchestratorUrl,
-    decisionApiUrl: `${resolvedApi}/v1/personalize`
+    decisionApiUrl: `${resolvedApi}/v1/personalize`,
+    edgeUrl
   };
 }
 
@@ -310,6 +344,7 @@ function isComposerPreview() {
 }
 
 // src/index.ts
+var SESSION_IDLE_GAP_MS = 30 * 60 * 1e3;
 function readPreviewQueryOverrides() {
   if (typeof window === "undefined") return {};
   const params = new URLSearchParams(window.location.search);
@@ -337,6 +372,8 @@ var AmplifyUpSDK = class {
     this.apiGatewayUrl = "";
     this.orchestratorUrl = "";
     this.decisionApiUrl = "";
+    this.edgeUrl = "";
+    this.siteId = "";
     this.target = "local";
     this.initialized = false;
     /** Prevents overlapping init() from React Strict Mode double-mount */
@@ -376,7 +413,9 @@ var AmplifyUpSDK = class {
       reached: /* @__PURE__ */ new Set(),
       visibleMs: 0,
       visibleSince: null,
-      lastDwellSecondsSent: 0
+      lastDwellSecondsSent: 0,
+      /** When the tab last became hidden — used for idle-resume re-page. */
+      hiddenAt: null
     };
     this.adapter = adapter || new AWSAdapter();
     if (typeof window !== "undefined") {
@@ -491,7 +530,8 @@ var AmplifyUpSDK = class {
       isInitialized: () => this.isInitialized(),
       page: (url, properties) => this.page(url, properties),
       track: (eventName, properties) => this.track(eventName, properties),
-      identify: (userId, traits) => this.identify(userId, traits)
+      identify: (userIdOrIdentifiers, traits) => this.identify(userIdOrIdentifiers, traits),
+      setProfileFields: (fields) => this.setProfileFields(fields)
     };
   }
   async performInit(config) {
@@ -506,6 +546,8 @@ var AmplifyUpSDK = class {
     this.apiGatewayUrl = urls.apiGatewayUrl;
     this.orchestratorUrl = urls.orchestratorUrl;
     this.decisionApiUrl = urls.decisionApiUrl;
+    this.edgeUrl = urls.edgeUrl;
+    this.siteId = config.siteId || "";
     const previewOverrides = readPreviewQueryOverrides();
     if (previewOverrides.orchestratorUrl) {
       this.orchestratorUrl = previewOverrides.orchestratorUrl;
@@ -514,6 +556,7 @@ var AmplifyUpSDK = class {
         this.target = "production";
         this.apiGatewayUrl = prodUrls.apiGatewayUrl;
         this.decisionApiUrl = prodUrls.decisionApiUrl;
+        this.edgeUrl = prodUrls.edgeUrl;
       }
     }
     this.config = {
@@ -521,7 +564,8 @@ var AmplifyUpSDK = class {
       debug: config.debug ?? true,
       // Enable debug by default
       target: this.target,
-      dev: config.dev
+      dev: config.dev,
+      ...config.siteId ? { siteId: config.siteId } : {}
     };
     try {
       const adapterConfig = {
@@ -607,6 +651,7 @@ var AmplifyUpSDK = class {
     state.visibleMs = 0;
     state.visibleSince = document.visibilityState === "visible" ? Date.now() : null;
     state.lastDwellSecondsSent = 0;
+    state.hiddenAt = document.visibilityState === "hidden" ? Date.now() : null;
     let scrollRaf = null;
     const path = () => this.currentPath();
     const measureScrollPercent = () => {
@@ -649,12 +694,12 @@ var AmplifyUpSDK = class {
       state.visibleMs += Date.now() - state.visibleSince;
       state.visibleSince = Date.now();
     };
-    const emitDwell = (force = false) => {
+    const emitDwell = (_force = false) => {
       if (this.isPreviewMode()) return;
       accumulateVisible();
       const seconds = Math.floor(state.visibleMs / 1e3);
       if (seconds <= 0) return;
-      if (!force && seconds <= state.lastDwellSecondsSent) return;
+      if (seconds <= state.lastDwellSecondsSent) return;
       state.lastDwellSecondsSent = seconds;
       this.track("Time on Page", {
         seconds,
@@ -664,14 +709,34 @@ var AmplifyUpSDK = class {
     this._emitPageDwell = emitDwell;
     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) {
+          this.resetEngagementQuiet();
+          const resumePath = path();
+          this.page(resumePath, { resumed: true });
+          this.lastTrackedPath = resumePath;
+          if (this.config?.debug) {
+            console.log(
+              "[AmplifyUp SDK] Idle resume page view",
+              resumePath,
+              `(hidden ${Math.round(idleMs / 6e4)}m)`
+            );
+          }
+        }
         state.visibleSince = Date.now();
       } else {
         emitDwell(true);
+        state.hiddenAt = Date.now();
         state.visibleSince = null;
       }
     };
     const onPageHide = () => {
       emitDwell(true);
+      if (state.hiddenAt == null) {
+        state.hiddenAt = Date.now();
+      }
+      state.visibleSince = null;
     };
     window.addEventListener("scroll", onScroll, { passive: true });
     document.addEventListener("visibilitychange", onVisibility);
@@ -700,13 +765,19 @@ var AmplifyUpSDK = class {
       console.log("[AmplifyUp SDK] Page engagement tracking enabled");
     }
   }
+  /** Flush dwell then reset — used on SPA route changes. */
   resetEngagementForNewPage() {
     const emit = this._emitPageDwell;
     emit?.(true);
+    this.resetEngagementQuiet();
+  }
+  /** Reset dwell/scroll state without emitting (idle resume already flushed on hide). */
+  resetEngagementQuiet() {
     const state = this.pageEngagementState;
     state.reached = /* @__PURE__ */ new Set();
     state.visibleMs = 0;
     state.lastDwellSecondsSent = 0;
+    state.hiddenAt = null;
     state.visibleSince = typeof document !== "undefined" && document.visibilityState === "visible" ? Date.now() : null;
     this.componentViewSeen.clear();
   }
@@ -892,12 +963,17 @@ var AmplifyUpSDK = class {
     });
   }
   /**
-   * Identify user (when they sign up or log in)
+   * Identify a visitor.
+   * - identify('user_123') — bare string; server maps via org default type
+   * - identify({ email: '...', crm_id: '...' }) — explicit types
+   * - identify('user_123', traits) — legacy form
    */
-  identify(userId, traits) {
+  identify(userIdOrIdentifiers, traits) {
     if (this.isPreviewMode()) {
       if (this.config?.debug) {
-        console.log("AmplifyUp SDK: Identify tracking disabled in preview mode", { userId });
+        console.log("AmplifyUp SDK: Identify tracking disabled in preview mode", {
+          userIdOrIdentifiers
+        });
       }
       return;
     }
@@ -913,10 +989,45 @@ var AmplifyUpSDK = class {
       trackingId: this.config?.trackingId,
       ...traits
     };
-    this.adapter.identify(userId, identifyTraits);
-    setUserId(userId);
+    this.adapter.identify(userIdOrIdentifiers, identifyTraits);
+    if (typeof userIdOrIdentifiers === "string") {
+      setUserId(userIdOrIdentifiers);
+    }
     if (this.config?.debug) {
-      console.log("AmplifyUp SDK: User identified", { userId, instanceId });
+      console.log("AmplifyUp SDK: User identified", {
+        userIdOrIdentifiers,
+        instanceId
+      });
+    }
+  }
+  /**
+   * Set profile fields (partial update). Omitted keys are left alone;
+   * an explicit empty value clears the field.
+   */
+  setProfileFields(fields) {
+    if (this.isPreviewMode()) {
+      if (this.config?.debug) {
+        console.log("AmplifyUp SDK: setProfileFields disabled in preview mode", {
+          fields
+        });
+      }
+      return;
+    }
+    if (!this.isInitialized()) {
+      if (this.config?.debug) {
+        console.warn("AmplifyUp SDK: Not initialized. setProfileFields not called.");
+      }
+      return;
+    }
+    const instanceId = getInstanceId();
+    if (typeof this.adapter.setProfileFields === "function") {
+      this.adapter.setProfileFields(fields, {
+        instanceId: instanceId || void 0,
+        trackingId: this.config?.trackingId
+      });
+    }
+    if (this.config?.debug) {
+      console.log("AmplifyUp SDK: Profile fields set", { fields, instanceId });
     }
   }
   /**
@@ -1091,6 +1202,18 @@ Available Console Commands:
   getDecisionApiUrl() {
     return this.decisionApiUrl || void 0;
   }
+  /**
+   * Get Edge Worker URL (production content resolve)
+   */
+  getEdgeUrl() {
+    return this.edgeUrl || void 0;
+  }
+  /**
+   * Optional site id from config (Edge can resolve via trackingId alone).
+   */
+  getSiteId() {
+    return this.siteId || this.config?.siteId || void 0;
+  }
   /**
    * Build API URL for fetching page config from the Layout Provider
    */
@@ -2396,6 +2519,7 @@ function AmplifyRenderer({
   const pageConfig = serverPageConfig || clientHook.pageConfig || null;
   const loading = serverPageConfig ? false : clientHook.loading;
   const error = serverPageConfig ? null : clientHook.error;
+  const contentSource = clientHook.source;
   const [variantCache, setVariantCache] = useState({});
   useEffect(() => {
     if (typeof window !== "undefined") {
@@ -2537,6 +2661,9 @@ function AmplifyRenderer({
   }, [pageConfig]);
   useEffect(() => {
     if (!pageConfig?.layoutTree || !pageConfig.layoutId) return;
+    const roots = pageConfig.layoutTree;
+    const fromEdge = contentSource === "edge" || roots.some((n) => n._contentSource === "edge");
+    if (fromEdge) return;
     const sdk = getSDK();
     const instanceId = sdk.getInstanceId();
     const decisionApiUrl = sdk.getDecisionApiUrl();
@@ -2631,7 +2758,7 @@ function AmplifyRenderer({
       setVariantCache(newCache);
     };
     fetchVariants();
-  }, [pageConfig?.layoutTree, pageConfig?.layoutId, pageConfig?.route]);
+  }, [pageConfig?.layoutTree, pageConfig?.layoutId, pageConfig?.route, contentSource]);
   if (loading) {
     return /* @__PURE__ */ jsx(Fragment, { children: loadingComponent || /* @__PURE__ */ jsx("div", { className: "min-h-screen bg-gray-50", children: /* @__PURE__ */ jsx("div", { className: "container mx-auto px-4 py-16", children: /* @__PURE__ */ jsxs("div", { className: "animate-pulse", children: [
       /* @__PURE__ */ jsx("div", { className: "h-8 bg-gray-200 rounded w-1/4 mb-4" }),