@ikas/bp-storefront 0.15.0

package/dist/storefront/src/functions/models/raffle/init.d.ts

@@ -0,0 +1,20 @@
+import { IkasRaffle } from "../../../../../storefront-models/src";
+/**
+ * Initializes an IkasRaffle by delegating initialization of each associated product via initIkasProduct.
+ *
+ * @ai-category Initialization, Raffle
+ * @ai-related initIkasProduct
+ *
+ * @param raffle - The raffle object containing products to initialize.
+ * @param locale - The locale code to pass to product initialization, or null to skip translation.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { initIkasRaffle } from "@ikas/bp-storefront";
+ * const raffle = { products: [{ name: "Prize Item", translations: [] }] };
+ * initIkasRaffle(raffle, "en");
+ * // Each product in raffle.products is now initialized with locale-specific data
+ * ```
+ */
+export declare function initIkasRaffle(raffle: IkasRaffle, locale: string | null): void;

package/dist/storefront/src/functions/models/state/init.d.ts

@@ -0,0 +1,20 @@
+import { IkasState } from "../../../../../storefront-models/src";
+/**
+ * Initializes an IkasState by applying locale-specific translations to the state name and cleaning up raw translation data.
+ *
+ * @ai-category Initialization, State
+ * @ai-related setIkasStateTranslations
+ *
+ * @param state - The state object to initialize with localized data.
+ * @param locale - The locale code to use for translation lookup, or null to skip translation.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { initIkasState } from "@ikas/bp-storefront";
+ * const state = { name: "Istanbul", locationTranslations: { en: "Istanbul", fr: "Istanbul" } };
+ * initIkasState(state, "en");
+ * // state.name is now set to the English translation
+ * ```
+ */
+export declare function initIkasState(state: IkasState, locale: string | null): void;

package/dist/storefront/src/functions/models/validator/account-info/index.d.ts

@@ -0,0 +1,87 @@
+import { AccountInfoForm } from "../../../../../../storefront-models/src";
+/**
+ * Initializes the account info form by loading the current customer's first name, last name, and phone from the store and setting default field states.
+ *
+ * @ai-category AccountInfo, Form, Validation
+ * @ai-related setAccountInfoFormFirstName, setAccountInfoFormLastName, setAccountInfoFormPhone, submitAccountInfoForm
+ *
+ * @param accountInfoForm - The AccountInfoForm instance to initialize.
+ * @returns A promise that resolves once the form fields have been populated with customer data.
+ *
+ * @example
+ * ```typescript
+ * import { initAccountInfoForm } from "@ikas/bp-storefront";
+ * await initAccountInfoForm(accountInfoForm);
+ * ```
+ */
+export declare function initAccountInfoForm(accountInfoForm: AccountInfoForm): Promise<void>;
+/**
+ * Sets the first name field on the account info form and re-validates if the form has already been submitted.
+ *
+ * @ai-category AccountInfo, Form
+ * @ai-related setAccountInfoFormLastName, setAccountInfoFormPhone, initAccountInfoForm, submitAccountInfoForm
+ *
+ * @param accountInfoForm - The AccountInfoForm instance to update.
+ * @param value - The new first name value.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAccountInfoFormFirstName } from "@ikas/bp-storefront";
+ * setAccountInfoFormFirstName(accountInfoForm, "Jane");
+ * ```
+ */
+export declare function setAccountInfoFormFirstName(accountInfoForm: AccountInfoForm, value: string): void;
+/**
+ * Sets the last name field on the account info form and re-validates if the form has already been submitted.
+ *
+ * @ai-category AccountInfo, Form
+ * @ai-related setAccountInfoFormFirstName, setAccountInfoFormPhone, initAccountInfoForm, submitAccountInfoForm
+ *
+ * @param accountInfoForm - The AccountInfoForm instance to update.
+ * @param value - The new last name value.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAccountInfoFormLastName } from "@ikas/bp-storefront";
+ * setAccountInfoFormLastName(accountInfoForm, "Doe");
+ * ```
+ */
+export declare function setAccountInfoFormLastName(accountInfoForm: AccountInfoForm, value: string): void;
+/**
+ * Sets the phone number field on the account info form and re-validates if the form has already been submitted.
+ *
+ * @ai-category AccountInfo, Form
+ * @ai-related setAccountInfoFormFirstName, setAccountInfoFormLastName, initAccountInfoForm, submitAccountInfoForm
+ *
+ * @param accountInfoForm - The AccountInfoForm instance to update.
+ * @param value - The new phone number value.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAccountInfoFormPhone } from "@ikas/bp-storefront";
+ * setAccountInfoFormPhone(accountInfoForm, "+1234567890");
+ * ```
+ */
+export declare function setAccountInfoFormPhone(accountInfoForm: AccountInfoForm, value: string): void;
+/**
+ * Validates and submits the account info form, saving the updated customer first name, last name, and phone to the server.
+ *
+ * @ai-category AccountInfo, Form, Validation
+ * @ai-related initAccountInfoForm, setAccountInfoFormFirstName, setAccountInfoFormLastName, setAccountInfoFormPhone
+ *
+ * @param accountInfoForm - The AccountInfoForm instance to validate and submit.
+ * @returns A promise that resolves to `true` if the submission succeeded, or `false` if validation failed or the save request failed.
+ *
+ * @example
+ * ```typescript
+ * import { submitAccountInfoForm } from "@ikas/bp-storefront";
+ * const success = await submitAccountInfoForm(accountInfoForm);
+ * if (success) {
+ *   console.log("Account info updated successfully.");
+ * }
+ * ```
+ */
+export declare function submitAccountInfoForm(accountInfoForm: AccountInfoForm): Promise<boolean>;

