@amplifyup/sdk 0.1.33 → 0.1.35

package/dist/index.d.mts

@@ -1,6 +1,7 @@
-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-npF_lNoq.mjs';
-export { Z as ZoneConfig, i as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, g as resolveAmplifyUpUrls } from './types-npF_lNoq.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-CBoVIFI8.mjs';
+export { Z as ZoneConfig, i as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, g as resolveAmplifyUpUrls } from './types-CBoVIFI8.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';
 
 interface FetchContentResult {
     pageConfig: PageConfig | null;
@@ -20,6 +21,10 @@ interface FetchContentOptions {
     /** Orchestrator layout fetch (SDK instance method or server helper). */
     fetchOrchestratorPage: (route: string, preview: boolean) => Promise<PageConfig | null>;
     fetchFn?: typeof fetch;
+    /** Next.js ISR for Edge resolve (server/SSG only). */
+    revalidate?: number | false;
+    /** Deterministic variants for ISR (no visitor id in the cache key). */
+    variantKeys?: Record<string, string> | null;
 }
 /**
  * Single content entry point:
@@ -80,7 +85,14 @@ declare function fetchEdgeResolve(options: {
     route: string;
     anonId?: string | null;
     siteId?: string | null;
+    /** Deterministic variant combo — cacheable; do not send with anonId. */
+    variantKeys?: Record<string, string> | null;
     fetch?: typeof fetch;
+    /**
+     * Next.js Data Cache / ISR. When set, the server fetch can be baked into
+     * SSG. Omit on the client so visitor-specific resolve stays fresh.
+     */
+    revalidate?: number | false;
 }): Promise<EdgeResolvedPayload>;
 
 /**

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-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-npF_lNoq.js';
-export { Z as ZoneConfig, i as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, g as resolveAmplifyUpUrls } from './types-npF_lNoq.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-CBoVIFI8.js';
+export { Z as ZoneConfig, i as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, g as resolveAmplifyUpUrls } from './types-CBoVIFI8.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';
 
 interface FetchContentResult {
     pageConfig: PageConfig | null;
@@ -20,6 +21,10 @@ interface FetchContentOptions {
     /** Orchestrator layout fetch (SDK instance method or server helper). */
     fetchOrchestratorPage: (route: string, preview: boolean) => Promise<PageConfig | null>;
     fetchFn?: typeof fetch;
+    /** Next.js ISR for Edge resolve (server/SSG only). */
+    revalidate?: number | false;
+    /** Deterministic variants for ISR (no visitor id in the cache key). */
+    variantKeys?: Record<string, string> | null;
 }
 /**
  * Single content entry point:
@@ -80,7 +85,14 @@ declare function fetchEdgeResolve(options: {
     route: string;
     anonId?: string | null;
     siteId?: string | null;
+    /** Deterministic variant combo — cacheable; do not send with anonId. */
+    variantKeys?: Record<string, string> | null;
     fetch?: typeof fetch;
