@amplifyup/sdk 0.1.21 → 0.1.23

package/dist/index.js

@@ -145,17 +145,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()
     };
@@ -217,6 +242,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";
 }
@@ -252,6 +278,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();
@@ -262,18 +292,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
   };
 }
 
@@ -303,7 +337,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);
@@ -331,6 +537,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 */
@@ -370,7 +578,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") {
@@ -485,7 +695,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) {
@@ -500,6 +711,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;
@@ -508,6 +721,7 @@ var AmplifyUpSDK = class {
         this.target = "production";
         this.apiGatewayUrl = prodUrls.apiGatewayUrl;
         this.decisionApiUrl = prodUrls.decisionApiUrl;
+        this.edgeUrl = prodUrls.edgeUrl;
       }
     }
     this.config = {
@@ -515,7 +729,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 = {
@@ -601,6 +816,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 = () => {
@@ -643,12 +859,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,
@@ -658,14 +874,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);
@@ -694,13 +930,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();
   }
@@ -886,12 +1128,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;
     }
@@ -907,10 +1154,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 });
     }
   }
   /**
@@ -1085,6 +1367,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
    */
@@ -2367,7 +2661,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();
@@ -2398,10 +2693,14 @@ var verifyAWSConnection = () => {
 var index_default = getSDK();
 
 exports.AmplifyUpSDK = AmplifyUpSDK;
+exports.EdgeResolveError = EdgeResolveError;
+exports.SESSION_IDLE_GAP_MS = SESSION_IDLE_GAP_MS;
 exports.buildLayoutProviderUrl = buildLayoutProviderUrl;
 exports.buildPageRenderUrl = buildPageRenderUrl;
 exports.cleanupEventTracking = cleanupEventTracking;
 exports.default = index_default;
+exports.fetchContent = fetchContent;
+exports.fetchEdgeResolve = fetchEdgeResolve;
 exports.fetchPageConfig = fetchPageConfig;
 exports.getDiagnostics = getDiagnostics;
 exports.getInstanceId = getInstanceId2;
@@ -2416,13 +2715,16 @@ exports.init = init;
 exports.isAmplifyUpTarget = isAmplifyUpTarget;
 exports.isComposerPreview = isComposerPreview;
 exports.isPreviewRequest = isPreviewRequest;
+exports.mapResolvedToPageConfig = mapResolvedToPageConfig;
 exports.normalizeAmplifyUpTarget = normalizeAmplifyUpTarget;
+exports.normalizeRoute = normalizeRoute;
 exports.page = page;
 exports.refreshEventTracking = refreshEventTracking;
 exports.reset = reset;
 exports.resolveAmplifyUpTarget = resolveAmplifyUpTarget;
 exports.resolveAmplifyUpUrls = resolveAmplifyUpUrls;
 exports.routeChange = routeChange;
+exports.setProfileFields = setProfileFields;
 exports.setupComponentViewTracking = setupComponentViewTracking;
 exports.setupEventTracking = setupEventTracking;
 exports.testTracking = testTracking;