@amplifyup/sdk 0.2.5 → 0.3.1-uat.104.gfd92fe0

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { P as PageConfig, C as ContentSource, a as AmplifyContentMeta, E as EventTrackingConfig$1, c as PageDataSnapshot, R as ResolvedPageResourceRef, d as PageTaxonomies, e as CDPAdapter, f as AmplifyUpConfig, g as EventProperties, h as AmplifyPageContextInput, i as AttachedPageEventContext, I as IdentifyInput, j as IdentifyTraits, k as ProfileFieldsInput, A as AmplifyUpTarget } from './types-ffQNIQCK.mjs';
-export { Z as ZoneConfig, l as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, b as resolveAmplifyUpUrls } from './types-ffQNIQCK.mjs';
+import { P as PageConfig, C as ContentSource, A as AmplifyContentMeta, E as EventTrackingConfig$1, a as PageDataSnapshot, R as ResolvedPageResourceRef, b as PageTaxonomies, c as CDPAdapter, d as AmplifyUpConfig, e as EventProperties, f as AmplifyPageContextInput, g as AttachedPageEventContext, I as IdentifyInput, h as IdentifyTraits, i as ProfileFieldsInput, j as AmplifyUpTarget } from './types-CxucvIL6.mjs';
+export { Z as ZoneConfig, k as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, l as resolveAmplifyUpUrls } from './types-CxucvIL6.mjs';
 export { i as isComposerPreview, a as isPreviewRequest, b as isWorkingContentRequest } from './preview-_vHmzRen.mjs';
 export { A as AMPLIFYUP_EDITOR_ROUTE, i as isAmplifyUpEditorRoute } from './reservedRoutes-aGgViBDM.mjs';
