@amplifyup/sdk 0.1.74 → 0.1.75

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 PageDataSnapshot, R as ResolvedPageResourceRef, 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-BGZYaFxP.mjs';
-export { Z as ZoneConfig, k as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, j as resolveAmplifyUpUrls } from './types-BGZYaFxP.mjs';
+import { P as PageConfig, C as ContentSource, A as AmplifyContentMeta, E as EventTrackingConfig$1, a as PageDataSnapshot, R as ResolvedPageResourceRef, b as PageTaxonomies, c as CDPAdapter, d as AmplifyUpConfig, e as EventProperties, f as AmplifyPageContextInput, g as AttachedPageEventContext, I as IdentifyInput, h as IdentifyTraits, i as ProfileFieldsInput, j as AmplifyUpTarget } from './types-D4TSd2Yt.mjs';
+export { Z as ZoneConfig, l as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, k as resolveAmplifyUpUrls } from './types-D4TSd2Yt.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-_SMo6VRf.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-CV8x3oQT.mjs';
 
 /**
  * Storage utilities for instance ID and user ID
@@ -73,6 +73,8 @@ interface EdgeResolvedPayload {
     pageData?: PageDataSnapshot;
     /** resource name → document this URL resolved to. */
     pageResources?: Record<string, ResolvedPageResourceRef>;
