@amplifyup/sdk 0.1.43 → 0.1.44

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { P as PageConfig, C as ContentSource, A as AmplifyContentMeta, E as EventTrackingConfig$1, a as CDPAdapter, b as AmplifyUpConfig, c as EventProperties, I as IdentifyInput, d as IdentifyTraits, e as ProfileFieldsInput, f as AmplifyUpTarget } from './types-DUP8Lb7R.mjs';
-export { Z as ZoneConfig, i as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, g as resolveAmplifyUpUrls } from './types-DUP8Lb7R.mjs';
+import { P as PageConfig, C as ContentSource, A as AmplifyContentMeta, E as EventTrackingConfig$1, a as PageDataSnapshot, b as CDPAdapter, c as AmplifyUpConfig, d as EventProperties, e as AmplifyPageContextInput, f as AttachedPageEventContext, I as IdentifyInput, g as IdentifyTraits, h as ProfileFieldsInput, i as AmplifyUpTarget } from './types-BjlTE_cW.mjs';
+export { Z as ZoneConfig, k as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, j as resolveAmplifyUpUrls } from './types-BjlTE_cW.mjs';
 export { i as isComposerPreview, a as isPreviewRequest, b as isWorkingContentRequest } from './preview-_vHmzRen.mjs';
 export { A as AMPLIFYUP_EDITOR_ROUTE, i as isAmplifyUpEditorRoute } from './reservedRoutes-aGgViBDM.mjs';
-export { g as FetchEdgeQueryOptions, F as FetchEdgeSelectOptions, Q as QueryContentError, e as QueryContentOptions, k as QueryFilter, l as QueryFilterOp, i as QueryPagination, h as QueryResult, m as QuerySort, j as QuerySpec, S as SelectVariantsError, a as SelectVariantsOptions, b as SelectVariantsResult, c as fetchEdgeQuery, f as fetchEdgeSelect, n as nextPageSpec, q as queryContent, d as searchSpec, s as selectVariants } from './query-CraXKhi7.mjs';
+export { g as FetchEdgeQueryOptions, F as FetchEdgeSelectOptions, Q as QueryContentError, e as QueryContentOptions, k as QueryFilter, l as QueryFilterOp, i as QueryPagination, h as QueryResult, m as QuerySort, j as QuerySpec, S as SelectVariantsError, a as SelectVariantsOptions, b as SelectVariantsResult, c as fetchEdgeQuery, f as fetchEdgeSelect, n as nextPageSpec, q as queryContent, d as searchSpec, s as selectVariants } from './query-DhyG93JN.mjs';
 
 /**
  * Storage utilities for instance ID and user ID
@@ -65,6 +65,7 @@ interface EdgeResolvedPayload {
     tree?: EdgeResolvedComponent[];
     /** Composer event bindings baked into the published snapshot. */
     eventTracking?: EventTrackingConfig$1[];
