@amplifyup/sdk 0.1.66 → 0.1.68

package/dist/{query-DuRilU_n.d.mts → query-B_DU7yEm.d.mts}

@@ -1,4 +1,4 @@
-import { i as AmplifyUpTarget, y as ListRow } from './types-C32MgOiv.mjs';
+import { i as AmplifyUpTarget, y as ListRow } from './types-CGeBbx84.mjs';
 
 /**
  * On-request variant selection (tier 3).

package/dist/{query-BLjZYjHJ.d.ts → query-Hay-oVYp.d.ts}

@@ -1,4 +1,4 @@
-import { i as AmplifyUpTarget, y as ListRow } from './types-C32MgOiv.js';
+import { i as AmplifyUpTarget, y as ListRow } from './types-CGeBbx84.js';
 
 /**
  * On-request variant selection (tier 3).

package/dist/react.d.mts

@@ -1,9 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { L as LayoutComponentProps, P as PageConfig, F as Field$1, l as FIELDS_BRAND, c as AmplifyUpConfig, e as AmplifyPageContextInput, C as ContentSource, A as AmplifyContentMeta } from './types-C32MgOiv.mjs';
-export { w as FieldRef, x as Fields, z as ImageValue, y as ListRow, B as PortableRef, Z as ZoneConfig, m as attachFieldEnvelopes, p as composerStoreKey, o as envelopeListRows, v as isBrandedFields, s as isFieldEnvelope, u as isReadOnlyRowField, q as listOwnerFromSpec, t as toFieldEnvelopes } from './types-C32MgOiv.mjs';
+import { L as LayoutComponentProps, P as PageConfig, F as Field$1, l as FIELDS_BRAND, c as AmplifyUpConfig, e as AmplifyPageContextInput, C as ContentSource, A as AmplifyContentMeta } from './types-CGeBbx84.mjs';
+export { w as FieldRef, x as Fields, z as ImageValue, y as ListRow, B as PortableRef, Z as ZoneConfig, m as attachFieldEnvelopes, p as composerStoreKey, o as envelopeListRows, v as isBrandedFields, s as isFieldEnvelope, u as isReadOnlyRowField, q as listOwnerFromSpec, t as toFieldEnvelopes } from './types-CGeBbx84.mjs';
 import react__default, { ReactNode } from 'react';
 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-DuRilU_n.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-B_DU7yEm.mjs';
 export { i as isComposerPreview, a as isPreviewRequest, b as isWorkingContentRequest } from './preview-_vHmzRen.mjs';
 
 type RenderComponentContext = {

package/dist/react.d.ts

@@ -1,9 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { L as LayoutComponentProps, P as PageConfig, F as Field$1, l as FIELDS_BRAND, c as AmplifyUpConfig, e as AmplifyPageContextInput, C as ContentSource, A as AmplifyContentMeta } from './types-C32MgOiv.js';
-export { w as FieldRef, x as Fields, z as ImageValue, y as ListRow, B as PortableRef, Z as ZoneConfig, m as attachFieldEnvelopes, p as composerStoreKey, o as envelopeListRows, v as isBrandedFields, s as isFieldEnvelope, u as isReadOnlyRowField, q as listOwnerFromSpec, t as toFieldEnvelopes } from './types-C32MgOiv.js';
+import { L as LayoutComponentProps, P as PageConfig, F as Field$1, l as FIELDS_BRAND, c as AmplifyUpConfig, e as AmplifyPageContextInput, C as ContentSource, A as AmplifyContentMeta } from './types-CGeBbx84.js';
+export { w as FieldRef, x as Fields, z as ImageValue, y as ListRow, B as PortableRef, Z as ZoneConfig, m as attachFieldEnvelopes, p as composerStoreKey, o as envelopeListRows, v as isBrandedFields, s as isFieldEnvelope, u as isReadOnlyRowField, q as listOwnerFromSpec, t as toFieldEnvelopes } from './types-CGeBbx84.js';
 import react__default, { ReactNode } from 'react';
 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-BLjZYjHJ.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-Hay-oVYp.js';
 export { i as isComposerPreview, a as isPreviewRequest, b as isWorkingContentRequest } from './preview-_vHmzRen.js';
 
 type RenderComponentContext = {

package/dist/react.js

@@ -440,6 +440,13 @@ function isFieldEnvelope(value) {
   const rec = value;
   return typeof rec.name === "string" && "value" in rec && !("url" in rec);
 }
+var OBJECT_FIELD_KINDS = /* @__PURE__ */ new Set(["object", "array", "list"]);
+function isLeafFieldKind(kind) {
+  if (typeof kind !== "string") return false;
+  const normalized = kind.trim().toLowerCase();
+  if (!normalized) return false;
+  return !OBJECT_FIELD_KINDS.has(normalized);
+}
 function isPageResourceSentinel(value) {
   return !!value && typeof value === "object" && !Array.isArray(value) && typeof value.__amplifyupPageResource === "string";
 }