package/dist/storefront/src/functions/models/validator/address/index.d.ts

@@ -0,0 +1,333 @@
+import { AddressForm, IkasCustomerAddress } from "../../../../../../storefront-models/src";
+/**
+ * Initializes an address form with default or existing address values, loads location data, and configures field settings.
+ *
+ * @ai-category Address, Form, Initialization, Checkout
+ * @ai-related submitAddressForm, setAddressFormCountry, setAddressFormState, setAddressFormCity
+ *
+ * @param addressForm - The address form instance to initialize.
+ * @param address - An optional existing customer address to pre-populate the form with.
+ * @returns A promise that resolves once the form is fully initialized, including country/state/city lists, field settings, checkout settings, and shipping zones.
+ *
+ * @example
+ * ```typescript
+ * import { initAddressForm } from "@ikas/bp-storefront";
+ *
+ * // Initialize an empty address form
+ * await initAddressForm(addressForm);
+ *
+ * // Initialize with an existing customer address for editing
+ * await initAddressForm(addressForm, existingAddress);
+ * ```
+ */
+export declare function initAddressForm(addressForm: AddressForm, address?: IkasCustomerAddress): Promise<void>;
+/**
+ * Sets the title field of an address form and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation
+ * @ai-related initAddressForm, submitAddressForm, setAddressFormFirstName, setAddressFormLastName
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The title value to set (e.g., "Home", "Work").
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormTitle } from "@ikas/bp-storefront";
+ *
+ * setAddressFormTitle(addressForm, "Home Address");
+ * ```
+ */
+export declare function setAddressFormTitle(addressForm: AddressForm, value: string): void;
+/**
+ * Sets the first name field of an address form and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation
+ * @ai-related initAddressForm, submitAddressForm, setAddressFormLastName, setAddressFormTitle
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The first name value to set.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormFirstName } from "@ikas/bp-storefront";
+ *
+ * setAddressFormFirstName(addressForm, "John");
+ * ```
+ */
+export declare function setAddressFormFirstName(addressForm: AddressForm, value: string): void;
+/**
+ * Sets the last name field of an address form and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation
+ * @ai-related initAddressForm, submitAddressForm, setAddressFormFirstName, setAddressFormTitle
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The last name value to set.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormLastName } from "@ikas/bp-storefront";
+ *
+ * setAddressFormLastName(addressForm, "Doe");
+ * ```
+ */
+export declare function setAddressFormLastName(addressForm: AddressForm, value: string): void;
+/**
+ * Sets the identity number field of an address form and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation
+ * @ai-related initAddressForm, submitAddressForm, setAddressFormFirstName, setAddressFormLastName
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The identity number value to set (e.g., national ID or tax ID).
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormIdentityNumber } from "@ikas/bp-storefront";
+ *
+ * setAddressFormIdentityNumber(addressForm, "12345678901");
+ * ```
+ */
+export declare function setAddressFormIdentityNumber(addressForm: AddressForm, value: string): void;
+/**
+ * Sets the primary address line field of an address form and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation
+ * @ai-related initAddressForm, submitAddressForm, setAddressFormAddressLine2, setAddressFormPostalCode
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The primary address line value to set (e.g., street address).
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormAddressLine1 } from "@ikas/bp-storefront";
+ *
+ * setAddressFormAddressLine1(addressForm, "123 Main Street");
+ * ```
+ */
+export declare function setAddressFormAddressLine1(addressForm: AddressForm, value: string): void;
+/**
+ * Sets the secondary address line field of an address form and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation
+ * @ai-related initAddressForm, submitAddressForm, setAddressFormAddressLine1, setAddressFormPostalCode
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The secondary address line value to set (e.g., apartment or suite number).
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormAddressLine2 } from "@ikas/bp-storefront";
+ *
+ * setAddressFormAddressLine2(addressForm, "Apt 4B");
+ * ```
+ */
+export declare function setAddressFormAddressLine2(addressForm: AddressForm, value: string): void;
+/**
+ * Sets the postal code field of an address form and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation
+ * @ai-related initAddressForm, submitAddressForm, setAddressFormAddressLine1, setAddressFormCountry
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The postal code value to set.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormPostalCode } from "@ikas/bp-storefront";
+ *
+ * setAddressFormPostalCode(addressForm, "34000");
+ * ```
+ */
+export declare function setAddressFormPostalCode(addressForm: AddressForm, value: string): void;
+/**
+ * Sets the country field of an address form, resets dependent location fields (state, city, district), refreshes the state list, and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation, Location
+ * @ai-related initAddressForm, setAddressFormState, setAddressFormCity, setAddressFormDistrict
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The country ID to set.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormCountry } from "@ikas/bp-storefront";
+ *
+ * setAddressFormCountry(addressForm, "country-id-123");
+ * ```
+ */
+export declare function setAddressFormCountry(addressForm: AddressForm, value: string): void;
+/**
+ * Sets the state field of an address form, resets dependent city and district fields (unless they are free-text), refreshes the city list, and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation, Location
+ * @ai-related initAddressForm, setAddressFormCountry, setAddressFormCity, setAddressFormDistrict
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The state ID to set.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormState } from "@ikas/bp-storefront";
+ *
+ * setAddressFormState(addressForm, "state-id-456");
+ * ```
+ */
+export declare function setAddressFormState(addressForm: AddressForm, value: string): void;
+/**
+ * Sets the city field of an address form, resets the district and district options, refreshes the district list (unless district is free-text), and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation, Location
+ * @ai-related initAddressForm, setAddressFormState, setAddressFormDistrict, setAddressFormCountry
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The city ID to set.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormCity } from "@ikas/bp-storefront";
+ *
+ * setAddressFormCity(addressForm, "city-id-789");
+ * ```
+ */
+export declare function setAddressFormCity(addressForm: AddressForm, value: string): void;
+/**
+ * Sets the district field of an address form, resets the region field and region options, and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation, Location
+ * @ai-related initAddressForm, setAddressFormCity, setAddressFormRegion, setAddressFormState
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The district ID to set.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormDistrict } from "@ikas/bp-storefront";
+ *
+ * setAddressFormDistrict(addressForm, "district-id-012");
+ * ```
+ */
+export declare function setAddressFormDistrict(addressForm: AddressForm, value: string): void;
+/**
+ * Sets the region field of an address form and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation, Location
+ * @ai-related initAddressForm, setAddressFormDistrict, setAddressFormCity, submitAddressForm
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The region ID to set.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormRegion } from "@ikas/bp-storefront";
+ *
+ * setAddressFormRegion(addressForm, "region-id-345");
+ * ```
+ */
+export declare function setAddressFormRegion(addressForm: AddressForm, value: string): void;
+/**
+ * Sets the phone number field of an address form and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation
+ * @ai-related initAddressForm, submitAddressForm, setAddressFormFirstName, setAddressFormCompany
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The phone number value to set.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormPhone } from "@ikas/bp-storefront";
+ *
+ * setAddressFormPhone(addressForm, "+905551234567");
+ * ```
+ */
+export declare function setAddressFormPhone(addressForm: AddressForm, value: string): void;
+/**
+ * Sets the company name field of an address form and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation
+ * @ai-related initAddressForm, submitAddressForm, setAddressFormTaxOffice, setAddressFormTaxNumber
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The company name value to set.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormCompany } from "@ikas/bp-storefront";
+ *
+ * setAddressFormCompany(addressForm, "Acme Corp");
+ * ```
+ */
+export declare function setAddressFormCompany(addressForm: AddressForm, value: string): void;
+/**
+ * Sets the tax office field of an address form and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation
+ * @ai-related initAddressForm, submitAddressForm, setAddressFormCompany, setAddressFormTaxNumber
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The tax office name value to set.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormTaxOffice } from "@ikas/bp-storefront";
+ *
+ * setAddressFormTaxOffice(addressForm, "Istanbul Tax Office");
+ * ```
+ */
+export declare function setAddressFormTaxOffice(addressForm: AddressForm, value: string): void;
+/**
+ * Sets the tax number field of an address form and re-validates if the form has been submitted.
+ *
+ * @ai-category Address, Form, Validation
+ * @ai-related initAddressForm, submitAddressForm, setAddressFormCompany, setAddressFormTaxOffice
+ *
+ * @param addressForm - The address form instance to update.
+ * @param value - The tax number value to set.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setAddressFormTaxNumber } from "@ikas/bp-storefront";
+ *
+ * setAddressFormTaxNumber(addressForm, "1234567890");
+ * ```
+ */
+export declare function setAddressFormTaxNumber(addressForm: AddressForm, value: string): void;
+/**
+ * Validates and submits the address form, saving the address to the customer's profile as either a new entry or an update to an existing address.
+ *
+ * @ai-category Address, Form, Validation, Checkout, Submission
+ * @ai-related initAddressForm, setAddressFormTitle, setAddressFormFirstName, setAddressFormCountry
+ *
+ * @param addressForm - The address form instance to validate and submit.
+ * @returns A promise that resolves to `true` if the address was saved successfully, or `false` if validation failed or the save operation encountered an error.
+ *
+ * @example
+ * ```typescript
+ * import { submitAddressForm } from "@ikas/bp-storefront";
+ *
+ * const success = await submitAddressForm(addressForm);
+ * if (success) {
+ *   console.log("Address saved successfully");
+ * } else {
+ *   console.log("Address save failed:", addressForm.responseMessage);
+ * }
+ * ```
+ */
+export declare function submitAddressForm(addressForm: AddressForm): Promise<boolean>;