+    pageData?: PageDataSnapshot;
     meta: {
         variantKeys: Record<string, string>;
         audienceLookup?: {
@@ -191,6 +192,11 @@ declare class AmplifyUpSDK {
     private pageEngagementActive;
     /** Path of the last page() / routeChange — avoids duplicate SPA fires. */
     private lastTrackedPath;
+    private pendingPageContext;
+    private attachedPageContext;
+    private resolvedPageData;
+    private resolvedPageRoute;
+    private resolvedRouteParams;
     private historyHooksInstalled;
     private pageEngagementState;
     constructor(adapter?: CDPAdapter);
@@ -250,6 +256,19 @@ declare class AmplifyUpSDK {
      */
     setupComponentViewTracking(): void;
     private cleanupComponentViewTracking;
+    /**
+     * 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: AmplifyPageContextInput): void;
+    /**
+     * Apply published pageData (from /v1/resolve) so field validation and
+     * mapped page fields can run.
+     */
+    applyResolvedPageData(pageData: PageDataSnapshot | null | undefined, pageRoute?: string, routeParams?: Record<string, string>): void;
+    private recomputeAttachedContext;
+    getAttachedPageContext(): AttachedPageEventContext | null;
     /**
      * Track a page view
      */
@@ -546,4 +565,4 @@ declare const verifyAWSConnection: () => {
 
 declare const _default: AmplifyUpSDK;
 
-export { ANON_COOKIE_NAME, AmplifyContentMeta, AmplifyUpConfig, AmplifyUpSDK, AmplifyUpTarget, CDPAdapter, ContentSource, DWELL_ACTIVITY_IDLE_MS, EdgeResolveError, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, type FetchContentOptions, type FetchContentResult, IdentifyInput, IdentifyTraits, PageConfig, ProfileFieldsInput, SESSION_COOKIE_NAME, SESSION_IDLE_GAP_MS, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchContent, fetchEdgeResolve, fetchPageConfig, getDiagnostics, getInstanceId, getOrchestratorUrl, getSDK, getSessionId, getStatus, getTarget, getTrackingId, getUserId, identify, init, mapResolvedToPageConfig, normalizeRoute, page, refreshEventTracking, reset, routeChange, setProfileFields, setupComponentViewTracking, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };
+export { ANON_COOKIE_NAME, AmplifyContentMeta, AmplifyPageContextInput, AmplifyUpConfig, AmplifyUpSDK, AmplifyUpTarget, CDPAdapter, ContentSource, DWELL_ACTIVITY_IDLE_MS, EdgeResolveError, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, type FetchContentOptions, type FetchContentResult, IdentifyInput, IdentifyTraits, PageConfig, PageDataSnapshot, ProfileFieldsInput, SESSION_COOKIE_NAME, SESSION_IDLE_GAP_MS, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchContent, fetchEdgeResolve, fetchPageConfig, getDiagnostics, getInstanceId, getOrchestratorUrl, getSDK, getSessionId, getStatus, getTarget, getTrackingId, getUserId, identify, init, mapResolvedToPageConfig, normalizeRoute, page, refreshEventTracking, reset, routeChange, setProfileFields, setupComponentViewTracking, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { P as PageConfig, C as ContentSource, A as AmplifyContentMeta, E as EventTrackingConfig$1, a as CDPAdapter, b as AmplifyUpConfig, c as EventProperties, I as IdentifyInput, d as IdentifyTraits, e as ProfileFieldsInput, f as AmplifyUpTarget } from './types-DUP8Lb7R.js';
-export { Z as ZoneConfig, i as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, g as resolveAmplifyUpUrls } from './types-DUP8Lb7R.js';
+import { P as PageConfig, C as ContentSource, A as AmplifyContentMeta, E as EventTrackingConfig$1, a as PageDataSnapshot, b as CDPAdapter, c as AmplifyUpConfig, d as EventProperties, e as AmplifyPageContextInput, f as AttachedPageEventContext, I as IdentifyInput, g as IdentifyTraits, h as ProfileFieldsInput, i as AmplifyUpTarget } from './types-BjlTE_cW.js';
+export { Z as ZoneConfig, k as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, j as resolveAmplifyUpUrls } from './types-BjlTE_cW.js';
 export { i as isComposerPreview, a as isPreviewRequest, b as isWorkingContentRequest } from './preview-_vHmzRen.js';
 export { A as AMPLIFYUP_EDITOR_ROUTE, i as isAmplifyUpEditorRoute } from './reservedRoutes-aGgViBDM.js';
-export { g as FetchEdgeQueryOptions, F as FetchEdgeSelectOptions, Q as QueryContentError, e as QueryContentOptions, k as QueryFilter, l as QueryFilterOp, i as QueryPagination, h as QueryResult, m as QuerySort, j as QuerySpec, S as SelectVariantsError, a as SelectVariantsOptions, b as SelectVariantsResult, c as fetchEdgeQuery, f as fetchEdgeSelect, n as nextPageSpec, q as queryContent, d as searchSpec, s as selectVariants } from './query-BMsorj0k.js';
+export { g as FetchEdgeQueryOptions, F as FetchEdgeSelectOptions, Q as QueryContentError, e as QueryContentOptions, k as QueryFilter, l as QueryFilterOp, i as QueryPagination, h as QueryResult, m as QuerySort, j as QuerySpec, S as SelectVariantsError, a as SelectVariantsOptions, b as SelectVariantsResult, c as fetchEdgeQuery, f as fetchEdgeSelect, n as nextPageSpec, q as queryContent, d as searchSpec, s as selectVariants } from './query-CMiGo_Kt.js';
 
 /**
  * Storage utilities for instance ID and user ID
@@ -65,6 +65,7 @@ interface EdgeResolvedPayload {
     tree?: EdgeResolvedComponent[];
     /** Composer event bindings baked into the published snapshot. */
     eventTracking?: EventTrackingConfig$1[];
+    pageData?: PageDataSnapshot;
     meta: {
         variantKeys: Record<string, string>;
         audienceLookup?: {
@@ -191,6 +192,11 @@ declare class AmplifyUpSDK {
     private pageEngagementActive;
     /** Path of the last page() / routeChange — avoids duplicate SPA fires. */
     private lastTrackedPath;
+    private pendingPageContext;
+    private attachedPageContext;
+    private resolvedPageData;
+    private resolvedPageRoute;
+    private resolvedRouteParams;
     private historyHooksInstalled;
     private pageEngagementState;
     constructor(adapter?: CDPAdapter);
@@ -250,6 +256,19 @@ declare class AmplifyUpSDK {
      */
     setupComponentViewTracking(): void;
     private cleanupComponentViewTracking;
+    /**
+     * 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: AmplifyPageContextInput): void;
+    /**
+     * Apply published pageData (from /v1/resolve) so field validation and
+     * mapped page fields can run.
+     */
+    applyResolvedPageData(pageData: PageDataSnapshot | null | undefined, pageRoute?: string, routeParams?: Record<string, string>): void;
+    private recomputeAttachedContext;
+    getAttachedPageContext(): AttachedPageEventContext | null;
     /**
      * Track a page view
      */
@@ -546,4 +565,4 @@ declare const verifyAWSConnection: () => {
 
 declare const _default: AmplifyUpSDK;
 
-export { ANON_COOKIE_NAME, AmplifyContentMeta, AmplifyUpConfig, AmplifyUpSDK, AmplifyUpTarget, CDPAdapter, ContentSource, DWELL_ACTIVITY_IDLE_MS, EdgeResolveError, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, type FetchContentOptions, type FetchContentResult, IdentifyInput, IdentifyTraits, PageConfig, ProfileFieldsInput, SESSION_COOKIE_NAME, SESSION_IDLE_GAP_MS, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchContent, fetchEdgeResolve, fetchPageConfig, getDiagnostics, getInstanceId, getOrchestratorUrl, getSDK, getSessionId, getStatus, getTarget, getTrackingId, getUserId, identify, init, mapResolvedToPageConfig, normalizeRoute, page, refreshEventTracking, reset, routeChange, setProfileFields, setupComponentViewTracking, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };
+export { ANON_COOKIE_NAME, AmplifyContentMeta, AmplifyPageContextInput, AmplifyUpConfig, AmplifyUpSDK, AmplifyUpTarget, CDPAdapter, ContentSource, DWELL_ACTIVITY_IDLE_MS, EdgeResolveError, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, type FetchContentOptions, type FetchContentResult, IdentifyInput, IdentifyTraits, PageConfig, PageDataSnapshot, ProfileFieldsInput, SESSION_COOKIE_NAME, SESSION_IDLE_GAP_MS, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchContent, fetchEdgeResolve, fetchPageConfig, getDiagnostics, getInstanceId, getOrchestratorUrl, getSDK, getSessionId, getStatus, getTarget, getTrackingId, getUserId, identify, init, mapResolvedToPageConfig, normalizeRoute, page, refreshEventTracking, reset, routeChange, setProfileFields, setupComponentViewTracking, setupEventTracking, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };

package/dist/index.js

@@ -398,6 +398,153 @@ 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) {
@@ -523,7 +670,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) {
@@ -813,6 +961,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(),
@@ -975,8 +1128,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,
@@ -1333,6 +1491,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
    */
@@ -1354,7 +1549,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;
@@ -1378,7 +1573,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;