@@ -579,6 +586,10 @@ function toFieldEnvelopes(source, prefix = "", scope) {
       out[key] = { value: envelopeListRows(raw, owner), name: path };
       continue;
     }
+    if (ctx.leaf?.(path)) {
+      out[key] = withLeaf({ value: emptyValue(raw), name: path }, ctx);
+      continue;
+    }
     if (raw && typeof raw === "object" && !Array.isArray(raw) && !isPortableImageShape(raw) && !raw.$$typeof) {
       out[key] = toFieldEnvelopes(raw, path, ctx);
       continue;
@@ -607,15 +618,33 @@ function envelopeListRow(item, owner) {
   }
   return row;
 }
+var warnedMissingFieldKind = /* @__PURE__ */ new Set();
+function warnMissingFieldKind(fieldName) {
+  if (process.env.NODE_ENV === "production") return;
+  if (warnedMissingFieldKind.has(fieldName)) return;
+  warnedMissingFieldKind.add(fieldName);
+  console.warn(
+    `[AmplifyUp SDK] Field "${fieldName}" has no schema kind; using value-shape detection. Republish the component definition so its fields carry a type.`
+  );
+}
 function attachFieldEnvelopes(props, sources) {
   const raw = props && typeof props === "object" ? { ...props } : {};
   if (isBrandedFields(raw.fields)) return raw;
   const { fields: existing, ...content } = raw;
   const source = existing && typeof existing === "object" && !isFieldEnvelope(existing) ? existing : content;
+  const { reads } = normalizeEnvelopeSources(sources);
+  if (reads) {
+    for (const [fieldName, read] of Object.entries(reads)) {
+      if (!read?.kind) warnMissingFieldKind(fieldName);
+    }
+  }
   return {
     ...raw,
     fields: toFieldEnvelopes(source, "", {
-      owners: (fieldName) => listOwnerForField(fieldName, source, sources)
+      owners: (fieldName) => listOwnerForField(fieldName, source, sources),
+      // Top-level field paths equal field names; nested paths have no schema
+      // entry and fall back to shape-based handling.
+      leaf: (path) => isLeafFieldKind(reads?.[path]?.kind)
     })
   };
 }
