@amplifyup/sdk 0.1.34 → 0.1.36

package/dist/query-6BmINKLR.d.mts

@@ -0,0 +1,157 @@
+import { f as AmplifyUpTarget } from './types-CBoVIFI8.mjs';
+
+/**
+ * On-request variant selection (tier 3).
+ *
+ * Decisions happen on AmplifyUp Edge. The client asks after the view has
+ * rendered; the Worker returns variant keys only. Profile data never leaves
+ * the edge. This helper is the JS wrapper around POST /v1/select — the same
+ * wire format is the contract for Flutter / native / .NET clients. No DOM
+ * or Next.js assumptions.
+ */
+
+interface SelectVariantsResult {
+    siteId: string;
+    view: string;
+    variantKeys: Record<string, string>;
+    meta?: Record<string, unknown>;
+}
+declare class SelectVariantsError extends Error {
+    status: number;
+    body: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+interface FetchEdgeSelectOptions {
+    edgeUrl: string;
+    trackingId?: string;
+    site?: string;
+    view: string;
+    anonId: string;
+    zones?: string[];
+    /** Request-local facts the edge cannot observe (app version, screen class). */
+    context?: Record<string, unknown>;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+declare function fetchEdgeSelect(options: FetchEdgeSelectOptions): Promise<SelectVariantsResult>;
+interface SelectVariantsOptions {
+    trackingId?: string;
+    site?: string;
+    view: string;
+    anonId: string;
+    zones?: string[];
+    context?: Record<string, unknown>;
+    target?: AmplifyUpTarget;
+    edgeUrl?: string;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Ask Edge to decide deferred rules for a view. Returns variant keys to pass
+ * to `/v1/resolve?variants=`.
+ */
+declare function selectVariants(options: SelectVariantsOptions): Promise<SelectVariantsResult>;
+
+/**
+ * Runtime content queries.
+ *
+ * Page resolve covers data known at Deploy. Visitor-triggered data — search,
+ * load more, pickers — runs here: the browser asks AmplifyUp, AmplifyUp asks
+ * the CMS. Only entities published with the page can be queried.
+ */
+
+type QueryFilterOp = 'eq' | 'neq' | 'in' | 'nin' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'exists';
+interface QueryFilter {
+    field: string;
+    op: QueryFilterOp;
+    value?: unknown;
+}
+interface QuerySort {
+    field: string;
+    dir: 'asc' | 'desc';
+}
+/**
+ * Provider-neutral query. AmplifyUp compiles this for the connected CMS —
+ * it never contains CMS query syntax. Same shape Composer saves on a
+ * query connection, and the shape returned in `{field}Pagination.spec`.
+ */
+interface QuerySpec {
+    providerId: string;
+    entity: string;
+    filter: QueryFilter[];
+    sort: QuerySort[];
+    limit: number;
+    offset: number;
+}
+/** Pagination meta added to list props when a query connection is paginated. */
+interface QueryPagination {
+    hasMore: boolean;
+    limit: number;
+    offset: number;
+    nextOffset: number;
+    spec: QuerySpec;
+}
+interface QueryResult<T = Record<string, unknown>> {
+    results: T[];
+    count: number;
+    hasMore: boolean;
+    limit: number;
+    offset: number;
+    nextOffset: number;
+    /** True when a content source failed and results may be incomplete. */
+    degraded?: boolean;
+}
+declare class QueryContentError extends Error {
+    status: number;
+    body: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+interface FetchEdgeQueryOptions {
+    edgeUrl: string;
+    trackingId: string;
+    /** Published route the query belongs to (provides sources + entity mapping). */
+    route: string;
+    spec: QuerySpec;
+    siteId?: string | null;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Low-level runtime query against a known Edge URL.
+ * Most callers should use `queryContent`, which resolves the URL for them.
+ */
+declare function fetchEdgeQuery<T = Record<string, unknown>>(options: FetchEdgeQueryOptions): Promise<QueryResult<T>>;
+interface QueryContentOptions {
+    trackingId: string;
+    /** Published route the query belongs to, e.g. '/insights'. */
+    route: string;
+    spec: QuerySpec;
+    siteId?: string | null;
+    target?: AmplifyUpTarget;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Run a content query at request time (search, load more, pickers).
+ *
+ * Start from the published spec on a paginated list prop so filters and sort
+ * stay owned by Composer:
+ *
+ * ```ts
+ * const next = await queryContent({
+ *   trackingId,
+ *   route: '/insights',
+ *   spec: { ...postsPagination.spec, offset: postsPagination.nextOffset },
+ * });
+ * ```
+ */
+declare function queryContent<T = Record<string, unknown>>(options: QueryContentOptions): Promise<QueryResult<T>>;
+/** Convenience: next page from pagination meta on a list prop. */
+declare function nextPageSpec(pagination: QueryPagination): QuerySpec;
+/**
+ * Convenience: same published query, filtered by a visitor's search term.
+ * Resets to the first page. Empty terms return the unfiltered spec.
+ */
+declare function searchSpec(pagination: QueryPagination, field: string, term: string): QuerySpec;
+
+export { type FetchEdgeSelectOptions as F, QueryContentError as Q, SelectVariantsError as S, type SelectVariantsOptions as a, type SelectVariantsResult as b, fetchEdgeQuery as c, searchSpec as d, type QueryContentOptions as e, fetchEdgeSelect as f, type FetchEdgeQueryOptions as g, type QueryResult as h, type QueryPagination as i, type QuerySpec as j, type QueryFilter as k, type QueryFilterOp as l, type QuerySort as m, nextPageSpec as n, queryContent as q, selectVariants as s };

package/dist/query-DjIuJ71C.d.ts

@@ -0,0 +1,157 @@
+import { f as AmplifyUpTarget } from './types-CBoVIFI8.js';
+
+/**
+ * On-request variant selection (tier 3).
+ *
+ * Decisions happen on AmplifyUp Edge. The client asks after the view has
+ * rendered; the Worker returns variant keys only. Profile data never leaves
+ * the edge. This helper is the JS wrapper around POST /v1/select — the same
+ * wire format is the contract for Flutter / native / .NET clients. No DOM
+ * or Next.js assumptions.
+ */
+
+interface SelectVariantsResult {
+    siteId: string;
+    view: string;
+    variantKeys: Record<string, string>;
+    meta?: Record<string, unknown>;
+}
+declare class SelectVariantsError extends Error {
+    status: number;
+    body: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+interface FetchEdgeSelectOptions {
+    edgeUrl: string;
+    trackingId?: string;
+    site?: string;
+    view: string;
+    anonId: string;
+    zones?: string[];
+    /** Request-local facts the edge cannot observe (app version, screen class). */
+    context?: Record<string, unknown>;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+declare function fetchEdgeSelect(options: FetchEdgeSelectOptions): Promise<SelectVariantsResult>;
+interface SelectVariantsOptions {
+    trackingId?: string;
+    site?: string;
+    view: string;
+    anonId: string;
+    zones?: string[];
+    context?: Record<string, unknown>;
+    target?: AmplifyUpTarget;
+    edgeUrl?: string;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Ask Edge to decide deferred rules for a view. Returns variant keys to pass
+ * to `/v1/resolve?variants=`.
+ */
+declare function selectVariants(options: SelectVariantsOptions): Promise<SelectVariantsResult>;
+
+/**
+ * Runtime content queries.
+ *
+ * Page resolve covers data known at Deploy. Visitor-triggered data — search,
+ * load more, pickers — runs here: the browser asks AmplifyUp, AmplifyUp asks
+ * the CMS. Only entities published with the page can be queried.
+ */
+
+type QueryFilterOp = 'eq' | 'neq' | 'in' | 'nin' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'exists';
+interface QueryFilter {
+    field: string;
+    op: QueryFilterOp;
+    value?: unknown;
+}
+interface QuerySort {
+    field: string;
+    dir: 'asc' | 'desc';
+}
+/**
+ * Provider-neutral query. AmplifyUp compiles this for the connected CMS —
+ * it never contains CMS query syntax. Same shape Composer saves on a
+ * query connection, and the shape returned in `{field}Pagination.spec`.
+ */
+interface QuerySpec {
+    providerId: string;
+    entity: string;
+    filter: QueryFilter[];
+    sort: QuerySort[];
+    limit: number;
+    offset: number;
+}
+/** Pagination meta added to list props when a query connection is paginated. */
+interface QueryPagination {
+    hasMore: boolean;
+    limit: number;
+    offset: number;
+    nextOffset: number;
+    spec: QuerySpec;
+}
+interface QueryResult<T = Record<string, unknown>> {
+    results: T[];
+    count: number;
+    hasMore: boolean;
+    limit: number;
+    offset: number;
+    nextOffset: number;
+    /** True when a content source failed and results may be incomplete. */
+    degraded?: boolean;
+}
+declare class QueryContentError extends Error {
+    status: number;
+    body: unknown;
+    constructor(message: string, status: number, body?: unknown);
+}
+interface FetchEdgeQueryOptions {
+    edgeUrl: string;
+    trackingId: string;
+    /** Published route the query belongs to (provides sources + entity mapping). */
+    route: string;
+    spec: QuerySpec;
+    siteId?: string | null;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Low-level runtime query against a known Edge URL.
+ * Most callers should use `queryContent`, which resolves the URL for them.
+ */
+declare function fetchEdgeQuery<T = Record<string, unknown>>(options: FetchEdgeQueryOptions): Promise<QueryResult<T>>;
+interface QueryContentOptions {
+    trackingId: string;
+    /** Published route the query belongs to, e.g. '/insights'. */
+    route: string;
+    spec: QuerySpec;
+    siteId?: string | null;
+    target?: AmplifyUpTarget;
+    fetch?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Run a content query at request time (search, load more, pickers).
+ *
+ * Start from the published spec on a paginated list prop so filters and sort
+ * stay owned by Composer:
+ *
+ * ```ts
+ * const next = await queryContent({
+ *   trackingId,
+ *   route: '/insights',
+ *   spec: { ...postsPagination.spec, offset: postsPagination.nextOffset },
+ * });
+ * ```
+ */
+declare function queryContent<T = Record<string, unknown>>(options: QueryContentOptions): Promise<QueryResult<T>>;
+/** Convenience: next page from pagination meta on a list prop. */
+declare function nextPageSpec(pagination: QueryPagination): QuerySpec;
+/**
+ * Convenience: same published query, filtered by a visitor's search term.
+ * Resets to the first page. Empty terms return the unfiltered spec.
+ */
+declare function searchSpec(pagination: QueryPagination, field: string, term: string): QuerySpec;
+
+export { type FetchEdgeSelectOptions as F, QueryContentError as Q, SelectVariantsError as S, type SelectVariantsOptions as a, type SelectVariantsResult as b, fetchEdgeQuery as c, searchSpec as d, type QueryContentOptions as e, fetchEdgeSelect as f, type FetchEdgeQueryOptions as g, type QueryResult as h, type QueryPagination as i, type QuerySpec as j, type QueryFilter as k, type QueryFilterOp as l, type QuerySort as m, nextPageSpec as n, queryContent as q, selectVariants as s };

package/dist/react.d.mts

@@ -3,6 +3,7 @@ import React, { ReactNode } from 'react';
 import { P as PageConfig, b as AmplifyUpConfig, C as ContentSource, A as AmplifyContentMeta } from './types-CBoVIFI8.mjs';
 export { Z as ZoneConfig } from './types-CBoVIFI8.mjs';
 export { AmplifyRenderer } from './AmplifyRenderer.mjs';
+export { 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, n as nextPageSpec, q as queryContent, d as searchSpec, s as selectVariants } from './query-6BmINKLR.mjs';
 export { i as isComposerPreview, a as isPreviewRequest, b as isWorkingContentRequest } from './preview-_vHmzRen.mjs';
 export { fetchPageConfigServer } from './server.mjs';
 

package/dist/react.d.ts

@@ -3,6 +3,7 @@ import React, { ReactNode } from 'react';
 import { P as PageConfig, b as AmplifyUpConfig, C as ContentSource, A as AmplifyContentMeta } from './types-CBoVIFI8.js';
 export { Z as ZoneConfig } from './types-CBoVIFI8.js';
 export { AmplifyRenderer } from './AmplifyRenderer.js';
+export { 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, n as nextPageSpec, q as queryContent, d as searchSpec, s as selectVariants } from './query-DjIuJ71C.js';
 export { i as isComposerPreview, a as isPreviewRequest, b as isWorkingContentRequest } from './preview-_vHmzRen.js';
 export { fetchPageConfigServer } from './server.js';
 

package/dist/react.js

@@ -577,6 +577,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;
@@ -4061,14 +4200,31 @@ function AmplifyUpProvider({ children, config }) {
           setLoading(false);
           return;
         }
+        let variantKeys;
+        const anonId = sdk.getInstanceId();
+        if (!preview && anonId) {
+          try {
+            const selected = await selectVariants({
+              trackingId,
+              view: actualRoute,
+              anonId,
+              site: sdk.getSiteId() || void 0,
+              edgeUrl
+            });
+            variantKeys = selected.variantKeys;
+          } catch (err) {
+            console.error("AmplifyUp selectVariants failed; overlay will use visitor id", err);
+          }
+        }
         const result = await fetchContent({
           route: actualRoute,
           trackingId,
-          anonId: sdk.getInstanceId(),
+          anonId: variantKeys ? void 0 : anonId,
           siteId: sdk.getSiteId() || null,
           preview,
           orchestratorUrl,
           edgeUrl,
+          variantKeys,
           fetchOrchestratorPage: (route, isPreview) => sdk.fetchPageConfig(route, isPreview)
         });
         if (cancelled) return;
@@ -4123,12 +4279,18 @@ exports.AmplifyUpProvider = AmplifyUpProvider;
 exports.ComponentContextProvider = ComponentContextProvider;
 exports.Field = Field;
 exports.Image = Image;
+exports.QueryContentError = QueryContentError;
 exports.RichText = RichText;
+exports.SelectVariantsError = SelectVariantsError;
 exports.Slot = Slot;
 exports.fetchPageConfigServer = fetchPageConfigServer;
 exports.isComposerPreview = isComposerPreview;
 exports.isPreviewRequest = isPreviewRequest;
 exports.isWorkingContentRequest = isWorkingContentRequest;
+exports.nextPageSpec = nextPageSpec;
+exports.queryContent = queryContent;
+exports.searchSpec = searchSpec;
+exports.selectVariants = selectVariants;
 exports.useAmplifyUp = useAmplifyUp;
 exports.useComponentProps = useComponentProps;
 exports.useLiveComposerProps = useLiveComposerProps;