@amplifyup/sdk 0.2.4 → 0.3.0

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 { 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-DYjs4LQQ.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,242 @@ 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;
+            fields: components["schemas"]["FormField"][];
+            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`. */
+            options?: components["schemas"]["FormFieldOption"][];
+            /** @description Initial value; the posted value for `hidden`. */
+            defaultValue?: string;
+        };
+        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
+         *
+         *     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" | "textarea" | "select" | "checkbox" | "hidden";
+        FormHoneypot: {
+            /** @description Field name to post empty; bots that fill it are dropped. */
+            name: string;
+        };
+        FormOnSuccess: components["schemas"]["FormSuccessMessage"] | components["schemas"]["FormSuccessRedirect"];
+        FormSubmitSettings: {
+            label: string;
+        };
+        FormSuccessMessage: {
+            /** @constant */
+            type: "message";
+            message: string;
+        };
+        FormSuccessRedirect: {
+            /** @constant */
+            type: "redirect";
+            url: string;
+        };
+        FormValue: string | boolean;
+        SubmitFormRequest: {
+            /** @description Field values by key, including the honeypot key. */
+            values: {
+                [key: string]: components["schemas"]["FormValue"];
+            };
+        };
+        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.
+ */
+declare const submitForm: (formId: string, values: FormValues, options?: FormRequestOptions) => Promise<SubmitFormResult>;
+
 /**
  * Map Edge /v1/resolve payload → PageConfig for AmplifyRenderer.
  * Prefers `tree` (full page skeleton with zones spliced in); falls back to
@@ -593,4 +829,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, 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, getDiagnostics, getFormDefinition, getInstanceId, getOrchestratorUrl, getSDK, getSessionId, getStatus, getTarget, getTrackingId, getUserId, identify, init, mapResolvedToPageConfig, normalizeRoute, page, refreshEventTracking, reset, routeChange, 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 { 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-Xo9cy-2F.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,242 @@ 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;
+            fields: components["schemas"]["FormField"][];
+            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`. */
+            options?: components["schemas"]["FormFieldOption"][];
+            /** @description Initial value; the posted value for `hidden`. */
+            defaultValue?: string;
+        };
+        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
+         *
+         *     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" | "textarea" | "select" | "checkbox" | "hidden";
+        FormHoneypot: {
+            /** @description Field name to post empty; bots that fill it are dropped. */
+            name: string;
+        };
+        FormOnSuccess: components["schemas"]["FormSuccessMessage"] | components["schemas"]["FormSuccessRedirect"];
+        FormSubmitSettings: {
+            label: string;
+        };
+        FormSuccessMessage: {
+            /** @constant */
+            type: "message";
+            message: string;
+        };
+        FormSuccessRedirect: {
+            /** @constant */
+            type: "redirect";
+            url: string;
+        };
+        FormValue: string | boolean;
+        SubmitFormRequest: {
+            /** @description Field values by key, including the honeypot key. */
+            values: {
+                [key: string]: components["schemas"]["FormValue"];
+            };
+        };
+        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.
+ */
+declare const submitForm: (formId: string, values: FormValues, options?: FormRequestOptions) => Promise<SubmitFormResult>;
+
 /**
  * Map Edge /v1/resolve payload → PageConfig for AmplifyRenderer.
  * Prefers `tree` (full page skeleton with zones spliced in); falls back to
@@ -593,4 +829,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, 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, getDiagnostics, getFormDefinition, getInstanceId, getOrchestratorUrl, getSDK, getSessionId, getStatus, getTarget, getTrackingId, getUserId, identify, init, mapResolvedToPageConfig, normalizeRoute, page, refreshEventTracking, reset, routeChange, setProfileFields, setupComponentViewTracking, setupEventTracking, submitForm, testTracking, track, trackClick, trackContentEngagement, trackContentView, trackFormFieldInteraction, trackFormSubmit, verifyAWSConnection };

package/dist/index.js

@@ -424,7 +424,7 @@ function isComposerPreview() {
 }
 
 // src/field-envelope.ts
-var FIELDS_BRAND = Symbol("amplifyup.fields");
+var FIELDS_BRAND = /* @__PURE__ */ Symbol("amplifyup.fields");
 var IDENTIFIER_KEYS = /* @__PURE__ */ new Set([
   "id",
   "_id",
@@ -1132,6 +1132,61 @@ async function fetchContent(options) {
   }
 }
 
+// src/delivery/forms.ts
+var DeliveryRequestError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.name = "DeliveryRequestError";
+    this.status = status;
+  }
+};
+var formUrl = (formId, suffix = "") => {
+  const sdk = getSDK();
+  const edgeUrl = sdk.getEdgeUrl();
+  const trackingId = sdk.getTrackingId();
+  if (!edgeUrl || !trackingId) {
+    throw new DeliveryRequestError("Amplify UP is not set up yet: call init() with your tracking ID first.", 0);
+  }
+  const base = edgeUrl.replace(/\/+$/, "");
+  const query = new URLSearchParams({ trackingId });
+  return `${base}/v1/forms/${encodeURIComponent(formId)}${suffix}?${query.toString()}`;
+};
+var errorMessage = async (response, fallback) => {
+  const body = await response.json().catch(() => ({}));
+  return body.error || `${fallback} (${response.status})`;
+};
+var getFormDefinition = async (formId, options = {}) => {
+  const fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
+  const response = await fetchFn(formUrl(formId), {
+    method: "GET",
+    headers: { Accept: "application/json" }
+  });
+  if (!response.ok) {
+    throw new DeliveryRequestError(await errorMessage(response, "Form failed to load"), response.status);
+  }
+  return await response.json();
+};
+var submitForm = async (formId, values, options = {}) => {
+  if (isComposerPreview()) {
+    throw new DeliveryRequestError("Forms do not submit in preview.", 0);
+  }
+  const fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
+  const response = await fetchFn(formUrl(formId, "/submit"), {
+    method: "POST",
+    headers: { Accept: "application/json", "Content-Type": "application/json" },
+    body: JSON.stringify({ values })
+  });
+  if (response.status === 422) {
+    const body2 = await response.json();
+    return { ok: false, errors: body2.errors };
+  }
+  if (!response.ok) {
+    throw new DeliveryRequestError(await errorMessage(response, "Form failed to submit"), response.status);
+  }
+  const body = await response.json();
+  return { ok: true, onSuccess: body.onSuccess };
+};
+
 // src/edge/select.ts
 var SelectVariantsError = class extends Error {
   constructor(message, status, body) {
@@ -3810,6 +3865,7 @@ exports.AMPLIFYUP_EDITOR_ROUTE = AMPLIFYUP_EDITOR_ROUTE;
 exports.ANON_COOKIE_NAME = ANON_COOKIE_NAME;
 exports.AmplifyUpSDK = AmplifyUpSDK;
 exports.DWELL_ACTIVITY_IDLE_MS = DWELL_ACTIVITY_IDLE_MS;
+exports.DeliveryRequestError = DeliveryRequestError;
 exports.EdgeResolveError = EdgeResolveError;
 exports.QueryContentError = QueryContentError;
 exports.SESSION_COOKIE_NAME = SESSION_COOKIE_NAME;
@@ -3825,6 +3881,7 @@ exports.fetchEdgeResolve = fetchEdgeResolve;
 exports.fetchEdgeSelect = fetchEdgeSelect;
 exports.fetchPageConfig = fetchPageConfig;
 exports.getDiagnostics = getDiagnostics;
+exports.getFormDefinition = getFormDefinition;
 exports.getInstanceId = getInstanceId2;
 exports.getOrchestratorUrl = getOrchestratorUrl;
 exports.getSDK = getSDK;
@@ -3856,6 +3913,7 @@ exports.selectVariants = selectVariants;
 exports.setProfileFields = setProfileFields;
 exports.setupComponentViewTracking = setupComponentViewTracking;
 exports.setupEventTracking = setupEventTracking;
+exports.submitForm = submitForm;
 exports.testTracking = testTracking;
 exports.track = track;
 exports.trackClick = trackClick;