@@ -890,6 +919,8 @@ function hydrateFieldsBag(bag, fields) {
     if (val && typeof val === "object" && !Array.isArray(val) && typeof val.name === "string" && "value" in val && !("url" in val)) {
       const env = val;
       out[key] = {
+        // Keep ref / readOnly / source — dropping them severs the write target.
+        ...val,
         name: env.name,
         value: isPageResourceSentinel2(env.value) ? hydratePageResourceValue(env.value, fields) : env.value
       };
@@ -971,6 +1002,51 @@ function sdkDebugOnce(key, ...args) {
   console.log(...args);
 }
 
+// src/content/layoutProviderCache.ts
+var SETTLED_TTL_MS = 5e3;
+var inflight = /* @__PURE__ */ new Map();
+var settled = /* @__PURE__ */ new Map();
+function layoutProviderCacheKey(opts) {
+  const route = (opts.route || "/").split("?")[0] || "/";
+  return [
+    route,
+    opts.trackingId || "",
+    opts.instanceId || "",
+    opts.preview ? "1" : "0",
+    opts.working ? "1" : "0",
+    opts.zoneId || "",
+    opts.compositionId || ""
+  ].join("|");
+}
+function getSettledLayoutProvider(key) {
+  const entry = settled.get(key);
+  if (!entry) return void 0;
+  if (Date.now() - entry.at > SETTLED_TTL_MS) {
+    settled.delete(key);
+    return void 0;
+  }
+  return entry.value;
+}
+function dedupeLayoutProviderFetch(key, fetchFn) {
+  const cached = getSettledLayoutProvider(key);
+  if (cached !== void 0) return Promise.resolve(cached);
+  const existing = inflight.get(key);
+  if (existing) return existing;
+  const pending = fetchFn().then((value) => {
+    settled.set(key, { value, at: Date.now() });
+    return value;
+  }).finally(() => {
+    inflight.delete(key);
+  });
+  inflight.set(key, pending);
+  return pending;
+}
+function previewLayoutReady(opts) {
+  if (opts.hasClientLayout) return true;
+  if (opts.clientLoading) return false;
+  return opts.hasServerLayout;
+}
+
 // src/edge/normalizeRoute.ts
 function normalizeRoute(route) {
   let path = String(route || "").trim();
@@ -2384,6 +2460,32 @@ Available Console Commands:
    */
   async fetchPageConfig(route, preview = false) {
     const url = this.buildLayoutProviderUrl(route, preview);
+    const pageSearch = typeof window !== "undefined" ? new URLSearchParams(window.location.search) : null;
+    const cacheKey = layoutProviderCacheKey({
+      route,
+      trackingId: this.getTrackingId(),
+      instanceId: getInstanceId(),
+      preview,
+      working: pageSearch ? isWorkingContentRequest(pageSearch) : false,
+      zoneId: pageSearch?.get("zoneId"),
+      compositionId: pageSearch?.get("compositionId")
+    });
+    return dedupeLayoutProviderFetch(cacheKey, async () => {
+      const startedAt = Date.now();
+      sdkDebug("[AmplifyUp SDK] layout/provider request", {
+        route,
+        at: new Date(startedAt).toISOString()
+      });
+      const page = await this.fetchPageConfigUncached(url);
+      sdkDebug("[AmplifyUp SDK] layout/provider response", {
+        route,
+        durationMs: Date.now() - startedAt,
+        hasPage: !!page
+      });
+      return page;
+    });
+  }
+  async fetchPageConfigUncached(url) {
     const response = await fetch(url);
     if (!response.ok) {
       if (response.status === 404) {
@@ -2742,6 +2844,12 @@ Available Console Commands:
           );
           return;
         }
+        if (event.data?.type === "AMPLIFYUP_LAYOUT_PATCH") {
+          window.dispatchEvent(
+            new CustomEvent("amplifyup:layout-patch", { detail: event.data })
+          );
+          return;
+        }
         if (event.data?.type === "COMPONENT_DELETABLE_STATUS") {
           const { componentId, deletable, nodeId } = event.data;
           const element = document.querySelector(`[data-component-id="${componentId}"]`);
@@ -3782,6 +3890,13 @@ function getSDK(adapter) {
 var trackContentView = (contentId, contentType, properties) => getSDK().trackContentView(contentId, contentType, properties);
 var refreshEventTracking = () => getSDK().refreshEventTracking();
 getSDK();
+function useComposerPreviewFlag(force = false) {
+  const [detected, setDetected] = React2.useState(false);
+  React2.useEffect(() => {
+    if (!force && isComposerPreview()) setDetected(true);
+  }, [force]);
+  return force || detected;
+}
 
 // src/composer-store.ts
 var ComposerFieldStore = class {
@@ -3998,16 +4113,9 @@ function NodeWithFields({
   renderComponent,
   composerPreview
 }) {
-  return /* @__PURE__ */ jsxRuntime.jsx(
-    MaybeComposerProvider,
-    {
-      enabled: !!(composerPreview || isComposerPreview()),
-      layoutNodeId: nodeId,
-      children: renderComponent(componentId, props, slots, {
-        layoutNodeId: nodeId
-      })
-    }
-  );
+  return /* @__PURE__ */ jsxRuntime.jsx(MaybeComposerProvider, { enabled: !!composerPreview, layoutNodeId: nodeId, children: renderComponent(componentId, props, slots, {
+    layoutNodeId: nodeId
+  }) });
 }
 function AmplifyRendererInner({
   renderComponent,
@@ -4018,6 +4126,7 @@ function AmplifyRendererInner({
   composerPreview
 }) {
   const clientHook = useAmplifyUp();
+  const composerPreviewFlag = useComposerPreviewFlag(!!composerPreview);
   const pageConfig = serverPageConfig || clientHook.pageConfig || null;
   const loading = serverPageConfig ? false : clientHook.loading;
   const error = serverPageConfig ? null : clientHook.error;
@@ -4370,7 +4479,7 @@ function AmplifyRendererInner({
                 props: nodeRenderProps(node),
                 slots: slotsToPass,
                 renderComponent,
-                composerPreview
+                composerPreview: composerPreviewFlag
               }
             )
           }
@@ -4383,7 +4492,7 @@ function AmplifyRendererInner({
   if (layoutTree.length === 0) {
     return /* @__PURE__ */ jsxRuntime.jsx("main", { children: emptyComponent || /* @__PURE__ */ jsxRuntime.jsx("div", { className: "container mx-auto px-4 py-16", children: /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-muted-foreground", children: "No content configured for this page." }) }) });
   }
-  return /* @__PURE__ */ jsxRuntime.jsx(ComposerProvider, { children: /* @__PURE__ */ jsxRuntime.jsx("main", { children: composerPreview || isComposerPreview() ? /* @__PURE__ */ jsxRuntime.jsx(
+  return /* @__PURE__ */ jsxRuntime.jsx(ComposerProvider, { children: /* @__PURE__ */ jsxRuntime.jsx("main", { children: composerPreviewFlag ? /* @__PURE__ */ jsxRuntime.jsx(
     "div",
     {
       "data-slot-id": "main",
@@ -4532,7 +4641,7 @@ function AmplifyPageContent({
   errorComponent
 }) {
   const client = useAmplifyUp();
-  const preview = forceComposerPreview || isComposerPreview();
+  const preview = useComposerPreviewFlag(forceComposerPreview);
   const clientLayout = hasAmplifyLayout(client.pageConfig) ? client.pageConfig : null;
   const serverLayout = hasAmplifyLayout(pageConfigProp) ? pageConfigProp : null;
   let pageConfig = serverLayout ?? clientLayout;
@@ -4548,10 +4657,15 @@ function AmplifyPageContent({
   const previewCanvas = previewEmptyComponent ?? defaultPreviewCanvas();
   const previewLoading = previewLoadingComponent ?? previewCanvas;
   if (preview) {
+    const ready = previewLayoutReady({
+      clientLoading: client.loading,
+      hasClientLayout: !!clientLayout,
+      hasServerLayout: !!serverLayout
+    });
     return /* @__PURE__ */ jsxRuntime.jsx(
       AmplifyRenderer,
       {
-        pageConfig: pageConfig ?? void 0,
+        pageConfig: ready ? pageConfig ?? void 0 : void 0,
         renderComponent,
         composerPreview: true,
         loadingComponent: loadingComponent ?? previewLoading,
@@ -5011,6 +5125,18 @@ function warnNotScalarField(component, field, fieldValue) {
   }
   return false;
 }
+function assertNamedEnvelope(component, field) {
+  if (process.env.NODE_ENV === "production") return;
+  if (!field || typeof field !== "object" || Array.isArray(field)) return;
+  const rec = field;
+  if (!("value" in rec)) return;
+  if (typeof rec.name === "string" && rec.name) return;
+  throw new Error(
+    `[AmplifyUp SDK] ${component} received an envelope-shaped object with a \`value\` but no \`name\` \u2014 a partial envelope was manufactured upstream (keys: ${Object.keys(
+      rec
+    ).join(", ")}). Find the producer; do not strip or rebuild envelopes.`
+  );
+}
 var warnedReadOnlyFields = /* @__PURE__ */ new Set();
 function warnReadOnlyRowField(name) {
   if (process.env.NODE_ENV === "production") return;
@@ -5046,6 +5172,7 @@ function Field(props) {
   const hasField = isFieldEnvelope(field);
   const hasValue = hasOwnProp(props, "value");
   const { editName, fieldValue, ref } = useBoundField(field, value, name, "Field");
+  assertNamedEnvelope("Field", field);
   warnProjectionProps("Field", hasField, hasValue, name);
   if (warnNotScalarField("Field", field, fieldValue)) {
     return null;
@@ -5106,6 +5233,7 @@ function RichText(props) {
     name,
     "RichText"
   );
+  assertNamedEnvelope("RichText", field);
   if (!hasField && !hasValueProp && !name) {
     return null;
   }
@@ -5217,6 +5345,7 @@ function Image(props) {
     ...imgProps
   } = props;
   const context = React2.useContext(ComponentContext);
+  assertNamedEnvelope("Image", field);
   const coerced = coerceImageField(field, value, name);
   const boundField = coerced.field;
   const hasField = isFieldEnvelope(boundField);
@@ -5253,25 +5382,8 @@ function Image(props) {
       '[AmplifyUp SDK] Image value={\u2026} requires name="\u2026" for computed values'
     );
   }
-  const img = src ? /* @__PURE__ */ jsxRuntime.jsx(
-    "img",
-    {
-      ...imgProps,
-      src,
-      alt,
-      className: fieldAttrs ? void 0 : className,
-      width,
-      height,
-      style: fieldAttrs ? {
-        display: "block",
-        width: "100%",
-        height: "100%",
-        objectFit: "cover",
-        pointerEvents: "none"
-      } : typeof imgProps.style === "object" && imgProps.style ? imgProps.style : void 0
-    }
-  ) : null;
-  if (fieldAttrs) {
+  if (!src) {
+    if (!composerEdit || !fieldAttrs) return null;
     return /* @__PURE__ */ jsxRuntime.jsx(
       "span",
       {
@@ -5286,15 +5398,28 @@ function Image(props) {
           minHeight: height ? void 0 : 80,
           width: width || "100%",
           height: height || void 0,
-          cursor: "pointer",
-          background: src ? void 0 : "color-mix(in srgb, currentColor 8%, transparent)"
-        },
-        children: img
+          background: "color-mix(in srgb, currentColor 8%, transparent)",
+          cursor: "pointer"
+        }
       }
     );
   }
-  if (!src) return null;
-  return img;
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "img",
+    {
+      ...imgProps,
+      ...fieldAttrs,
+      src,
+      alt,
+      className,
+      width,
+      height,
+      style: {
+        ...typeof imgProps.style === "object" && imgProps.style ? imgProps.style : {},
+        ...composerEdit && fieldAttrs ? { cursor: "pointer" } : null
+      }
+    }
+  );
 }
 var usePathname = null;
 if (typeof window !== "undefined") {
@@ -5456,6 +5581,13 @@ function AmplifyUpProvider({
           description: "This page has not been published yet.",
           layoutTree: []
         };
+        if (result.pageConfig) {
+          sdk.applyResolvedPageData(
+            result.pageConfig.pageData || null,
+            result.pageConfig.route,
+            extractRouteParams(result.pageConfig.route, actualRoute)
+          );
+        }
         setInitialized(true);
         setSource((prev) => prev === result.source ? prev : result.source);
         setMeta(
@@ -5468,13 +5600,6 @@ function AmplifyUpProvider({
           }
           return nextConfig;
         });
-        if (result.pageConfig) {
-          sdk.applyResolvedPageData(
-            result.pageConfig.pageData || null,
-            result.pageConfig.route,
-            extractRouteParams(result.pageConfig.route, actualRoute)
-          );
-        }
         loadedRouteRef.current = actualRoute;
       } catch (err) {
         if (cancelled) return;
@@ -5501,6 +5626,39 @@ function AmplifyUpProvider({
     config.clientPersonalization,
     pageContextKey
   ]);
+  React2.useEffect(() => {
+    const applyLayoutTree = (layoutTree) => {
+      if (!Array.isArray(layoutTree)) return;
+      setPageConfig((prev) => {
+        const next = envelopePageConfig({
+          ...prev || {
+            id: "patched",
+            route: getActualRoute(),
+            title: "",
+            layoutTree: []
+          },
+          layoutTree
+        });
+        return next;
+      });
+      setLoading(false);
+    };
+    const onMessage = (event) => {
+      if (event.data?.type === "AMPLIFYUP_LAYOUT_PATCH") {
+        applyLayoutTree(event.data.layoutTree);
+      }
+    };
+    const onCustom = (event) => {
+      const detail = event.detail || {};
+      applyLayoutTree(detail.layoutTree);
+    };
+    window.addEventListener("message", onMessage);
+    window.addEventListener("amplifyup:layout-patch", onCustom);
+    return () => {
+      window.removeEventListener("message", onMessage);
+      window.removeEventListener("amplifyup:layout-patch", onCustom);
+    };
+  }, []);
   return /* @__PURE__ */ jsxRuntime.jsx(
     AmplifyUpContext.Provider,
     {