package/dist/storefront/src/functions/models/validator/back-in-stock-notification/index.d.ts

@@ -0,0 +1,54 @@
+import { BackInStockNotificationForm, IkasProductVariant } from "../../../../../../storefront-models/src";
+/**
+ * Initializes the back-in-stock notification form by associating it with a product variant and setting up the email field with localized label and placeholder.
+ *
+ * @ai-category BackInStock, Form, Validation
+ * @ai-related setBackInStockNotificationFormEmail, submitBackInStockNotificationForm
+ *
+ * @param backInStockNotificationForm - The BackInStockNotificationForm instance to initialize.
+ * @param variant - The product variant the customer wants to be notified about when it is back in stock.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { initBackInStockNotificationForm } from "@ikas/bp-storefront";
+ * initBackInStockNotificationForm(backInStockNotificationForm, selectedVariant);
+ * ```
+ */
+export declare function initBackInStockNotificationForm(backInStockNotificationForm: BackInStockNotificationForm, variant: IkasProductVariant): void;
+/**
+ * Sets the email field on the back-in-stock notification form and re-validates if the form has already been submitted.
+ *
+ * @ai-category BackInStock, Form
+ * @ai-related initBackInStockNotificationForm, submitBackInStockNotificationForm
+ *
+ * @param backInStockNotificationForm - The BackInStockNotificationForm instance to update.
+ * @param value - The new email address value.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setBackInStockNotificationFormEmail } from "@ikas/bp-storefront";
+ * setBackInStockNotificationFormEmail(backInStockNotificationForm, "user@example.com");
+ * ```
+ */
+export declare function setBackInStockNotificationFormEmail(backInStockNotificationForm: BackInStockNotificationForm, value: string): void;
+/**
+ * Validates and submits the back-in-stock notification form, registering the customer's email for a restock reminder on the associated product variant.
+ *
+ * @ai-category BackInStock, Form, Validation
+ * @ai-related initBackInStockNotificationForm, setBackInStockNotificationFormEmail
+ *
+ * @param backInStockNotificationForm - The BackInStockNotificationForm instance to validate and submit.
+ * @returns A promise that resolves to `true` if the submission succeeded, or `false` if validation failed or the save request failed.
+ *
+ * @example
+ * ```typescript
+ * import { submitBackInStockNotificationForm } from "@ikas/bp-storefront";
+ * const success = await submitBackInStockNotificationForm(backInStockNotificationForm);
+ * if (success) {
+ *   console.log("You will be notified when this item is back in stock.");
+ * }
+ * ```
+ */
+export declare function submitBackInStockNotificationForm(backInStockNotificationForm: BackInStockNotificationForm): Promise<boolean>;