+    /** taxonomy key → term ids this page is tagged with. */
+    pageTaxonomies?: PageTaxonomies;
     meta: {
         variantKeys: Record<string, string>;
         audienceLookup?: {
@@ -205,6 +207,12 @@ declare class AmplifyUpSDK {
     private resolvedPageResource;
     private resolvedPageRoute;
     private resolvedRouteParams;
+    /** Path whose delivery response is in flight; page_view for it is held. */
+    private pendingResolvePath;
+    private heldPageView;
+    private resolvedPageTaxonomies;
+    /** Path the taxonomies above were resolved for. */
+    private resolvedTaxonomiesPath;
     private historyHooksInstalled;
     private pageEngagementState;
     constructor(adapter?: CDPAdapter);
@@ -274,15 +282,24 @@ declare class AmplifyUpSDK {
      * 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>, pageResources?: Record<string, ResolvedPageResourceRef> | null): void;
+    applyResolvedPageData(pageData: PageDataSnapshot | null | undefined, pageRoute?: string, routeParams?: Record<string, string>, pageResources?: Record<string, ResolvedPageResourceRef> | null, pageTaxonomies?: PageTaxonomies | null): void;
     private recomputeAttachedContext;
     /** Stamp the resolved entry onto the context so events carry it. */
     private withPageResource;
     getAttachedPageContext(): AttachedPageEventContext | null;
+    /**
+     * The page's delivery response for `path` is on its way. A page_view for the
+     * same path waits for it (up to PAGE_VIEW_HOLD_MS) so it carries the page's
+     * taxonomies.
+     */
+    beginPageResolve(path: string): void;
+    endPageResolve(path: string): void;
+    private flushHeldPageView;
     /**
      * Track a page view
      */
     page(url: string, properties?: EventProperties): void;
+    private sendPageView;
     /**
      * Track an event
      */
@@ -576,4 +593,4 @@ declare const verifyAWSConnection: () => {
 
 declare const _default: AmplifyUpSDK;
 
-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 };
+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, PageTaxonomies, 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 PageDataSnapshot, R as ResolvedPageResourceRef, 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-BGZYaFxP.js';
-export { Z as ZoneConfig, k as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, j as resolveAmplifyUpUrls } from './types-BGZYaFxP.js';
+import { P as PageConfig, C as ContentSource, A as AmplifyContentMeta, E as EventTrackingConfig$1, a as PageDataSnapshot, R as ResolvedPageResourceRef, b as PageTaxonomies, c as CDPAdapter, d as AmplifyUpConfig, e as EventProperties, f as AmplifyPageContextInput, g as AttachedPageEventContext, I as IdentifyInput, h as IdentifyTraits, i as ProfileFieldsInput, j as AmplifyUpTarget } from './types-D4TSd2Yt.js';
+export { Z as ZoneConfig, l as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, k as resolveAmplifyUpUrls } from './types-D4TSd2Yt.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-NcrxJQvI.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-B23UsNIv.js';
 
 /**
  * Storage utilities for instance ID and user ID
@@ -73,6 +73,8 @@ interface EdgeResolvedPayload {
     pageData?: PageDataSnapshot;
     /** resource name → document this URL resolved to. */
     pageResources?: Record<string, ResolvedPageResourceRef>;
+    /** taxonomy key → term ids this page is tagged with. */
+    pageTaxonomies?: PageTaxonomies;
     meta: {
         variantKeys: Record<string, string>;
         audienceLookup?: {
@@ -205,6 +207,12 @@ declare class AmplifyUpSDK {
     private resolvedPageResource;
     private resolvedPageRoute;
     private resolvedRouteParams;
+    /** Path whose delivery response is in flight; page_view for it is held. */
+    private pendingResolvePath;
+    private heldPageView;
+    private resolvedPageTaxonomies;
+    /** Path the taxonomies above were resolved for. */
+    private resolvedTaxonomiesPath;
     private historyHooksInstalled;
     private pageEngagementState;
     constructor(adapter?: CDPAdapter);
@@ -274,15 +282,24 @@ declare class AmplifyUpSDK {
      * 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>, pageResources?: Record<string, ResolvedPageResourceRef> | null): void;
+    applyResolvedPageData(pageData: PageDataSnapshot | null | undefined, pageRoute?: string, routeParams?: Record<string, string>, pageResources?: Record<string, ResolvedPageResourceRef> | null, pageTaxonomies?: PageTaxonomies | null): void;
     private recomputeAttachedContext;
     /** Stamp the resolved entry onto the context so events carry it. */
     private withPageResource;
     getAttachedPageContext(): AttachedPageEventContext | null;
+    /**
+     * The page's delivery response for `path` is on its way. A page_view for the
+     * same path waits for it (up to PAGE_VIEW_HOLD_MS) so it carries the page's
+     * taxonomies.
+     */
+    beginPageResolve(path: string): void;
+    endPageResolve(path: string): void;
+    private flushHeldPageView;
     /**
      * Track a page view
      */
     page(url: string, properties?: EventProperties): void;
+    private sendPageView;
     /**
      * Track an event
      */
@@ -576,4 +593,4 @@ declare const verifyAWSConnection: () => {
 
 declare const _default: AmplifyUpSDK;
 
-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 };
+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, PageTaxonomies, 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

@@ -747,6 +747,7 @@ function applyPageContext(input, opts) {
   }
   const pageFields = {};
   for (const pf of opts.pageData?.pageFields || []) {
+    if (pf.dataType === "taxonomy") continue;
     if (pf.source === "static") {
       if (pf.value !== void 0) pageFields[pf.key] = pf.value;
       continue;
@@ -769,6 +770,7 @@ function applyPageContext(input, opts) {
 function staticPageFieldsFromSnapshot(pageData) {
   const pageFields = {};
   for (const pf of pageData?.pageFields || []) {
+    if (pf.dataType === "taxonomy") continue;
     if (pf.source === "static" && pf.value !== void 0) {
       pageFields[pf.key] = pf.value;
     }
@@ -786,6 +788,11 @@ function attachStaticPageContext(pageData, pageRoute) {
     pageRoute: pageRoute || ""
   };
 }
+function withPageTaxonomies(properties, taxonomies) {
+  if (!taxonomies || Object.keys(taxonomies).length === 0) return properties;
+  const page2 = properties.page && typeof properties.page === "object" && !Array.isArray(properties.page) ? properties.page : { fields: {} };
+  return { ...properties, page: { ...page2, taxonomies } };
+}
 function mergeEventContext(properties, attached) {
   if (!attached) return properties;
   return {
@@ -796,6 +803,27 @@ function mergeEventContext(properties, attached) {
     ...attached.pageResource ? { pageResource: attached.pageResource } : {}
   };
 }
+
+// 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 || "/";
+}
 function setPageResourceFields(fields) {
 }
 
@@ -873,27 +901,6 @@ 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();
-  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/variantKeys.ts
 function serializeVariantKeys(keys) {
   if (!keys) return "";
@@ -1015,7 +1022,8 @@ function mapResolvedToPageConfig(payload) {
     },
     ...payload.eventTracking && payload.eventTracking.length > 0 ? { eventTracking: payload.eventTracking } : {},
     ...payload.pageData ? { pageData: payload.pageData } : {},
-    ...payload.pageResources ? { pageResources: payload.pageResources } : {}
+    ...payload.pageResources ? { pageResources: payload.pageResources } : {},
+    ...payload.pageTaxonomies ? { pageTaxonomies: payload.pageTaxonomies } : {}
   };
 }
 function collectDegraded(payload) {
@@ -1247,6 +1255,7 @@ function searchSpec(pagination, field, term) {
 }
 
 // src/index.ts
+var PAGE_VIEW_HOLD_MS = 1500;
 var DWELL_ACTIVITY_IDLE_MS = 2 * 60 * 1e3;
 var DWELL_POLL_MS = 5e3;
 function readPreviewQueryOverrides() {
@@ -1320,6 +1329,12 @@ var AmplifyUpSDK = class {
     this.resolvedPageResource = null;
     this.resolvedPageRoute = "";
     this.resolvedRouteParams = {};
+    /** Path whose delivery response is in flight; page_view for it is held. */
+    this.pendingResolvePath = null;
+    this.heldPageView = null;
+    this.resolvedPageTaxonomies = null;
+    /** Path the taxonomies above were resolved for. */
+    this.resolvedTaxonomiesPath = null;
     this.historyHooksInstalled = false;
     this.pageEngagementState = {
       reached: /* @__PURE__ */ new Set(),
@@ -1850,8 +1865,10 @@ var AmplifyUpSDK = class {
    * Apply published pageData (from /v1/resolve) so field validation and
    * mapped page fields can run.
    */
-  applyResolvedPageData(pageData, pageRoute, routeParams, pageResources) {
+  applyResolvedPageData(pageData, pageRoute, routeParams, pageResources, pageTaxonomies) {
     this.resolvedPageData = pageData || null;
+    this.resolvedPageTaxonomies = pageTaxonomies || null;
+    this.resolvedTaxonomiesPath = this.pendingResolvePath;
     if (pageRoute) this.resolvedPageRoute = pageRoute;
     if (routeParams) this.resolvedRouteParams = routeParams;
     const firstResourceName = pageData?.resources?.[0]?.name;
@@ -1884,6 +1901,28 @@ var AmplifyUpSDK = class {
   getAttachedPageContext() {
     return this.attachedPageContext;
   }
+  /**
+   * The page's delivery response for `path` is on its way. A page_view for the
+   * same path waits for it (up to PAGE_VIEW_HOLD_MS) so it carries the page's
+   * taxonomies.
+   */
+  beginPageResolve(path) {
+    this.pendingResolvePath = normalizeRoute(path);
+    this.resolvedPageTaxonomies = null;
+    this.resolvedTaxonomiesPath = null;
+  }
+  endPageResolve(path) {
+    if (this.pendingResolvePath !== normalizeRoute(path)) return;
+    this.pendingResolvePath = null;
+    this.flushHeldPageView();
+  }
+  flushHeldPageView() {
+    const held = this.heldPageView;
+    if (!held) return;
+    clearTimeout(held.timer);
+    this.heldPageView = null;
+    this.sendPageView(held.url, held.properties);
+  }
   /**
    * Track a page view
    */
@@ -1894,6 +1933,21 @@ var AmplifyUpSDK = class {
     if (!this.isInitialized()) {
       return;
     }
+    this.lastTrackedPath = url;
+    if (this.pendingResolvePath && this.pendingResolvePath === normalizeRoute(url)) {
+      this.flushHeldPageView();
+      this.heldPageView = {
+        url,
+        properties,
+        timer: setTimeout(() => this.flushHeldPageView(), PAGE_VIEW_HOLD_MS)
+      };
+      return;
+    }
+    this.flushHeldPageView();
+    this.sendPageView(url, properties);
+  }
+  sendPageView(url, properties) {
+    const taxonomies = this.resolvedTaxonomiesPath && this.resolvedTaxonomiesPath === normalizeRoute(url) ? this.resolvedPageTaxonomies : null;
     const instanceId = getInstanceId();
     const sessionId = getSessionId();
     const pageProperties = {
@@ -1905,10 +1959,9 @@ var AmplifyUpSDK = class {
       sessionId,
       trackingId: this.config?.trackingId,
       // Timestamp is included in event payload
-      ...mergeEventContext(properties || {}, this.attachedPageContext)
+      ...withPageTaxonomies(mergeEventContext(properties || {}, this.attachedPageContext), taxonomies)
     };
     this.adapter.page(pageProperties);
-    this.lastTrackedPath = url;
   }
   /**
    * Track an event