-export { F as FetchEdgeQueryOptions, a as FetchEdgeSelectOptions, Q as QueryContentError, b as QueryContentOptions, c as QueryFilter, d as QueryFilterOp, e as QueryPagination, f as QueryResult, g as QuerySort, h as QuerySpec, S as SelectVariantsError, i as SelectVariantsOptions, j as SelectVariantsResult, k as fetchEdgeQuery, l as fetchEdgeSelect, n as nextPageSpec, q as queryContent, s as searchSpec, m as selectVariants } from './query-CYRvyIv0.mjs';
+export { F as FetchEdgeQueryOptions, a as FetchEdgeSelectOptions, Q as QueryContentError, b as QueryContentOptions, c as QueryFilter, d as QueryFilterOp, e as QueryPagination, f as QueryResult, g as QuerySort, h as QuerySpec, S as SelectVariantsError, i as SelectVariantsOptions, j as SelectVariantsResult, k as fetchEdgeQuery, l as fetchEdgeSelect, n as nextPageSpec, q as queryContent, s as searchSpec, m as selectVariants } from './query-CwtZtJX8.mjs';
 
 /**
  * Storage utilities for instance ID and user ID
@@ -118,6 +118,292 @@ declare function fetchEdgeResolve(options: {
     revalidate?: number | false;
 }): Promise<EdgeResolvedPayload>;
 
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+interface paths {
+    "/v1/forms/{formId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["getFormDefinition"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/forms/{formId}/submit": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["submitForm"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+interface components {
+    schemas: {
+        DeliveryErrorBody: {
+            error: string;
+        };
+        FormDefinition: {
+            id: string;
+            key: string;
+            version: number;
+            title?: string;
+            intro?: string;
+            /** @description Every field, in order. Renderers that ignore `steps` show these on one page. */
+            fields: components["schemas"]["FormField"][];
+            /** @description Headings, paragraphs and fields per step. Absent means one step with `fields` in order. */
+            steps?: components["schemas"]["FormStep"][];
+            submit: components["schemas"]["FormSubmitSettings"];
+            onSuccess: components["schemas"]["FormOnSuccess"];
+            honeypot: components["schemas"]["FormHoneypot"];
+        };
+        FormField: {
+            /** @description Key the submitted value is posted under. */
+            key: string;
+            type: components["schemas"]["FormFieldType"];
+            label?: string;
+            required?: boolean;
+            placeholder?: string;
+            /** @description For `select`, `radio` and `checkboxes`. */
+            options?: components["schemas"]["FormFieldOption"][];
+            /** @description Initial value; the posted value for `hidden`. */
+            defaultValue?: string;
+            /** @description Half-width fields sit side by side on wide screens. Defaults to full. */
+            width?: components["schemas"]["FormFieldWidth"];
+            /** @description For `hidden`: filled from this parameter of the page URL, when present. */
+            fromQuery?: components["schemas"]["FormQueryParam"];
+        };
+        FormFieldOption: {
+            label: string;
+            value: string;
+        };
+        /**
+         * @description Delivery API for published forms, as the form packages see it. GET  /v1/forms/{formId}?trackingId=          → FormDefinition POST /v1/forms/{formId}/submit?trackingId=   → SubmitFormSuccess | 422 SubmitFormValidationError   Optional header `x-amplifyup-consent: granted | denied` — what the site's consent banner reported.
+         *
+         *     Source of truth for `openapi/delivery.json` (scripts/generate-openapi.mjs). Never carries mapping metadata: what a submission writes to is platform-only.
+         * @enum {string}
+         */
+        FormFieldType: "text" | "email" | "phone" | "number" | "date" | "textarea" | "select" | "radio" | "checkboxes" | "checkbox" | "consent" | "hidden";
+        /** @enum {string} */
+        FormFieldWidth: "full" | "half";
+        FormHoneypot: {
+            /** @description Field name to post empty; bots that fill it are dropped. */
+            name: string;
+        };
+        FormOnSuccess: components["schemas"]["FormSuccessMessage"] | components["schemas"]["FormSuccessRedirect"];
+        /**
+         * @description UTM parameters a hidden field can be filled from.
+         * @enum {string}
+         */
+        FormQueryParam: "utm_source" | "utm_medium" | "utm_campaign" | "utm_term" | "utm_content";
+        /** @description One page of a multi-step form, in display order. */
+        FormStep: {
+            title?: string;
+            items: components["schemas"]["FormStepItem"][];
+        };
+        FormStepField: {
+            /** @constant */
+            kind: "field";
+            /** @description A key in `fields`. */
+            key: string;
+        };
+        FormStepItem: components["schemas"]["FormStepField"] | components["schemas"]["FormStepText"];
+        FormStepText: {
+            /** @enum {string} */
+            kind: "heading" | "paragraph";
+            text: string;
+        };
+        FormSubmitSettings: {
+            label: string;
+        };
+        FormSuccessMessage: {
+            /** @constant */
+            type: "message";
+            message: string;
+        };
+        FormSuccessRedirect: {
+            /** @constant */
+            type: "redirect";
+            url: string;
+        };
+        /** @description Text for most fields, true/false for `checkbox` and `consent`, the chosen values for `checkboxes`. */
+        FormValue: string | boolean | string[];
+        SubmitFormRequest: {
+            /** @description Field values by key, including the honeypot key. */
+            values: {
+                [key: string]: components["schemas"]["FormValue"];
+            };
+            /** @description The page the form was on. Only its path and UTM parameters are kept. */
+            page?: string;
+        };
+        SubmitFormSuccess: {
+            onSuccess: components["schemas"]["FormOnSuccess"];
+        };
+        SubmitFormValidationError: {
+            /** @description Message per field key. */
+            errors: {
+                [key: string]: string;
+            };
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+interface operations {
+    getFormDefinition: {
+        parameters: {
+            query: {
+                trackingId: string;
+            };
+            header?: never;
+            path: {
+                formId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Published form definition */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FormDefinition"];
+                };
+            };
+            /** @description Unknown tracking id or no published form */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DeliveryErrorBody"];
+                };
+            };
+        };
+    };
+    submitForm: {
+        parameters: {
+            query: {
+                trackingId: string;
+            };
+            header?: never;
+            path: {
+                formId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SubmitFormRequest"];
+            };
+        };
+        responses: {
+            /** @description Accepted */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SubmitFormSuccess"];
+                };
+            };
+            /** @description Unknown tracking id or no published form */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DeliveryErrorBody"];
+                };
+            };
+            /** @description Field errors */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SubmitFormValidationError"];
+                };
+            };
+        };
+    };
+}
+
+/**
+ * Typed client for published forms on the Amplify UP delivery API.
+ * Types are generated from the platform's API spec (see `npm run codegen`).
+ */
+
+type Schemas = components['schemas'];
+type FormDefinition = Schemas['FormDefinition'];
+type FormField = Schemas['FormField'];
+type FormFieldType = Schemas['FormFieldType'];
+type FormFieldOption = Schemas['FormFieldOption'];
+type FormOnSuccess = Schemas['FormOnSuccess'];
+type FormValue = Schemas['FormValue'];
+type FormValues = Schemas['SubmitFormRequest']['values'];
+type SubmitOperation = paths['/v1/forms/{formId}/submit']['post'];
+type SubmitAccepted = SubmitOperation['responses'][200]['content']['application/json'];
+type SubmitRejected = SubmitOperation['responses'][422]['content']['application/json'];
+type SubmitFormResult = {
+    ok: true;
+    onSuccess: SubmitAccepted['onSuccess'];
+} | {
+    ok: false;
+    errors: SubmitRejected['errors'];
+};
+declare class DeliveryRequestError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+type FormRequestOptions = {
+    fetch?: typeof fetch;
+};
+/** Load the published definition of a form. */
+declare const getFormDefinition: (formId: string, options?: FormRequestOptions) => Promise<FormDefinition>;
+/**
+ * Submit a form. Field errors (422) come back as `{ ok: false, errors }`;
+ * anything else that fails throws. Never submits from a Composer preview.
+ * Sends the visitor's consent (see `setConsent`) and the page it was on;
+ * only the page's path and UTM parameters are kept.
+ */
+declare const submitForm: (formId: string, values: FormValues, options?: FormRequestOptions) => Promise<SubmitFormResult>;
+
+/**
+ * What the site's consent banner reported for this visitor. Amplify UP sends
+ * it with form submissions; without it, answers are kept only if the site is
+ * set to treat visitors who haven't chosen as agreed.
+ *
+ * Call `setConsent('granted')` or `setConsent('denied')` whenever your banner
+ * learns the visitor's choice, and `setConsent(null)` to forget it.
+ */
+type ConsentState = 'granted' | 'denied';
+declare function setConsent(state: ConsentState | null): void;
+declare function getConsent(): ConsentState | null;
+
 /**
  * Map Edge /v1/resolve payload → PageConfig for AmplifyRenderer.
  * Prefers `tree` (full page skeleton with zones spliced in); falls back to
@@ -593,4 +879,4 @@ declare const verifyAWSConnection: () => {
 
 declare const _default: AmplifyUpSDK;
 
-export { ANON_COOKIE_NAME, AmplifyContentMeta, AmplifyPageContextInput, AmplifyUpConfig, AmplifyUpSDK, AmplifyUpTarget, CDPAdapter, ContentSource, DWELL_ACTIVITY_IDLE_MS, EdgeResolveError, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, type FetchContentOptions, type FetchContentResult, IdentifyInput, IdentifyTraits, PageConfig, PageDataSnapshot, PageTaxonomies, 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 };
+export { ANON_COOKIE_NAME, AmplifyContentMeta, AmplifyPageContextInput, AmplifyUpConfig, AmplifyUpSDK, AmplifyUpTarget, CDPAdapter, type ConsentState, ContentSource, DWELL_ACTIVITY_IDLE_MS, DeliveryRequestError, EdgeResolveError, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, type FetchContentOptions, type FetchContentResult, type FormDefinition, type FormField, type FormFieldOption, type FormFieldType, type FormOnSuccess, type FormValue, type FormValues, IdentifyInput, IdentifyTraits, PageConfig, PageDataSnapshot, PageTaxonomies, ProfileFieldsInput, SESSION_COOKIE_NAME, SESSION_IDLE_GAP_MS, type SubmitFormResult, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchContent, fetchEdgeResolve, fetchPageConfig, getConsent, getDiagnostics, getFormDefinition, getInstanceId, getOrchestratorUrl, getSDK, getSessionId, getStatus, getTarget, getTrackingId, getUserId, identify, init, mapResolvedToPageConfig, normalizeRoute, page, refreshEventTracking, reset, routeChange, setConsent, setProfileFields, setupComponentViewTracking, setupEventTracking, submitForm, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { P as PageConfig, C as ContentSource, a as AmplifyContentMeta, E as EventTrackingConfig$1, c as PageDataSnapshot, R as ResolvedPageResourceRef, d as PageTaxonomies, e as CDPAdapter, f as AmplifyUpConfig, g as EventProperties, h as AmplifyPageContextInput, i as AttachedPageEventContext, I as IdentifyInput, j as IdentifyTraits, k as ProfileFieldsInput, A as AmplifyUpTarget } from './types-ffQNIQCK.js';
-export { Z as ZoneConfig, l as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, b as resolveAmplifyUpUrls } from './types-ffQNIQCK.js';
+import { P as PageConfig, C as ContentSource, A as AmplifyContentMeta, E as EventTrackingConfig$1, a as PageDataSnapshot, R as ResolvedPageResourceRef, b as PageTaxonomies, c as CDPAdapter, d as AmplifyUpConfig, e as EventProperties, f as AmplifyPageContextInput, g as AttachedPageEventContext, I as IdentifyInput, h as IdentifyTraits, i as ProfileFieldsInput, j as AmplifyUpTarget } from './types-CxucvIL6.js';
+export { Z as ZoneConfig, k as isAmplifyUpTarget, n as normalizeAmplifyUpTarget, r as resolveAmplifyUpTarget, l as resolveAmplifyUpUrls } from './types-CxucvIL6.js';
 export { i as isComposerPreview, a as isPreviewRequest, b as isWorkingContentRequest } from './preview-_vHmzRen.js';
 export { A as AMPLIFYUP_EDITOR_ROUTE, i as isAmplifyUpEditorRoute } from './reservedRoutes-aGgViBDM.js';
-export { F as FetchEdgeQueryOptions, a as FetchEdgeSelectOptions, Q as QueryContentError, b as QueryContentOptions, c as QueryFilter, d as QueryFilterOp, e as QueryPagination, f as QueryResult, g as QuerySort, h as QuerySpec, S as SelectVariantsError, i as SelectVariantsOptions, j as SelectVariantsResult, k as fetchEdgeQuery, l as fetchEdgeSelect, n as nextPageSpec, q as queryContent, s as searchSpec, m as selectVariants } from './query-Bs5o-qmw.js';
+export { F as FetchEdgeQueryOptions, a as FetchEdgeSelectOptions, Q as QueryContentError, b as QueryContentOptions, c as QueryFilter, d as QueryFilterOp, e as QueryPagination, f as QueryResult, g as QuerySort, h as QuerySpec, S as SelectVariantsError, i as SelectVariantsOptions, j as SelectVariantsResult, k as fetchEdgeQuery, l as fetchEdgeSelect, n as nextPageSpec, q as queryContent, s as searchSpec, m as selectVariants } from './query-BeQibYGm.js';
 
 /**
  * Storage utilities for instance ID and user ID
@@ -118,6 +118,292 @@ declare function fetchEdgeResolve(options: {
     revalidate?: number | false;
 }): Promise<EdgeResolvedPayload>;
 
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+interface paths {
+    "/v1/forms/{formId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get: operations["getFormDefinition"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/forms/{formId}/submit": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post: operations["submitForm"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+interface components {
+    schemas: {
+        DeliveryErrorBody: {
+            error: string;
+        };
+        FormDefinition: {
+            id: string;
+            key: string;
+            version: number;
+            title?: string;
+            intro?: string;
+            /** @description Every field, in order. Renderers that ignore `steps` show these on one page. */
+            fields: components["schemas"]["FormField"][];
+            /** @description Headings, paragraphs and fields per step. Absent means one step with `fields` in order. */
+            steps?: components["schemas"]["FormStep"][];
+            submit: components["schemas"]["FormSubmitSettings"];
+            onSuccess: components["schemas"]["FormOnSuccess"];
+            honeypot: components["schemas"]["FormHoneypot"];
+        };
+        FormField: {
+            /** @description Key the submitted value is posted under. */
+            key: string;
+            type: components["schemas"]["FormFieldType"];
+            label?: string;
+            required?: boolean;
+            placeholder?: string;
+            /** @description For `select`, `radio` and `checkboxes`. */
+            options?: components["schemas"]["FormFieldOption"][];
+            /** @description Initial value; the posted value for `hidden`. */
+            defaultValue?: string;
+            /** @description Half-width fields sit side by side on wide screens. Defaults to full. */
+            width?: components["schemas"]["FormFieldWidth"];
+            /** @description For `hidden`: filled from this parameter of the page URL, when present. */
+            fromQuery?: components["schemas"]["FormQueryParam"];
+        };
+        FormFieldOption: {
+            label: string;
+            value: string;
+        };
+        /**
+         * @description Delivery API for published forms, as the form packages see it. GET  /v1/forms/{formId}?trackingId=          → FormDefinition POST /v1/forms/{formId}/submit?trackingId=   → SubmitFormSuccess | 422 SubmitFormValidationError   Optional header `x-amplifyup-consent: granted | denied` — what the site's consent banner reported.
+         *
+         *     Source of truth for `openapi/delivery.json` (scripts/generate-openapi.mjs). Never carries mapping metadata: what a submission writes to is platform-only.
+         * @enum {string}
+         */
+        FormFieldType: "text" | "email" | "phone" | "number" | "date" | "textarea" | "select" | "radio" | "checkboxes" | "checkbox" | "consent" | "hidden";
+        /** @enum {string} */
+        FormFieldWidth: "full" | "half";
+        FormHoneypot: {
+            /** @description Field name to post empty; bots that fill it are dropped. */
+            name: string;
+        };
+        FormOnSuccess: components["schemas"]["FormSuccessMessage"] | components["schemas"]["FormSuccessRedirect"];
+        /**
+         * @description UTM parameters a hidden field can be filled from.
+         * @enum {string}
+         */
+        FormQueryParam: "utm_source" | "utm_medium" | "utm_campaign" | "utm_term" | "utm_content";
+        /** @description One page of a multi-step form, in display order. */
+        FormStep: {
+            title?: string;
+            items: components["schemas"]["FormStepItem"][];
+        };
+        FormStepField: {
+            /** @constant */
+            kind: "field";
+            /** @description A key in `fields`. */
+            key: string;
+        };
+        FormStepItem: components["schemas"]["FormStepField"] | components["schemas"]["FormStepText"];
+        FormStepText: {
+            /** @enum {string} */
+            kind: "heading" | "paragraph";
+            text: string;
+        };
+        FormSubmitSettings: {
+            label: string;
+        };
+        FormSuccessMessage: {
+            /** @constant */
+            type: "message";
+            message: string;
+        };
+        FormSuccessRedirect: {
+            /** @constant */
+            type: "redirect";
+            url: string;
+        };
+        /** @description Text for most fields, true/false for `checkbox` and `consent`, the chosen values for `checkboxes`. */
+        FormValue: string | boolean | string[];
+        SubmitFormRequest: {
+            /** @description Field values by key, including the honeypot key. */
+            values: {
+                [key: string]: components["schemas"]["FormValue"];
+            };
+            /** @description The page the form was on. Only its path and UTM parameters are kept. */
+            page?: string;
+        };
+        SubmitFormSuccess: {
+            onSuccess: components["schemas"]["FormOnSuccess"];
+        };
+        SubmitFormValidationError: {
+            /** @description Message per field key. */
+            errors: {
+                [key: string]: string;
+            };
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+interface operations {
+    getFormDefinition: {
+        parameters: {
+            query: {
+                trackingId: string;
+            };
+            header?: never;
+            path: {
+                formId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Published form definition */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FormDefinition"];
+                };
+            };
+            /** @description Unknown tracking id or no published form */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DeliveryErrorBody"];
+                };
+            };
+        };
+    };
+    submitForm: {
+        parameters: {
+            query: {
+                trackingId: string;
+            };
+            header?: never;
+            path: {
+                formId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SubmitFormRequest"];
+            };
+        };
+        responses: {
+            /** @description Accepted */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SubmitFormSuccess"];
+                };
+            };
+            /** @description Unknown tracking id or no published form */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DeliveryErrorBody"];
+                };
+            };
+            /** @description Field errors */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SubmitFormValidationError"];
+                };
+            };
+        };
+    };
+}
+
+/**
+ * Typed client for published forms on the Amplify UP delivery API.
+ * Types are generated from the platform's API spec (see `npm run codegen`).
+ */
+
+type Schemas = components['schemas'];
+type FormDefinition = Schemas['FormDefinition'];
+type FormField = Schemas['FormField'];
+type FormFieldType = Schemas['FormFieldType'];
+type FormFieldOption = Schemas['FormFieldOption'];
+type FormOnSuccess = Schemas['FormOnSuccess'];
+type FormValue = Schemas['FormValue'];
+type FormValues = Schemas['SubmitFormRequest']['values'];
+type SubmitOperation = paths['/v1/forms/{formId}/submit']['post'];
+type SubmitAccepted = SubmitOperation['responses'][200]['content']['application/json'];
+type SubmitRejected = SubmitOperation['responses'][422]['content']['application/json'];
+type SubmitFormResult = {
+    ok: true;
+    onSuccess: SubmitAccepted['onSuccess'];
+} | {
+    ok: false;
+    errors: SubmitRejected['errors'];
+};
+declare class DeliveryRequestError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+type FormRequestOptions = {
+    fetch?: typeof fetch;
+};
+/** Load the published definition of a form. */
+declare const getFormDefinition: (formId: string, options?: FormRequestOptions) => Promise<FormDefinition>;
+/**
+ * Submit a form. Field errors (422) come back as `{ ok: false, errors }`;
+ * anything else that fails throws. Never submits from a Composer preview.
+ * Sends the visitor's consent (see `setConsent`) and the page it was on;
+ * only the page's path and UTM parameters are kept.
+ */
+declare const submitForm: (formId: string, values: FormValues, options?: FormRequestOptions) => Promise<SubmitFormResult>;
+
+/**
+ * What the site's consent banner reported for this visitor. Amplify UP sends
+ * it with form submissions; without it, answers are kept only if the site is
+ * set to treat visitors who haven't chosen as agreed.
+ *
+ * Call `setConsent('granted')` or `setConsent('denied')` whenever your banner
+ * learns the visitor's choice, and `setConsent(null)` to forget it.
+ */
+type ConsentState = 'granted' | 'denied';
+declare function setConsent(state: ConsentState | null): void;
+declare function getConsent(): ConsentState | null;
+
 /**
  * Map Edge /v1/resolve payload → PageConfig for AmplifyRenderer.
  * Prefers `tree` (full page skeleton with zones spliced in); falls back to
@@ -593,4 +879,4 @@ declare const verifyAWSConnection: () => {
 
 declare const _default: AmplifyUpSDK;
 
-export { ANON_COOKIE_NAME, AmplifyContentMeta, AmplifyPageContextInput, AmplifyUpConfig, AmplifyUpSDK, AmplifyUpTarget, CDPAdapter, ContentSource, DWELL_ACTIVITY_IDLE_MS, EdgeResolveError, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, type FetchContentOptions, type FetchContentResult, IdentifyInput, IdentifyTraits, PageConfig, PageDataSnapshot, PageTaxonomies, 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 };
+export { ANON_COOKIE_NAME, AmplifyContentMeta, AmplifyPageContextInput, AmplifyUpConfig, AmplifyUpSDK, AmplifyUpTarget, CDPAdapter, type ConsentState, ContentSource, DWELL_ACTIVITY_IDLE_MS, DeliveryRequestError, EdgeResolveError, EventProperties, EventTrackingConfig$1 as EventTrackingConfig, type FetchContentOptions, type FetchContentResult, type FormDefinition, type FormField, type FormFieldOption, type FormFieldType, type FormOnSuccess, type FormValue, type FormValues, IdentifyInput, IdentifyTraits, PageConfig, PageDataSnapshot, PageTaxonomies, ProfileFieldsInput, SESSION_COOKIE_NAME, SESSION_IDLE_GAP_MS, type SubmitFormResult, buildLayoutProviderUrl, buildPageRenderUrl, cleanupEventTracking, _default as default, fetchContent, fetchEdgeResolve, fetchPageConfig, getConsent, getDiagnostics, getFormDefinition, getInstanceId, getOrchestratorUrl, getSDK, getSessionId, getStatus, getTarget, getTrackingId, getUserId, identify, init, mapResolvedToPageConfig, normalizeRoute, page, refreshEventTracking, reset, routeChange, setConsent, setProfileFields, setupComponentViewTracking, setupEventTracking, submitForm, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };