@amplifyup/sdk 0.1.21 → 0.1.23

package/dist/index.mjs

@@ -141,17 +141,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()
     };
@@ -213,6 +238,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";
 }
@@ -248,6 +274,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();
@@ -258,18 +288,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
   };
 }
 
@@ -299,7 +333,179 @@ function isComposerPreview() {
   return false;
 }
 
+// src/edge/normalizeRoute.ts
+function normalizeRoute(route) {
+  let path = String(route || "").trim();
+  if (!path) return "/";
+  try {
+    if (/^https?:\/\//i.test(path)) {
+      path = new URL(path).pathname;
+    }
+  } catch {
+  }
+  const q = path.indexOf("?");
+  if (q >= 0) path = path.slice(0, q);
+  const h = path.indexOf("#");
+  if (h >= 0) path = path.slice(0, h);
+  if (!path.startsWith("/")) path = `/${path}`;
+  if (path.length > 1 && path.endsWith("/")) {
+    path = path.replace(/\/+$/, "");
+  }
+  return path || "/";
+}
+
+// src/edge/resolve.ts
+var EdgeResolveError = class extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.name = "EdgeResolveError";
+    this.status = status;
+    this.body = body;
+  }
+};
+async function fetchEdgeResolve(options) {
+  const base = options.edgeUrl.replace(/\/+$/, "");
+  const route = normalizeRoute(options.route);
+  const params = new URLSearchParams({
+    route,
+    trackingId: options.trackingId
+  });
+  if (options.siteId) params.set("site", options.siteId);
+  if (options.anonId) params.set("anonId", options.anonId);
+  const fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
+  const res = await fetchFn(`${base}/v1/resolve?${params.toString()}`, {
+    method: "GET",
+    headers: { Accept: "application/json" }
+  });
+  const body = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    throw new EdgeResolveError(
+      (body && typeof body === "object" && "error" in body ? String(body.error) : `Edge resolve failed (${res.status})`) || `Edge resolve failed (${res.status})`,
+      res.status,
+      body
+    );
+  }
+  return body;
+}
+
+// src/edge/mapResolvedToPageConfig.ts
+function mapResolvedComponent(node) {
+  const slots = [];
+  if (node.children) {
+    for (const [slotId, kids] of Object.entries(node.children)) {
+      slots.push({
+        slotId,
+        children: (kids || []).map(mapResolvedComponent)
+      });
+    }
+  }
+  return {
+    id: node.instanceId,
+    componentId: node.componentId,
+    props: { ...node.props || {} },
+    ...slots.length > 0 ? { slots } : {},
+    _contentSource: "edge"
+  };
+}
+function mapResolvedToPageConfig(payload) {
+  let layoutTree = [];
+  if (payload.tree && payload.tree.length > 0) {
+    layoutTree = payload.tree.map(mapResolvedComponent);
+  } else {
+    const zoneIds = Object.keys(payload.zones || {}).sort();
+    for (const zoneId of zoneIds) {
+      const roots = payload.zones[zoneId] || [];
+      layoutTree.push(...roots.map(mapResolvedComponent));
+    }
+  }
+  return {
+    id: `edge:${payload.siteId}:${payload.route}:v${payload.version}`,
+    route: payload.route,
+    title: "",
+    layoutTree,
+    meta: {
+      // Stash edge meta for diagnostics (not visitor-facing)
+      description: payload.meta?.degraded ? "degraded" : void 0
+    }
+  };
+}
+function collectDegraded(payload) {
+  if (payload.meta?.degraded) return true;
+  const walk = (nodes) => nodes.some(
+    (n) => !!n.degraded || (n.children ? Object.values(n.children).some((kids) => walk(kids || [])) : false)
+  );
+  if (payload.tree && walk(payload.tree)) return true;
+  return Object.values(payload.zones || {}).some((roots) => walk(roots || []));
+}
+
+// src/content/fetchContent.ts
+async function fetchContent(options) {
+  const preview = options.preview ?? (typeof window !== "undefined" ? isComposerPreview() : false);
+  if (preview) {
+    try {
+      const page2 = await options.fetchOrchestratorPage(options.route, true);
+      return {
+        pageConfig: page2,
+        source: "orchestrator",
+        meta: { source: "orchestrator" },
+        error: null
+      };
+    } catch (err) {
+      return {
+        pageConfig: null,
+        source: "orchestrator",
+        meta: { source: "orchestrator" },
+        error: err instanceof Error ? err.message : "Failed to load preview"
+      };
+    }
+  }
+  try {
+    const payload = await fetchEdgeResolve({
+      edgeUrl: options.edgeUrl,
+      trackingId: options.trackingId,
+      route: options.route,
+      anonId: options.anonId,
+      siteId: options.siteId,
+      fetch: options.fetchFn
+    });
+    const pageConfig = mapResolvedToPageConfig(payload);
+    const degraded = collectDegraded(payload);
+    return {
+      pageConfig,
+      source: "edge",
+      meta: {
+        source: "edge",
+        version: payload.version,
+        siteId: payload.siteId,
+        variantKeys: payload.meta?.variantKeys,
+        degraded,
+        audienceLookup: payload.meta?.audienceLookup,
+        decideLookup: payload.meta?.decideLookup,
+        resolvedAt: payload.meta?.resolvedAt
+      },
+      error: null
+    };
+  } catch (err) {
+    if (err instanceof EdgeResolveError && err.status === 404) {
+      return {
+        pageConfig: null,
+        source: "edge",
+        meta: { source: "edge" },
+        error: null
+        // unpublished → site fallback, not an error banner
+      };
+    }
+    return {
+      pageConfig: null,
+      source: "edge",
+      meta: { source: "edge" },
+      error: err instanceof Error ? err.message : "Couldn't load page content."
+    };
+  }
+}
+
 // 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);
