@amplifyup/sdk 0.1.63 → 0.1.65

package/dist/{types-Db_eLrfU.d.ts → types-C32MgOiv.d.ts}

@@ -1,3 +1,98 @@
+/**
+ * Field envelopes — same shape in published, draft, and Composer edit.
+ * `{ value, name, ref? }` where `name` is the path within the owning record
+ * (`title`, `author.name`). Page-level fields omit `ref`.
+ * `ref` is stamped from the connection that produced the row
+ * (`providerId`, AmplifyUp `entity`, `id`) — never from a CMS `_type`.
+ * Produced once at the Edge resolve boundary (`fetchEdgeResolve`) and again
+ * on the SDK for `queryContent` rows.
+ */
+declare const FIELDS_BRAND: unique symbol;
+type ImageValue = {
+    url: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+};
+/** Connection that produced a list row. Omitted on page-level fields. */
+type FieldRef = {
+    providerId: string;
+    entity: string;
+    id: string;
+};
+/** AmplifyUp entity + provider from the connection that produced a list. */
+type ListOwner = {
+    providerId: string;
+    entity: string;
+};
+type ConnectionLike = {
+    mode?: string;
+    providerId?: string;
+    entity?: string;
+    spec?: {
+        providerId?: string;
+        entity?: string;
+    };
+};
+type EnvelopeSources = {
+    connections?: Record<string, ConnectionLike | null | undefined>;
+    reads?: Record<string, {
+        resource: string;
+    }>;
+};
+type Field<T> = {
+    value: T;
+    name: string;
+    ref?: FieldRef;
+    /** Row field with no write target — display only in Composer. */
+    readOnly?: true;
+};
+/** Portable entry identity after normalize (`id` required). */
+type PortableRef = {
+    id: string;
+    type?: string;
+};
+type IdentifierKey = 'id' | '_id' | 'slug' | 'key' | '_key' | 'docId' | '_type' | 'type';
+type IsPlainObject<T> = T extends object ? T extends readonly unknown[] ? false : T extends ImageValue ? false : true : false;
+type AsRecord<T> = T extends Record<string, unknown> ? T : Record<string, unknown>;
+/** A list row: enveloped fields plus a plain `id`. */
+type ListRow<T extends Record<string, unknown> = Record<string, unknown>> = Fields<T> & {
+    id: string;
+};
+type FieldsProp<T> = NonNullable<T> extends ImageValue ? Field<T | null> : NonNullable<T> extends readonly (infer U)[] ? IsPlainObject<U> extends true ? Field<Array<ListRow<AsRecord<U>>>> : Field<T> : IsPlainObject<NonNullable<T>> extends true ? Fields<NonNullable<T>> : Field<T>;
+type Fields<T> = {
+    readonly [FIELDS_BRAND]: true;
+} & {
+    [K in keyof T]-?: K extends IdentifierKey ? T[K] : FieldsProp<T[K]>;
+};
+/** Props passed into site components. Raw CMS bags are not assignable. */
+type LayoutComponentProps<T extends Record<string, unknown> = Record<string, unknown>> = {
+    fields: Fields<T>;
+};
+declare function isBrandedFields(value: unknown): value is Fields<Record<string, unknown>>;
+declare function isFieldEnvelope(value: unknown): value is Field<unknown>;
+declare function isReadOnlyRowField(value: unknown): boolean;
+declare function composerStoreKey(name: string, ref?: FieldRef | null, layoutNodeId?: string): string;
+declare function listOwnerFromSpec(spec: {
+    providerId?: string;
+    entity?: string;
+} | null | undefined): ListOwner | undefined;
+type EnvelopeScope = {
+    ref?: FieldRef;
+    readOnly?: boolean;
+    owners?: (fieldName: string) => ListOwner | undefined;
+};
+/**
+ * Wrap a props bag as envelopes. Already-enveloped bags are returned as-is.
+ * Nested plain objects become nested bags; portable images stay a leaf.
+ * Object arrays become list rows (`Fields` + plain `id`); `name` is the path
+ * within the record when `ref` is set.
+ */
+declare function toFieldEnvelopes<T extends Record<string, unknown>>(source: T | null | undefined, prefix?: string, scope?: EnvelopeScope | FieldRef): Fields<T>;
+declare function envelopeListRows<T extends Record<string, unknown> = Record<string, unknown>>(items: unknown[], owner?: ListOwner | null): Array<ListRow<T>>;
+/** Attach branded `fields` once. Keeps sibling keys (e.g. zoneId). */
+declare function attachFieldEnvelopes(props: Record<string, unknown> | null | undefined, sources?: EnvelopeSources | Record<string, ConnectionLike | null | undefined>): Record<string, unknown>;
+
 /**
  * Runtime page-data context: validate SDK-supplied entity fields against
  * the published pageData contract and attach to events.
@@ -266,4 +361,4 @@ interface EventTrackingConfig {
     componentName?: string | null;
 }
 
-export { type AmplifyContentMeta as A, type ContentSource as C, type EventTrackingConfig as E, type IdentifyInput as I, type PageConfig as P, type ZoneConfig as Z, type PageDataSnapshot as a, type CDPAdapter as b, type AmplifyUpConfig as c, type EventProperties as d, type AmplifyPageContextInput as e, type AttachedPageEventContext as f, type IdentifyTraits as g, type ProfileFieldsInput as h, type AmplifyUpTarget as i, resolveAmplifyUpUrls as j, isAmplifyUpTarget as k, normalizeAmplifyUpTarget as n, resolveAmplifyUpTarget as r };
+export { type AmplifyContentMeta as A, type PortableRef as B, type ContentSource as C, type EventTrackingConfig as E, type Field as F, type IdentifyInput as I, type LayoutComponentProps as L, type PageConfig as P, type ZoneConfig as Z, type PageDataSnapshot as a, type CDPAdapter as b, type AmplifyUpConfig as c, type EventProperties as d, type AmplifyPageContextInput as e, type AttachedPageEventContext as f, type IdentifyTraits as g, type ProfileFieldsInput as h, type AmplifyUpTarget as i, resolveAmplifyUpUrls as j, isAmplifyUpTarget as k, FIELDS_BRAND as l, attachFieldEnvelopes as m, normalizeAmplifyUpTarget as n, envelopeListRows as o, composerStoreKey as p, listOwnerFromSpec as q, resolveAmplifyUpTarget as r, isFieldEnvelope as s, toFieldEnvelopes as t, isReadOnlyRowField as u, isBrandedFields as v, type FieldRef as w, type Fields as x, type ListRow as y, type ImageValue as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amplifyup/sdk",
-  "version": "0.1.63",
+  "version": "0.1.65",
   "description": "AmplifyUp Tracking SDK - CDP-agnostic event tracking library",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/dist/AmplifyRenderer-Bwob7ICJ.d.ts

@@ -1,93 +0,0 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { P as PageConfig } from './types-Db_eLrfU.js';
-
-/**
- * Field envelopes — same shape in published, draft, and Composer edit.
- * `{ value, name }` where `name` is the full dot path (`hero.image`).
- * Produced once at the Edge resolve boundary (`fetchEdgeResolve`).
- */
-declare const FIELDS_BRAND: unique symbol;
-type ImageValue = {
-    url: string;
-    alt?: string;
-    width?: number;
-    height?: number;
-};
-type Field<T> = {
-    value: T;
-    name: string;
-};
-/** Portable entry ref after normalize (`id` required). */
-type PortableRef = {
-    id: string;
-    type?: string;
-};
-/**
- * Repeater envelope: each item is a `Fields` bag.
- * Paths are dotted indexes (`slides.0.title`).
- */
-type CollectionField<T extends Record<string, unknown>> = {
-    value: Array<Fields<T>>;
-    name: string;
-};
-type IsPlainObject<T> = T extends object ? T extends readonly unknown[] ? false : T extends ImageValue ? false : true : false;
-/** Resolved / authored entry refs carry `id` (see `stampPlatformIdentity`). */
-type IsEntryRefItem<T> = T extends {
-    id: string;
-} ? true : false;
-type AsRecord<T> = T extends Record<string, unknown> ? T : Record<string, unknown>;
-type FieldsProp<T> = NonNullable<T> extends ImageValue ? Field<T | null> : NonNullable<T> extends readonly (infer U)[] ? IsEntryRefItem<U> extends true ? Field<T> : IsPlainObject<U> extends true ? CollectionField<AsRecord<U>> : Field<T> : IsPlainObject<NonNullable<T>> extends true ? Fields<NonNullable<T>> : Field<T>;
-type Fields<T> = {
-    readonly [FIELDS_BRAND]: true;
-} & {
-    [K in keyof T]-?: FieldsProp<T[K]>;
-};
-/** Props passed into site components. Raw CMS bags are not assignable. */
-type LayoutComponentProps<T extends Record<string, unknown> = Record<string, unknown>> = {
-    fields: Fields<T>;
-};
-declare function isBrandedFields(value: unknown): value is Fields<Record<string, unknown>>;
-declare function isFieldEnvelope(value: unknown): value is Field<unknown>;
-/**
- * Wrap a props bag as envelopes. Already-enveloped bags are returned as-is.
- * Nested plain objects become nested bags; portable images stay a leaf.
- */
-declare function toFieldEnvelopes<T extends Record<string, unknown>>(source: T | null | undefined, prefix?: string): Fields<T>;
-
-interface AmplifyRendererProps {
-    /**
-     * Component renderer function that maps componentId to React component
-     * This is site-specific and must be provided by the developer
-     */
-    renderComponent: (componentId: string, props: LayoutComponentProps, slots?: Record<string, ReactNode>, context?: {
-        layoutNodeId: string;
-    }) => ReactNode;
-    /**
-     * Optional page config for server-side rendering (SSR/SSG)
-     * If provided, the component will use this instead of fetching client-side
-     */
-    pageConfig?: PageConfig;
-    /**
-     * Optional loading component
-     */
-    loadingComponent?: ReactNode;
-    /**
-     * Optional error component
-     */
-    errorComponent?: (error: string) => ReactNode;
-    /**
-     * Optional empty state component (when no content is configured)
-     */
-    emptyComponent?: ReactNode;
-    /**
-     * Force Composer page-slot wrapper (avoids SSR miss when window isn't available yet).
-     * When true, root components stay under [data-slot-source="page"] so hierarchy can climb to Page.
-     */
-    composerPreview?: boolean;
-}
-declare function AmplifyRendererInner({ renderComponent, pageConfig: serverPageConfig, loadingComponent, errorComponent, emptyComponent, composerPreview, }: AmplifyRendererProps): react_jsx_runtime.JSX.Element | null;
-declare const AmplifyRenderer: react.MemoExoticComponent<typeof AmplifyRendererInner>;
-
-export { AmplifyRenderer as A, type CollectionField as C, type Field as F, type ImageValue as I, type LayoutComponentProps as L, type PortableRef as P, type Fields as a, isBrandedFields as b, isFieldEnvelope as i, toFieldEnvelopes as t };