+    /**
+     * Next.js Data Cache / ISR. When set, the server fetch can be baked into
+     * SSG. Omit on the client so visitor-specific resolve stays fresh.
+     */
+    revalidate?: number | false;
 }): Promise<EdgeResolvedPayload>;
 
 /**

package/dist/index.js

@@ -199,6 +199,7 @@ var AWSAdapter = class {
 // src/storage.ts
 var INSTANCE_ID_KEY = "amplifyup_instance_id";
 var USER_ID_KEY = "amplifyup_user_id";
+var ANON_COOKIE_NAME = "amplifyup_anon_id";
 function generateGuid() {
   if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
     return crypto.randomUUID();
@@ -209,16 +210,39 @@ function generateGuid() {
     return v.toString(16);
   });
 }
+function readCookie(name) {
+  if (typeof document === "undefined") return null;
+  const parts = document.cookie.split(";");
+  for (const part of parts) {
+    const idx = part.indexOf("=");
+    if (idx === -1) continue;
+    if (part.slice(0, idx).trim() !== name) continue;
+    const value = part.slice(idx + 1).trim();
+    try {
+      return value ? decodeURIComponent(value) : null;
+    } catch {
+      return value || null;
+    }
+  }
+  return null;
+}
+function writeCookie(name, value) {
+  if (typeof document === "undefined") return;
+  document.cookie = `${name}=${encodeURIComponent(value)}; Path=/; Max-Age=31536000; SameSite=Lax`;
+}
 function getInstanceId() {
   if (typeof window === "undefined") {
     return "";
   }
-  const stored = localStorage.getItem(INSTANCE_ID_KEY);
-  if (stored) {
-    return stored;
+  const fromCookie = readCookie(ANON_COOKIE_NAME);
+  const fromLs = localStorage.getItem(INSTANCE_ID_KEY);
+  const instanceId = fromLs || fromCookie || `browser_${generateGuid()}`;
+  if (fromLs !== instanceId) {
+    localStorage.setItem(INSTANCE_ID_KEY, instanceId);
+  }
+  if (fromCookie !== instanceId) {
+    writeCookie(ANON_COOKIE_NAME, instanceId);
   }
-  const instanceId = `browser_${generateGuid()}`;
-  localStorage.setItem(INSTANCE_ID_KEY, instanceId);
   return instanceId;
 }
 function getUserId() {
@@ -239,6 +263,7 @@ function clearIds() {
   }
   localStorage.removeItem(INSTANCE_ID_KEY);
   localStorage.removeItem(USER_ID_KEY);
+  document.cookie = `${ANON_COOKIE_NAME}=; Path=/; Max-Age=0; SameSite=Lax`;
 }
 
 // src/targets.ts
@@ -366,6 +391,19 @@ function normalizeRoute(route) {
   return path || "/";
 }
 
+// src/edge/variantKeys.ts
+function serializeVariantKeys(keys) {
+  if (!keys) return "";
+  const parts = [];
+  const zoneIds = Object.keys(keys).sort();
+  for (const zoneId of zoneIds) {
+    const variant = keys[zoneId];
+    if (!variant || variant === "default") continue;
+    parts.push(`${zoneId}:${variant}`);
+  }
+  return parts.join(",");
+}
+
 // src/edge/resolve.ts
 var EdgeResolveError = class extends Error {
   constructor(message, status, body) {
@@ -383,12 +421,23 @@ async function fetchEdgeResolve(options) {
     trackingId: options.trackingId
   });
   if (options.siteId) params.set("site", options.siteId);
-  if (options.anonId) params.set("anonId", options.anonId);
+  const variantParam = serializeVariantKeys(options.variantKeys);
+  if (variantParam) {
+    params.set("variants", variantParam);
+  } else 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()}`, {
+  const init2 = {
     method: "GET",
     headers: { Accept: "application/json" }
-  });
+  };
+  if (options.revalidate !== void 0) {
+    init2.next = { revalidate: options.revalidate };
+  } else {
+    init2.cache = "no-store";
+  }
+  const res = await fetchFn(`${base}/v1/resolve?${params.toString()}`, init2);
   const body = await res.json().catch(() => ({}));
   if (!res.ok) {
     throw new EdgeResolveError(
@@ -477,9 +526,11 @@ async function fetchContent(options) {
       edgeUrl: options.edgeUrl,
       trackingId: options.trackingId,
       route: options.route,
-      anonId: options.anonId,
+      anonId: options.variantKeys ? void 0 : options.anonId,
       siteId: options.siteId,
-      fetch: options.fetchFn
+      fetch: options.fetchFn,
+      revalidate: options.revalidate,
+      variantKeys: options.variantKeys
     });
     const pageConfig = mapResolvedToPageConfig(payload);
     const degraded = collectDegraded(payload);
@@ -517,6 +568,145 @@ async function fetchContent(options) {
   }
 }
 
+// src/edge/select.ts
+var SelectVariantsError = class extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.name = "SelectVariantsError";
+    this.status = status;
+    this.body = body;
+  }
+};
+async function fetchEdgeSelect(options) {
+  const base = options.edgeUrl.replace(/\/+$/, "");
+  const fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
+  if (!options.trackingId && !options.site) {
+    throw new SelectVariantsError("trackingId or site is required", 400);
+  }
+  const res = await fetchFn(`${base}/v1/select`, {
+    method: "POST",
+    headers: {
+      Accept: "application/json",
+      "Content-Type": "application/json"
+    },
+    cache: "no-store",
+    signal: options.signal,
+    body: JSON.stringify({
+      view: normalizeRoute(options.view),
+      ...options.trackingId ? { trackingId: options.trackingId } : {},
+      ...options.site ? { site: options.site } : {},
+      anonId: options.anonId,
+      ...options.zones?.length ? { zones: options.zones } : {},
+      ...options.context ? { context: options.context } : {}
+    })
+  });
+  const body = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    throw new SelectVariantsError(
+      body.error || `Select failed (${res.status})`,
+      res.status,
+      body
+    );
+  }
+  return {
+    siteId: String(body.siteId || ""),
+    view: String(body.view || normalizeRoute(options.view)),
+    variantKeys: body.variantKeys && typeof body.variantKeys === "object" ? body.variantKeys : {},
+    meta: body.meta
+  };
+}
+async function selectVariants(options) {
+  const target = resolveAmplifyUpTarget({ configTarget: options.target });
+  const { edgeUrl } = resolveAmplifyUpUrls(target);
+  return fetchEdgeSelect({
+    edgeUrl: options.edgeUrl || edgeUrl,
+    trackingId: options.trackingId,
+    site: options.site,
+    view: options.view,
+    anonId: options.anonId,
+    zones: options.zones,
+    context: options.context,
+    fetch: options.fetch,
+    signal: options.signal
+  });
+}
+
+// src/edge/query.ts
+var QueryContentError = class extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.name = "QueryContentError";
+    this.status = status;
+    this.body = body;
+  }
+};
+async function fetchEdgeQuery(options) {
+  const base = options.edgeUrl.replace(/\/+$/, "");
+  const fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
+  const limit = Math.max(1, Number(options.spec.limit) || 10);
+  const offset = Math.max(0, Number(options.spec.offset) || 0);
+  const res = await fetchFn(`${base}/v1/query`, {
+    method: "POST",
+    headers: {
+      Accept: "application/json",
+      "Content-Type": "application/json"
+    },
+    cache: "no-store",
+    signal: options.signal,
+    body: JSON.stringify({
+      route: normalizeRoute(options.route),
+      trackingId: options.trackingId,
+      ...options.siteId ? { site: options.siteId } : {},
+      spec: { ...options.spec, limit, offset }
+    })
+  });
+  const body = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    throw new QueryContentError(
+      body.error || `Content query failed (${res.status})`,
+      res.status,
+      body
+    );
+  }
+  const results = Array.isArray(body.results) ? body.results : [];
+  const resolvedLimit = Number(body.limit) || limit;
+  const resolvedOffset = Number.isFinite(Number(body.offset)) ? Number(body.offset) : offset;
+  return {
+    results,
+    count: Number(body.count) || results.length,
+    hasMore: !!body.hasMore,
+    limit: resolvedLimit,
+    offset: resolvedOffset,
+    nextOffset: Number(body.nextOffset) || resolvedOffset + resolvedLimit,
+    degraded: body.degraded
+  };
+}
+async function queryContent(options) {
+  const target = resolveAmplifyUpTarget({ configTarget: options.target });
+  const { edgeUrl } = resolveAmplifyUpUrls(target);
+  return fetchEdgeQuery({
+    edgeUrl,
+    trackingId: options.trackingId,
+    route: options.route,
+    spec: options.spec,
+    siteId: options.siteId,
+    fetch: options.fetch,
+    signal: options.signal
+  });
+}
+function nextPageSpec(pagination) {
+  return { ...pagination.spec, offset: pagination.nextOffset };
+}
+function searchSpec(pagination, field, term) {
+  const value = String(term || "").trim();
+  const base = { ...pagination.spec, offset: 0 };
+  if (!value) return base;
+  return {
+    ...base,
+    filter: [...base.filter || [], { field, op: "contains", value }]
+  };
+}
+
 // src/index.ts
 var SESSION_IDLE_GAP_MS = 30 * 60 * 1e3;
 var DWELL_ACTIVITY_IDLE_MS = 2 * 60 * 1e3;
@@ -2847,13 +3037,17 @@ var index_default = getSDK();
 exports.AmplifyUpSDK = AmplifyUpSDK;
 exports.DWELL_ACTIVITY_IDLE_MS = DWELL_ACTIVITY_IDLE_MS;
 exports.EdgeResolveError = EdgeResolveError;
+exports.QueryContentError = QueryContentError;
 exports.SESSION_IDLE_GAP_MS = SESSION_IDLE_GAP_MS;
+exports.SelectVariantsError = SelectVariantsError;
 exports.buildLayoutProviderUrl = buildLayoutProviderUrl;
 exports.buildPageRenderUrl = buildPageRenderUrl;
 exports.cleanupEventTracking = cleanupEventTracking;
 exports.default = index_default;
 exports.fetchContent = fetchContent;
+exports.fetchEdgeQuery = fetchEdgeQuery;
 exports.fetchEdgeResolve = fetchEdgeResolve;
+exports.fetchEdgeSelect = fetchEdgeSelect;
 exports.fetchPageConfig = fetchPageConfig;
 exports.getDiagnostics = getDiagnostics;
 exports.getInstanceId = getInstanceId2;
@@ -2870,14 +3064,18 @@ exports.isComposerPreview = isComposerPreview;
 exports.isPreviewRequest = isPreviewRequest;
 exports.isWorkingContentRequest = isWorkingContentRequest;
 exports.mapResolvedToPageConfig = mapResolvedToPageConfig;
+exports.nextPageSpec = nextPageSpec;
 exports.normalizeAmplifyUpTarget = normalizeAmplifyUpTarget;
 exports.normalizeRoute = normalizeRoute;
 exports.page = page;
+exports.queryContent = queryContent;
 exports.refreshEventTracking = refreshEventTracking;
 exports.reset = reset;
 exports.resolveAmplifyUpTarget = resolveAmplifyUpTarget;
 exports.resolveAmplifyUpUrls = resolveAmplifyUpUrls;
 exports.routeChange = routeChange;
+exports.searchSpec = searchSpec;
+exports.selectVariants = selectVariants;
 exports.setProfileFields = setProfileFields;
 exports.setupComponentViewTracking = setupComponentViewTracking;
 exports.setupEventTracking = setupEventTracking;