@@ -327,6 +533,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 */
@@ -366,7 +574,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") {
@@ -481,7 +691,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) {
@@ -496,6 +707,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;
@@ -504,6 +717,7 @@ var AmplifyUpSDK = class {
         this.target = "production";
         this.apiGatewayUrl = prodUrls.apiGatewayUrl;
         this.decisionApiUrl = prodUrls.decisionApiUrl;
+        this.edgeUrl = prodUrls.edgeUrl;
       }
     }
     this.config = {
@@ -511,7 +725,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 = {
@@ -597,6 +812,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 = () => {
@@ -639,12 +855,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,
@@ -654,14 +870,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);
@@ -690,13 +926,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();
   }
@@ -882,12 +1124,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;
     }
@@ -903,10 +1150,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", {
+        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: User identified", { userId, instanceId });
+      console.log("AmplifyUp SDK: Profile fields set", { fields, instanceId });
     }
   }
   /**
@@ -1081,6 +1363,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
    */
@@ -2363,7 +2657,8 @@ var trackClick = (elementId, elementText, properties) => getSDK().trackClick(ele
 var trackFormSubmit = (formId, formData) => getSDK().trackFormSubmit(formId, formData);
 var trackFormFieldInteraction = (fieldName, fieldValue) => getSDK().trackFormFieldInteraction(fieldName, fieldValue);
 var trackContentView = (contentId, contentType, properties) => getSDK().trackContentView(contentId, contentType, properties);
-var identify = (userId, traits) => getSDK().identify(userId, traits);
+var identify = (userIdOrIdentifiers, traits) => getSDK().identify(userIdOrIdentifiers, traits);
+var setProfileFields = (fields) => getSDK().setProfileFields(fields);
 var trackContentEngagement = (contentId, engagementType) => getSDK().trackContentEngagement(contentId, engagementType);
 var reset = () => getSDK().reset();
 var getInstanceId2 = () => getSDK().getInstanceId();
@@ -2393,6 +2688,6 @@ var verifyAWSConnection = () => {
 };
 var index_default = getSDK();
 
-export { AmplifyUpSDK, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, index_default as default, fetchPageConfig, getDiagnostics, getInstanceId2 as getInstanceId, getOrchestratorUrl, getSDK, getStatus, getTarget, getTrackingId, getUserId2 as getUserId, identify, init, isAmplifyUpTarget, isComposerPreview, isPreviewRequest, normalizeAmplifyUpTarget, page, refreshEventTracking, reset, resolveAmplifyUpTarget, resolveAmplifyUpUrls, routeChange, setupComponentViewTracking, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };
+export { AmplifyUpSDK, EdgeResolveError, SESSION_IDLE_GAP_MS, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, index_default as default, fetchContent, fetchEdgeResolve, fetchPageConfig, getDiagnostics, getInstanceId2 as getInstanceId, getOrchestratorUrl, getSDK, getStatus, getTarget, getTrackingId, getUserId2 as getUserId, identify, init, isAmplifyUpTarget, isComposerPreview, isPreviewRequest, mapResolvedToPageConfig, normalizeAmplifyUpTarget, normalizeRoute, page, refreshEventTracking, reset, resolveAmplifyUpTarget, resolveAmplifyUpUrls, routeChange, setProfileFields, setupComponentViewTracking, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map