@amplifyup/sdk 0.1.40 → 0.1.41

package/dist/index.d.mts

@@ -1,7 +1,17 @@
-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-CBoVIFI8.mjs';
-export { Z as ZoneConfig, i as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, g as resolveAmplifyUpUrls } from './types-CBoVIFI8.mjs';
+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';
 export { i as isComposerPreview, a as isPreviewRequest, b as isWorkingContentRequest } from './preview-_vHmzRen.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-6BmINKLR.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';
+
+/**
+ * Storage utilities for instance ID and user ID
+ */
+/** First-party cookie so Next middleware can SSR/ISR personalized variants. */
+declare const ANON_COOKIE_NAME = "amplifyup_anon_id";
+/** First-party session cookie — same pattern as visitor id; 30-minute inactivity. */
+declare const SESSION_COOKIE_NAME = "amplifyup_session_id";
+/** Idle gap that starts a new session. Keep aligned with orchestrator SESSION_GAP_MS. */
+declare const SESSION_IDLE_GAP_MS: number;
 
 interface FetchContentResult {
     pageConfig: PageConfig | null;
@@ -13,6 +23,7 @@ interface FetchContentOptions {
     route: string;
     trackingId: string;
     anonId?: string | null;
+    sessionId?: string | null;
     siteId?: string | null;
     /** Force preview (Composer); otherwise uses isComposerPreview() in browser. */
     preview?: boolean;
@@ -84,6 +95,7 @@ declare function fetchEdgeResolve(options: {
     trackingId: string;
     route: string;
     anonId?: string | null;
+    sessionId?: string | null;
     siteId?: string | null;
     /** Deterministic variant combo — cacheable; do not send with anonId. */
     variantKeys?: Record<string, string> | null;
@@ -117,11 +129,6 @@ declare function normalizeRoute(route: string): string;
  * All runtime data (events, profiles, decisions) lives in AWS.
  */
 
-/**
- * Idle gap that starts a new logical visit when a tab is reactivated.
- * Must stay aligned with SESSION_GAP_MS in apps/orchestrator/lib/aws-profiles.ts.
- */
-declare const SESSION_IDLE_GAP_MS: number;
 /**
  * Time on Page: one event per page visit, sent when the visit ends
  * (SPA navigation, tab close, or 30-minute idle resume). Switching tabs
@@ -290,6 +297,10 @@ declare class AmplifyUpSDK {
      * Get instance ID (anonymous ID)
      */
     getInstanceId(): string;
+    /**
+     * Get session id (30-minute inactivity reset).
+     */
+    getSessionId(): string;
     /**
      * Get user ID
      */
@@ -487,6 +498,7 @@ declare const setProfileFields: (fields: ProfileFieldsInput) => void;
 declare const trackContentEngagement: (contentId: string, engagementType: "view" | "click" | "dismiss") => void;
 declare const reset: () => void;
 declare const getInstanceId: () => string;
+declare const getSessionId: () => string;
 declare const getUserId: () => string | null;
 declare const getTrackingId: () => string | undefined;
 declare const getTarget: () => AmplifyUpTarget;
@@ -533,4 +545,4 @@ declare const verifyAWSConnection: () => {
 
 declare const _default: AmplifyUpSDK;
 
-export { 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_IDLE_GAP_MS, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchContent, fetchEdgeResolve, fetchPageConfig, getDiagnostics, getInstanceId, getOrchestratorUrl, getSDK, 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, 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 };

package/dist/index.d.ts

@@ -1,7 +1,17 @@
-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-CBoVIFI8.js';
-export { Z as ZoneConfig, i as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, g as resolveAmplifyUpUrls } from './types-CBoVIFI8.js';
+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';
 export { i as isComposerPreview, a as isPreviewRequest, b as isWorkingContentRequest } from './preview-_vHmzRen.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-DjIuJ71C.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';
+
+/**
+ * Storage utilities for instance ID and user ID
+ */
+/** First-party cookie so Next middleware can SSR/ISR personalized variants. */
+declare const ANON_COOKIE_NAME = "amplifyup_anon_id";
+/** First-party session cookie — same pattern as visitor id; 30-minute inactivity. */
+declare const SESSION_COOKIE_NAME = "amplifyup_session_id";
+/** Idle gap that starts a new session. Keep aligned with orchestrator SESSION_GAP_MS. */
+declare const SESSION_IDLE_GAP_MS: number;
 
 interface FetchContentResult {
     pageConfig: PageConfig | null;
@@ -13,6 +23,7 @@ interface FetchContentOptions {
     route: string;
     trackingId: string;
     anonId?: string | null;
+    sessionId?: string | null;
     siteId?: string | null;
     /** Force preview (Composer); otherwise uses isComposerPreview() in browser. */
     preview?: boolean;
@@ -84,6 +95,7 @@ declare function fetchEdgeResolve(options: {
     trackingId: string;
     route: string;
     anonId?: string | null;
+    sessionId?: string | null;
     siteId?: string | null;
     /** Deterministic variant combo — cacheable; do not send with anonId. */
     variantKeys?: Record<string, string> | null;
@@ -117,11 +129,6 @@ declare function normalizeRoute(route: string): string;
  * All runtime data (events, profiles, decisions) lives in AWS.
  */
 
-/**
- * Idle gap that starts a new logical visit when a tab is reactivated.
- * Must stay aligned with SESSION_GAP_MS in apps/orchestrator/lib/aws-profiles.ts.
- */
-declare const SESSION_IDLE_GAP_MS: number;
 /**
  * Time on Page: one event per page visit, sent when the visit ends
  * (SPA navigation, tab close, or 30-minute idle resume). Switching tabs
@@ -290,6 +297,10 @@ declare class AmplifyUpSDK {
      * Get instance ID (anonymous ID)
      */
     getInstanceId(): string;
+    /**
+     * Get session id (30-minute inactivity reset).
+     */
+    getSessionId(): string;
     /**
      * Get user ID
      */
@@ -487,6 +498,7 @@ declare const setProfileFields: (fields: ProfileFieldsInput) => void;
 declare const trackContentEngagement: (contentId: string, engagementType: "view" | "click" | "dismiss") => void;
 declare const reset: () => void;
 declare const getInstanceId: () => string;
+declare const getSessionId: () => string;
 declare const getUserId: () => string | null;
 declare const getTrackingId: () => string | undefined;
 declare const getTarget: () => AmplifyUpTarget;
@@ -533,4 +545,4 @@ declare const verifyAWSConnection: () => {
 
 declare const _default: AmplifyUpSDK;
 
-export { 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_IDLE_GAP_MS, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchContent, fetchEdgeResolve, fetchPageConfig, getDiagnostics, getInstanceId, getOrchestratorUrl, getSDK, 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, 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 };

package/dist/index.js

@@ -95,6 +95,7 @@ var AWSAdapter = class {
     const eventData = {
       type: "page",
       anonymousId: properties.instanceId,
+      sessionId: properties.sessionId,
       userId: properties.userId,
       properties: {
         path: properties.path || properties.url,
@@ -137,6 +138,7 @@ var AWSAdapter = class {
       type: "track",
       event: eventName,
       anonymousId: properties.instanceId,
+      sessionId: properties.sessionId,
       userId: properties.userId,
       properties: {
         ...properties
@@ -159,6 +161,7 @@ var AWSAdapter = class {
     const eventData = {
       type: "identify",
       anonymousId: traits.instanceId,
+      sessionId: traits.sessionId,
       traits: {
         ...traits,
         ...identifiers ? { identifiers } : {}
@@ -177,6 +180,7 @@ var AWSAdapter = class {
     const eventData = {
       type: "set_fields",
       anonymousId: context.instanceId,
+      sessionId: context.sessionId,
       fields,
       traits: {
         instanceId: context.instanceId,
@@ -199,7 +203,11 @@ var AWSAdapter = class {
 // src/storage.ts
 var INSTANCE_ID_KEY = "amplifyup_instance_id";
 var USER_ID_KEY = "amplifyup_user_id";
+var SESSION_ID_KEY = "amplifyup_session_id";
+var SESSION_ACTIVITY_KEY = "amplifyup_session_activity";
 var ANON_COOKIE_NAME = "amplifyup_anon_id";
+var SESSION_COOKIE_NAME = "amplifyup_session_id";
+var SESSION_IDLE_GAP_MS = 30 * 60 * 1e3;
 function generateGuid() {
   if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
     return crypto.randomUUID();
@@ -226,9 +234,9 @@ function readCookie(name) {
   }
   return null;
 }
-function writeCookie(name, value) {
+function writeCookie(name, value, maxAgeSeconds = 31536e3) {
   if (typeof document === "undefined") return;
-  document.cookie = `${name}=${encodeURIComponent(value)}; Path=/; Max-Age=31536000; SameSite=Lax`;
+  document.cookie = `${name}=${encodeURIComponent(value)}; Path=/; Max-Age=${maxAgeSeconds}; SameSite=Lax`;
 }
 function getInstanceId() {
   if (typeof window === "undefined") {
@@ -251,6 +259,23 @@ function getUserId() {
   }
   return localStorage.getItem(USER_ID_KEY);
 }
+function getSessionId() {
+  if (typeof window === "undefined") {
+    return "";
+  }
+  const now = Date.now();
+  const lastActivity = Number(localStorage.getItem(SESSION_ACTIVITY_KEY) || 0);
+  const fromCookie = readCookie(SESSION_COOKIE_NAME);
+  const fromLs = localStorage.getItem(SESSION_ID_KEY);
+  let sessionId = fromLs || fromCookie || "";
+  if (!sessionId || lastActivity > 0 && now - lastActivity >= SESSION_IDLE_GAP_MS) {
+    sessionId = generateGuid();
+  }
+  localStorage.setItem(SESSION_ID_KEY, sessionId);
+  localStorage.setItem(SESSION_ACTIVITY_KEY, String(now));
+  writeCookie(SESSION_COOKIE_NAME, sessionId, Math.floor(SESSION_IDLE_GAP_MS / 1e3));
+  return sessionId;
+}
 function setUserId(userId) {
   if (typeof window === "undefined") {
     return;
@@ -263,7 +288,10 @@ function clearIds() {
   }
   localStorage.removeItem(INSTANCE_ID_KEY);
   localStorage.removeItem(USER_ID_KEY);
+  localStorage.removeItem(SESSION_ID_KEY);
+  localStorage.removeItem(SESSION_ACTIVITY_KEY);
   document.cookie = `${ANON_COOKIE_NAME}=; Path=/; Max-Age=0; SameSite=Lax`;
+  document.cookie = `${SESSION_COOKIE_NAME}=; Path=/; Max-Age=0; SameSite=Lax`;
 }
 
 // src/targets.ts
@@ -426,6 +454,7 @@ async function fetchEdgeResolve(options) {
     params.set("variants", variantParam);
   } else if (options.anonId) {
     params.set("anonId", options.anonId);
+    if (options.sessionId) params.set("sessionId", options.sessionId);
   }
   const fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
   const init2 = {
@@ -527,6 +556,7 @@ async function fetchContent(options) {
       trackingId: options.trackingId,
       route: options.route,
       anonId: options.variantKeys ? void 0 : options.anonId,
+      sessionId: options.variantKeys ? void 0 : options.sessionId,
       siteId: options.siteId,
       fetch: options.fetchFn,
       revalidate: options.revalidate,
@@ -596,6 +626,7 @@ async function fetchEdgeSelect(options) {
       ...options.trackingId ? { trackingId: options.trackingId } : {},
       ...options.site ? { site: options.site } : {},
       anonId: options.anonId,
+      ...options.sessionId ? { sessionId: options.sessionId } : {},
       ...options.zones?.length ? { zones: options.zones } : {},
       ...options.context ? { context: options.context } : {}
     })
@@ -624,6 +655,7 @@ async function selectVariants(options) {
     site: options.site,
     view: options.view,
     anonId: options.anonId,
+    sessionId: options.sessionId,
     zones: options.zones,
     context: options.context,
     fetch: options.fetch,
@@ -708,7 +740,6 @@ function searchSpec(pagination, field, term) {
 }
 
 // src/index.ts
-var SESSION_IDLE_GAP_MS = 30 * 60 * 1e3;
 var DWELL_ACTIVITY_IDLE_MS = 2 * 60 * 1e3;
 var DWELL_POLL_MS = 5e3;
 function readPreviewQueryOverrides() {
@@ -884,6 +915,7 @@ var AmplifyUpSDK = class {
     if (typeof window === "undefined") return;
     window.AmplifyUp = {
       getInstanceId: () => this.getInstanceId(),
+      getSessionId: () => this.getSessionId(),
       getUserId: () => this.getUserId(),
       getTrackingId: () => this.getTrackingId(),
       getTarget: () => this.getTarget(),
@@ -1306,12 +1338,14 @@ var AmplifyUpSDK = class {
       return;
     }
     const instanceId = getInstanceId();
+    const sessionId = getSessionId();
     const pageProperties = {
       name: url,
       path: url,
       url: typeof window !== "undefined" ? window.location.href : url,
       referrer: typeof document !== "undefined" ? document.referrer : void 0,
       instanceId,
+      sessionId,
       trackingId: this.config?.trackingId,
       // Timestamp is included in event payload
       ...properties
@@ -1330,8 +1364,10 @@ var AmplifyUpSDK = class {
       return;
     }
     const instanceId = getInstanceId();
+    const sessionId = getSessionId();
     const trackProperties = {
       instanceId,
+      sessionId,
       trackingId: this.config?.trackingId,
       url: typeof window !== "undefined" ? window.location.href : void 0,
       path: properties?.path || (typeof window !== "undefined" ? window.location.pathname : void 0),
@@ -1404,8 +1440,10 @@ var AmplifyUpSDK = class {
       return;
     }
     const instanceId = getInstanceId();
+    const sessionId = getSessionId();
     const identifyTraits = {
       instanceId,
+      sessionId,
       trackingId: this.config?.trackingId,
       ...traits
     };
@@ -1443,6 +1481,7 @@ var AmplifyUpSDK = class {
     if (typeof this.adapter.setProfileFields === "function") {
       this.adapter.setProfileFields(fields, {
         instanceId: instanceId || void 0,
+        sessionId: getSessionId() || void 0,
         trackingId: this.config?.trackingId
       });
     }
@@ -1493,6 +1532,12 @@ var AmplifyUpSDK = class {
   getInstanceId() {
     return getInstanceId();
   }
+  /**
+   * Get session id (30-minute inactivity reset).
+   */
+  getSessionId() {
+    return getSessionId();
+  }
   /**
    * Get user ID
    */
@@ -3014,6 +3059,7 @@ var setProfileFields = (fields) => getSDK().setProfileFields(fields);
 var trackContentEngagement = (contentId, engagementType) => getSDK().trackContentEngagement(contentId, engagementType);
 var reset = () => getSDK().reset();
 var getInstanceId2 = () => getSDK().getInstanceId();
+var getSessionId2 = () => getSDK().getSessionId();
 var getUserId2 = () => getSDK().getUserId();
 var getTrackingId = () => getSDK().getTrackingId();
 var getTarget = () => getSDK().getTarget();
@@ -3040,10 +3086,12 @@ var verifyAWSConnection = () => {
 };
 var index_default = getSDK();
 
+exports.ANON_COOKIE_NAME = ANON_COOKIE_NAME;
 exports.AmplifyUpSDK = AmplifyUpSDK;
 exports.DWELL_ACTIVITY_IDLE_MS = DWELL_ACTIVITY_IDLE_MS;
 exports.EdgeResolveError = EdgeResolveError;
 exports.QueryContentError = QueryContentError;
+exports.SESSION_COOKIE_NAME = SESSION_COOKIE_NAME;
 exports.SESSION_IDLE_GAP_MS = SESSION_IDLE_GAP_MS;
 exports.SelectVariantsError = SelectVariantsError;
 exports.buildLayoutProviderUrl = buildLayoutProviderUrl;
@@ -3059,6 +3107,7 @@ exports.getDiagnostics = getDiagnostics;
 exports.getInstanceId = getInstanceId2;
 exports.getOrchestratorUrl = getOrchestratorUrl;
 exports.getSDK = getSDK;
+exports.getSessionId = getSessionId2;
 exports.getStatus = getStatus;
 exports.getTarget = getTarget;
 exports.getTrackingId = getTrackingId;