@amplifyup/sdk 0.1.42 → 0.1.44

package/dist/index.mjs

@@ -394,6 +394,159 @@ function isComposerPreview() {
   return false;
 }
 
+// src/page-context.ts
+var defaultLog = {
+  warn: (...args) => {
+    if (typeof console !== "undefined") console.warn(...args);
+  }
+};
+function coerceField(def, raw, log) {
+  if (raw == null) return void 0;
+  if (def.multiValue) {
+    const list = Array.isArray(raw) ? raw : [raw];
+    const out = [];
+    for (const item of list) {
+      const coerced = coerceScalar(def, item, log);
+      if (coerced !== void 0) out.push(coerced);
+    }
+    return out;
+  }
+  return coerceScalar(def, raw, log);
+}
+function coerceScalar(def, raw, log) {
+  switch (def.dataType) {
+    case "string":
+      if (typeof raw === "string") return raw;
+      if (typeof raw === "number" || typeof raw === "boolean") return String(raw);
+      log.warn(`AmplifyUp: dropped field "${def.key}" (expected string)`);
+      return void 0;
+    case "number": {
+      if (typeof raw === "number" && Number.isFinite(raw)) return raw;
+      if (typeof raw === "string" && raw.trim() !== "" && Number.isFinite(Number(raw))) {
+        return Number(raw);
+      }
+      log.warn(`AmplifyUp: dropped field "${def.key}" (expected number)`);
+      return void 0;
+    }
+    case "boolean": {
+      if (typeof raw === "boolean") return raw;
+      if (raw === "true") return true;
+      if (raw === "false") return false;
+      log.warn(`AmplifyUp: dropped field "${def.key}" (expected boolean)`);
+      return void 0;
+    }
+    case "date": {
+      if (typeof raw === "string" && !Number.isNaN(Date.parse(raw))) return raw;
+      log.warn(`AmplifyUp: dropped field "${def.key}" (expected date)`);
+      return void 0;
+    }
+    default:
+      return void 0;
+  }
+}
+function applyPageContext(input, opts) {
+  const log = opts.log || defaultLog;
+  const key = String(input.key || "").trim();
+  if (!key || !input.resourceType) {
+    log.warn("AmplifyUp: pageContext needs resourceType and key");
+    return null;
+  }
+  const slot = opts.pageData?.slots?.[0];
+  if (slot && slot.type && slot.type !== input.resourceType) {
+    log.warn(
+      `AmplifyUp: pageContext resourceType "${input.resourceType}" does not match page slot "${slot.type}"`
+    );
+    return null;
+  }
+  const fieldDefs = slot?.fields || [];
+  const defByKey = new Map(fieldDefs.map((f) => [f.key, f]));
+  const rawFields = input.fields && typeof input.fields === "object" ? input.fields : {};
+  const fields = {};
+  if (fieldDefs.length === 0) {
+    Object.assign(fields, rawFields);
+  } else {
+    for (const [k, v] of Object.entries(rawFields)) {
+      const def = defByKey.get(k);
+      if (!def) {
+        log.warn(`AmplifyUp: unknown resource field "${k}" dropped`);
+        continue;
+      }
+      const coerced = coerceField(def, v, log);
+      if (coerced !== void 0) fields[k] = coerced;
+    }
+  }
+  const params = { ...opts.routeParams || {} };
+  const mapping = slot?.urlParamMapping;
+  let resourceKey = key;
+  if (mapping) {
+    const fromUrl = params[mapping.param];
+    const fromField = fields[mapping.field];
+    if (fromUrl) resourceKey = String(fromUrl);
+    if (fromUrl && fromField != null && String(fromField) !== String(fromUrl)) {
+      log.warn(
+        `AmplifyUp: resource key mismatch \u2014 URL :${mapping.param} is "${fromUrl}" but ${mapping.field} is "${String(fromField)}". Using the URL param.`
+      );
+    }
+  }
+  const pageFields = {};
+  for (const pf of opts.pageData?.pageFields || []) {
+    if (pf.source === "static") {
+      if (pf.value !== void 0) pageFields[pf.key] = pf.value;
+      continue;
+    }
+    if (pf.source === "mapped" && pf.slot && pf.field) {
+      pageFields[pf.key] = fields[pf.field];
+    }
+  }
+  return {
+    resource: {
+      type: input.resourceType,
+      key: resourceKey,
+      params,
+      fields
+    },
+    page: { fields: pageFields },
+    pageRoute: opts.pageRoute || ""
+  };
+}
+function staticPageFieldsFromSnapshot(pageData) {
+  const pageFields = {};
+  for (const pf of pageData?.pageFields || []) {
+    if (pf.source === "static" && pf.value !== void 0) {
+      pageFields[pf.key] = pf.value;
+    }
+  }
+  return pageFields;
+}
+function attachStaticPageContext(pageData, pageRoute) {
+  if (!pageData) return null;
+  const fields = staticPageFieldsFromSnapshot(pageData);
+  const hasStatic = Object.keys(fields).length > 0;
+  const hasRoute = !!pageRoute;
+  if (!hasStatic && !hasRoute) return null;
+  return {
+    page: { fields },
+    pageRoute: pageRoute || ""
+  };
+}
+function mergeEventContext(properties, attached) {
+  if (!attached) return properties;
+  return {
+    ...properties,
+    ...attached.resource ? { resource: attached.resource } : {},
+    page: attached.page,
+    ...attached.pageRoute ? { pageRoute: attached.pageRoute } : {}
+  };
+}
+function setPageSlotFields(fields) {
+}
+
+// src/reservedRoutes.ts
+var AMPLIFYUP_EDITOR_ROUTE = "/__amplifyup/editor";
+function isAmplifyUpEditorRoute(pathname) {
+  return pathname === AMPLIFYUP_EDITOR_ROUTE || pathname.startsWith(`${AMPLIFYUP_EDITOR_ROUTE}/`);
+}
+
 // src/edge/normalizeRoute.ts
 function normalizeRoute(route) {
   let path = String(route || "").trim();
@@ -513,7 +666,8 @@ function mapResolvedToPageConfig(payload) {
       // Stash edge meta for diagnostics (not visitor-facing)
       description: payload.meta?.degraded ? "degraded" : void 0
     },
-    ...payload.eventTracking && payload.eventTracking.length > 0 ? { eventTracking: payload.eventTracking } : {}
+    ...payload.eventTracking && payload.eventTracking.length > 0 ? { eventTracking: payload.eventTracking } : {},
+    ...payload.pageData ? { pageData: payload.pageData } : {}
   };
 }
 function collectDegraded(payload) {
@@ -803,6 +957,11 @@ var AmplifyUpSDK = class {
     this.pageEngagementActive = false;
     /** Path of the last page() / routeChange — avoids duplicate SPA fires. */
     this.lastTrackedPath = null;
+    this.pendingPageContext = null;
+    this.attachedPageContext = null;
+    this.resolvedPageData = null;
+    this.resolvedPageRoute = "";
+    this.resolvedRouteParams = {};
     this.historyHooksInstalled = false;
     this.pageEngagementState = {
       reached: /* @__PURE__ */ new Set(),
@@ -965,8 +1124,13 @@ var AmplifyUpSDK = class {
       // Enable debug by default
       target: this.target,
       dev: config.dev,
-      ...config.siteId ? { siteId: config.siteId } : {}
+      ...config.siteId ? { siteId: config.siteId } : {},
+      ...config.pageContext ? { pageContext: config.pageContext } : {}
     };
+    if (config.pageContext) {
+      this.pendingPageContext = config.pageContext;
+      this.recomputeAttachedContext();
+    }
     try {
       const adapterConfig = {
         ...this.config,
@@ -1323,6 +1487,43 @@ var AmplifyUpSDK = class {
     this.componentViewObservers.forEach((obs) => obs.disconnect());
     this.componentViewObservers = [];
   }
+  /**
+   * Set resource context for this page. Prefer passing `pageContext` on
+   * AmplifyUpProvider / init — required for components using From page.
+   * Late calls still attach to subsequent events (not a second page view).
+   */
+  setPageContext(input) {
+    this.pendingPageContext = input;
+    this.recomputeAttachedContext();
+  }
+  /**
+   * Apply published pageData (from /v1/resolve) so field validation and
+   * mapped page fields can run.
+   */
+  applyResolvedPageData(pageData, pageRoute, routeParams) {
+    this.resolvedPageData = pageData || null;
+    if (pageRoute) this.resolvedPageRoute = pageRoute;
+    if (routeParams) this.resolvedRouteParams = routeParams;
+    this.recomputeAttachedContext();
+  }
+  recomputeAttachedContext() {
+    if (!this.pendingPageContext) {
+      this.attachedPageContext = attachStaticPageContext(
+        this.resolvedPageData,
+        this.resolvedPageRoute
+      );
+      return;
+    }
+    this.attachedPageContext = applyPageContext(this.pendingPageContext, {
+      pageData: this.resolvedPageData,
+      routeParams: this.resolvedRouteParams,
+      pageRoute: this.resolvedPageRoute
+    });
+    setPageSlotFields(this.attachedPageContext?.resource?.fields || null);
+  }
+  getAttachedPageContext() {
+    return this.attachedPageContext;
+  }
   /**
    * Track a page view
    */
@@ -1344,7 +1545,7 @@ var AmplifyUpSDK = class {
       sessionId,
       trackingId: this.config?.trackingId,
       // Timestamp is included in event payload
-      ...properties
+      ...mergeEventContext(properties || {}, this.attachedPageContext)
     };
     this.adapter.page(pageProperties);
     this.lastTrackedPath = url;
@@ -1368,7 +1569,7 @@ var AmplifyUpSDK = class {
       url: typeof window !== "undefined" ? window.location.href : void 0,
       path: properties?.path || (typeof window !== "undefined" ? window.location.pathname : void 0),
       // Timestamp is included in event payload
-      ...properties
+      ...mergeEventContext(properties || {}, this.attachedPageContext)
     };
     if (!trackProperties.path && typeof window !== "undefined") {
       trackProperties.path = window.location.pathname;
@@ -1693,8 +1894,15 @@ Available Console Commands:
     });
     if (preview) {
       params.set("preview", "true");
-      if (typeof window !== "undefined" && isWorkingContentRequest(new URLSearchParams(window.location.search))) {
-        params.set("working", "true");
+      if (typeof window !== "undefined") {
+        const pageSearch = new URLSearchParams(window.location.search);
+        if (isWorkingContentRequest(pageSearch)) {
+          params.set("working", "true");
+        }
+        const zoneId = pageSearch.get("zoneId");
+        const compositionId = pageSearch.get("compositionId");
+        if (zoneId) params.set("zoneId", zoneId);
+        if (compositionId) params.set("compositionId", compositionId);
       }
     }
     if (isOnOrchestratorOrigin) {
@@ -3082,6 +3290,6 @@ var verifyAWSConnection = () => {
 };
 var index_default = getSDK();
 
-export { ANON_COOKIE_NAME, AmplifyUpSDK, DWELL_ACTIVITY_IDLE_MS, EdgeResolveError, QueryContentError, SESSION_COOKIE_NAME, SESSION_IDLE_GAP_MS, SelectVariantsError, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, index_default as default, fetchContent, fetchEdgeQuery, fetchEdgeResolve, fetchEdgeSelect, fetchPageConfig, getDiagnostics, getInstanceId2 as getInstanceId, getOrchestratorUrl, getSDK, getSessionId2 as getSessionId, getStatus, getTarget, getTrackingId, getUserId2 as getUserId, identify, init, isAmplifyUpTarget, isComposerPreview, isPreviewRequest, isWorkingContentRequest, mapResolvedToPageConfig, nextPageSpec, normalizeAmplifyUpTarget, normalizeRoute, page, queryContent, refreshEventTracking, reset, resolveAmplifyUpTarget, resolveAmplifyUpUrls, routeChange, searchSpec, selectVariants, setProfileFields, setupComponentViewTracking, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };
+export { AMPLIFYUP_EDITOR_ROUTE, ANON_COOKIE_NAME, AmplifyUpSDK, DWELL_ACTIVITY_IDLE_MS, EdgeResolveError, QueryContentError, SESSION_COOKIE_NAME, SESSION_IDLE_GAP_MS, SelectVariantsError, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, index_default as default, fetchContent, fetchEdgeQuery, fetchEdgeResolve, fetchEdgeSelect, fetchPageConfig, getDiagnostics, getInstanceId2 as getInstanceId, getOrchestratorUrl, getSDK, getSessionId2 as getSessionId, getStatus, getTarget, getTrackingId, getUserId2 as getUserId, identify, init, isAmplifyUpEditorRoute, isAmplifyUpTarget, isComposerPreview, isPreviewRequest, isWorkingContentRequest, mapResolvedToPageConfig, nextPageSpec, normalizeAmplifyUpTarget, normalizeRoute, page, queryContent, refreshEventTracking, reset, resolveAmplifyUpTarget, resolveAmplifyUpUrls, routeChange, searchSpec, selectVariants, setProfileFields, setupComponentViewTracking, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map