@amplifyup/sdk 0.1.22 → 0.1.23

package/dist/react.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
   };
 }
 
@@ -309,6 +343,177 @@ 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 page = await options.fetchOrchestratorPage(options.route, true);
+      return {
+        pageConfig: page,
+        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() {
@@ -338,6 +543,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 */
@@ -494,7 +701,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) {
@@ -509,6 +717,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;
@@ -517,6 +727,7 @@ var AmplifyUpSDK = class {
         this.target = "production";
         this.apiGatewayUrl = prodUrls.apiGatewayUrl;
         this.decisionApiUrl = prodUrls.decisionApiUrl;
+        this.edgeUrl = prodUrls.edgeUrl;
       }
     }
     this.config = {
@@ -524,7 +735,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 = {
@@ -922,12 +1134,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;
     }
@@ -943,10 +1160,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 });
     }
   }
   /**
@@ -1121,6 +1373,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
    */
@@ -2407,6 +2671,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") {
@@ -2548,6 +2813,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();
@@ -2642,7 +2910,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" }),
@@ -2843,28 +3111,38 @@ async function fetchPageConfigServer(route, trackingId, preview = false, options
   const target = resolveAmplifyUpTarget({
     configTarget: options?.target
   });
-  const { orchestratorUrl } = resolveAmplifyUpUrls(target);
-  const params = new URLSearchParams({
-    route,
-    trackingId
-  });
-  if (preview) {
-    params.set("preview", "true");
-  }
-  const url = `${orchestratorUrl}/api/layout/provider?${params.toString()}`;
-  try {
-    const res = await fetch(url, {
-      cache: "no-store",
-      headers: { Accept: "application/json" }
+  const { orchestratorUrl, edgeUrl } = resolveAmplifyUpUrls(target);
+  const previewFlag = preview || (options?.searchParams ? isPreviewRequest(options.searchParams) : false);
+  const fetchOrchestratorPage = async (pageRoute, isPreview) => {
+    const params = new URLSearchParams({
+      route: pageRoute,
+      trackingId
     });
-    if (!res.ok) {
+    if (isPreview) params.set("preview", "true");
+    const url = `${orchestratorUrl}/api/layout/provider?${params.toString()}`;
+    try {
+      const res = await fetch(url, {
+        cache: "no-store",
+        headers: { Accept: "application/json" }
+      });
+      if (!res.ok) return null;
+      const data = await res.json();
+      return data.page || null;
+    } catch {
       return null;
     }
-    const data = await res.json();
-    return data.page || null;
-  } catch {
-    return null;
-  }
+  };
+  const result = await fetchContent({
+    route,
+    trackingId,
+    anonId: options?.anonId,
+    siteId: options?.siteId,
+    preview: previewFlag,
+    orchestratorUrl,
+    edgeUrl,
+    fetchOrchestratorPage
+  });
+  return result.pageConfig;
 }
 var ComponentContext = createContext(null);
 function ComponentContextProvider({
@@ -3023,6 +3301,8 @@ function AmplifyUpProvider({ children, config }) {
   const [pageConfig, setPageConfig] = useState(null);
   const [loading, setLoading] = useState(true);
   const [error, setError] = useState(null);
+  const [source, setSource] = useState(null);
+  const [meta, setMeta] = useState(null);
   const getActualRoute = () => {
     if (typeof window === "undefined") return "";
     const currentPath = window.location.pathname;
@@ -3088,10 +3368,10 @@ function AmplifyUpProvider({ children, config }) {
     return () => {
       cancelled = true;
     };
-  }, [config.trackingId, config.target, config.debug, config.dev]);
+  }, [config.trackingId, config.target, config.debug, config.dev, config.siteId]);
   useEffect(() => {
     if (!initialized) return;
-    const fetchConfig = async () => {
+    const load = async () => {
       try {
         setLoading(true);
         setError(null);
@@ -3102,29 +3382,57 @@ function AmplifyUpProvider({ children, config }) {
         }
         const sdk = getSDK();
         sdk.routeChange(actualRoute);
-        const isPreviewContext = isComposerPreview();
-        const page = await sdk.fetchPageConfig(actualRoute, isPreviewContext);
-        if (!page) {
+        const preview = isComposerPreview();
+        const edgeUrl = sdk.getEdgeUrl();
+        const orchestratorUrl = sdk.getOrchestratorUrl();
+        const trackingId = sdk.getTrackingId();
+        if (!trackingId || !orchestratorUrl || !edgeUrl) {
+          setError("SDK not initialized");
+          setLoading(false);
+          return;
+        }
+        const result = await fetchContent({
+          route: actualRoute,
+          trackingId,
+          anonId: sdk.getInstanceId(),
+          siteId: sdk.getSiteId() || null,
+          preview,
+          orchestratorUrl,
+          edgeUrl,
+          fetchOrchestratorPage: (route, isPreview) => sdk.fetchPageConfig(route, isPreview)
+        });
+        setSource(result.source);
+        setMeta(result.meta);
+        setError(result.error);
+        if (!result.pageConfig) {
           setPageConfig({
             id: "default",
             route: actualRoute,
             title: "Page Not Configured",
-            description: "This page has not been configured in the orchestrator yet.",
+            description: "This page has not been published yet.",
             layoutTree: []
           });
         } else {
-          setPageConfig(page);
+          setPageConfig(result.pageConfig);
         }
       } catch (err) {
         console.error("Error fetching page config:", err);
         setError(err instanceof Error ? err.message : "Unknown error");
+        setSource(null);
+        setMeta(null);
       } finally {
         setLoading(false);
       }
     };
-    fetchConfig();
+    void load();
   }, [pathname, initialized]);
-  return /* @__PURE__ */ jsx(AmplifyUpContext.Provider, { value: { pageConfig, loading, error }, children });
+  return /* @__PURE__ */ jsx(
+    AmplifyUpContext.Provider,
+    {
+      value: { pageConfig, loading, error, source, meta },
+      children
+    }
+  );
 }
 function useAmplifyUp() {
   const context = useContext(AmplifyUpContext);