package/dist/AmplifyRenderer-TawbUIKZ.d.mts

@@ -1,93 +0,0 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { P as PageConfig } from './types-Db_eLrfU.mjs';
-
-/**
- * Field envelopes — same shape in published, draft, and Composer edit.
- * `{ value, name }` where `name` is the full dot path (`hero.image`).
- * Produced once at the Edge resolve boundary (`fetchEdgeResolve`).
- */
-declare const FIELDS_BRAND: unique symbol;
-type ImageValue = {
-    url: string;
-    alt?: string;
-    width?: number;
-    height?: number;
-};
-type Field<T> = {
-    value: T;
-    name: string;
-};
-/** Portable entry ref after normalize (`id` required). */
-type PortableRef = {
-    id: string;
-    type?: string;
-};
-/**
- * Repeater envelope: each item is a `Fields` bag.
- * Paths are dotted indexes (`slides.0.title`).
- */
-type CollectionField<T extends Record<string, unknown>> = {
-    value: Array<Fields<T>>;
-    name: string;
-};
-type IsPlainObject<T> = T extends object ? T extends readonly unknown[] ? false : T extends ImageValue ? false : true : false;
-/** Resolved / authored entry refs carry `id` (see `stampPlatformIdentity`). */
-type IsEntryRefItem<T> = T extends {
-    id: string;
-} ? true : false;
-type AsRecord<T> = T extends Record<string, unknown> ? T : Record<string, unknown>;
-type FieldsProp<T> = NonNullable<T> extends ImageValue ? Field<T | null> : NonNullable<T> extends readonly (infer U)[] ? IsEntryRefItem<U> extends true ? Field<T> : IsPlainObject<U> extends true ? CollectionField<AsRecord<U>> : Field<T> : IsPlainObject<NonNullable<T>> extends true ? Fields<NonNullable<T>> : Field<T>;
-type Fields<T> = {
-    readonly [FIELDS_BRAND]: true;
-} & {
-    [K in keyof T]-?: FieldsProp<T[K]>;
-};
-/** Props passed into site components. Raw CMS bags are not assignable. */
-type LayoutComponentProps<T extends Record<string, unknown> = Record<string, unknown>> = {
-    fields: Fields<T>;
-};
-declare function isBrandedFields(value: unknown): value is Fields<Record<string, unknown>>;
-declare function isFieldEnvelope(value: unknown): value is Field<unknown>;
-/**
- * Wrap a props bag as envelopes. Already-enveloped bags are returned as-is.
- * Nested plain objects become nested bags; portable images stay a leaf.
- */
-declare function toFieldEnvelopes<T extends Record<string, unknown>>(source: T | null | undefined, prefix?: string): Fields<T>;
-
-interface AmplifyRendererProps {
-    /**
-     * Component renderer function that maps componentId to React component
-     * This is site-specific and must be provided by the developer
-     */
-    renderComponent: (componentId: string, props: LayoutComponentProps, slots?: Record<string, ReactNode>, context?: {
-        layoutNodeId: string;
-    }) => ReactNode;
-    /**
-     * Optional page config for server-side rendering (SSR/SSG)
-     * If provided, the component will use this instead of fetching client-side
-     */
-    pageConfig?: PageConfig;
-    /**
-     * Optional loading component
-     */
-    loadingComponent?: ReactNode;
-    /**
-     * Optional error component
-     */
-    errorComponent?: (error: string) => ReactNode;
-    /**
-     * Optional empty state component (when no content is configured)
-     */
-    emptyComponent?: ReactNode;
-    /**
-     * Force Composer page-slot wrapper (avoids SSR miss when window isn't available yet).
-     * When true, root components stay under [data-slot-source="page"] so hierarchy can climb to Page.
-     */
-    composerPreview?: boolean;
-}
-declare function AmplifyRendererInner({ renderComponent, pageConfig: serverPageConfig, loadingComponent, errorComponent, emptyComponent, composerPreview, }: AmplifyRendererProps): react_jsx_runtime.JSX.Element | null;
-declare const AmplifyRenderer: react.MemoExoticComponent<typeof AmplifyRendererInner>;
-
-export { AmplifyRenderer as A, type CollectionField as C, type Field as F, type ImageValue as I, type LayoutComponentProps as L, type PortableRef as P, type Fields as a, isBrandedFields as b, isFieldEnvelope as i, toFieldEnvelopes as t };