package/dist/storefront/src/functions/models/validator/contact-form/index.d.ts

@@ -0,0 +1,121 @@
+import { ContactForm } from "../../../../../../storefront-models/src";
+/**
+ * Initializes the contact form with default field states for first name, last name, email, phone, and message, including localized labels and placeholders.
+ *
+ * @ai-category ContactForm, Form, Validation
+ * @ai-related setContactFormFirstName, setContactFormLastName, setContactFormEmail, setContactFormPhone, setContactFormMessage, submitContactForm
+ *
+ * @param contactForm - The ContactForm instance to initialize.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { initContactForm } from "@ikas/bp-storefront";
+ * initContactForm(contactForm);
+ * ```
+ */
+export declare function initContactForm(contactForm: ContactForm): void;
+/**
+ * Sets the first name field on the contact form and re-validates if the form has already been submitted.
+ *
+ * @ai-category ContactForm, Form
+ * @ai-related setContactFormLastName, setContactFormEmail, setContactFormPhone, setContactFormMessage, initContactForm, submitContactForm
+ *
+ * @param contactForm - The ContactForm instance to update.
+ * @param value - The new first name value.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setContactFormFirstName } from "@ikas/bp-storefront";
+ * setContactFormFirstName(contactForm, "Jane");
+ * ```
+ */
+export declare function setContactFormFirstName(contactForm: ContactForm, value: string): void;
+/**
+ * Sets the last name field on the contact form and re-validates if the form has already been submitted.
+ *
+ * @ai-category ContactForm, Form
+ * @ai-related setContactFormFirstName, setContactFormEmail, setContactFormPhone, setContactFormMessage, initContactForm, submitContactForm
+ *
+ * @param contactForm - The ContactForm instance to update.
+ * @param value - The new last name value.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setContactFormLastName } from "@ikas/bp-storefront";
+ * setContactFormLastName(contactForm, "Doe");
+ * ```
+ */
+export declare function setContactFormLastName(contactForm: ContactForm, value: string): void;
+/**
+ * Sets the email field on the contact form and re-validates if the form has already been submitted.
+ *
+ * @ai-category ContactForm, Form
+ * @ai-related setContactFormFirstName, setContactFormLastName, setContactFormPhone, setContactFormMessage, initContactForm, submitContactForm
+ *
+ * @param contactForm - The ContactForm instance to update.
+ * @param value - The new email value.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setContactFormEmail } from "@ikas/bp-storefront";
+ * setContactFormEmail(contactForm, "user@example.com");
+ * ```
+ */
+export declare function setContactFormEmail(contactForm: ContactForm, value: string): void;
+/**
+ * Sets the phone field on the contact form and re-validates if the form has already been submitted.
+ *
+ * @ai-category ContactForm, Form
+ * @ai-related setContactFormFirstName, setContactFormLastName, setContactFormEmail, setContactFormMessage, initContactForm, submitContactForm
+ *
+ * @param contactForm - The ContactForm instance to update.
+ * @param value - The new phone number value.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setContactFormPhone } from "@ikas/bp-storefront";
+ * setContactFormPhone(contactForm, "+1234567890");
+ * ```
+ */
+export declare function setContactFormPhone(contactForm: ContactForm, value: string): void;
+/**
+ * Sets the message field on the contact form and re-validates if the form has already been submitted.
+ *
+ * @ai-category ContactForm, Form
+ * @ai-related setContactFormFirstName, setContactFormLastName, setContactFormEmail, setContactFormPhone, initContactForm, submitContactForm
+ *
+ * @param contactForm - The ContactForm instance to update.
+ * @param value - The new message value.
+ * @returns void
+ *
+ * @example
+ * ```typescript
+ * import { setContactFormMessage } from "@ikas/bp-storefront";
+ * setContactFormMessage(contactForm, "I have a question about my order.");
+ * ```
+ */
+export declare function setContactFormMessage(contactForm: ContactForm, value: string): void;
+/**
+ * Validates and submits the contact form, sending the first name, last name, email, phone, message, and current page URL to the server.
+ *
+ * @ai-category ContactForm, Form, Validation
+ * @ai-related initContactForm, setContactFormFirstName, setContactFormLastName, setContactFormEmail, setContactFormPhone, setContactFormMessage
+ *
+ * @param contactForm - The ContactForm instance to validate and submit.
+ * @returns A promise that resolves to `true` if the submission succeeded, or `false` if validation failed or the save request failed.
+ *
+ * @example
+ * ```typescript
+ * import { submitContactForm } from "@ikas/bp-storefront";
+ * const success = await submitContactForm(contactForm);
+ * if (success) {
+ *   console.log("Contact form submitted successfully.");
+ * }
+ * ```
+ */
+export declare function submitContactForm(contactForm: ContactForm): Promise<boolean>;