@bigcommerce/checkout-sdk 1.308.1 → 1.308.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (345) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/dist/checkout-button.js +1 -1
  3. package/dist/checkout-button.umd.js +1 -1
  4. package/dist/checkout-sdk.js +1 -1
  5. package/dist/checkout-sdk.js.map +1 -1
  6. package/dist/checkout-sdk.umd.js +1 -1
  7. package/dist/checkout-sdk.umd.js.map +1 -1
  8. package/docs/README.md +158 -16
  9. package/docs/classes/internal_.CartChangedError.md +62 -0
  10. package/docs/classes/internal_.CheckoutService.md +1528 -0
  11. package/docs/classes/internal_.CurrencyService.md +56 -0
  12. package/docs/classes/internal_.EmbeddedCheckout.md +42 -0
  13. package/docs/classes/internal_.LanguageService.md +103 -0
  14. package/docs/classes/internal_.RequestError.md +108 -0
  15. package/docs/classes/internal_.StandardError.md +4 -0
  16. package/docs/enums/internal_.AdyenV2CardFields.md +31 -0
  17. package/docs/enums/internal_.AdyenV3CardFields.md +31 -0
  18. package/docs/enums/internal_.CheckoutIncludes.md +31 -0
  19. package/docs/enums/internal_.HostedFieldType.md +52 -0
  20. package/docs/enums/internal_.IconStyle.md +24 -0
  21. package/docs/enums/internal_.RadiusUnit.md +24 -0
  22. package/docs/interfaces/internal_.Address.md +4 -0
  23. package/docs/interfaces/internal_.AddressRequestBody.md +2 -0
  24. package/docs/interfaces/internal_.AdyenAdditionalActionCallbacks.md +70 -0
  25. package/docs/interfaces/internal_.AdyenAdditionalActionCallbacks_2.md +68 -0
  26. package/docs/interfaces/internal_.AdyenAdditionalActionOptions.md +108 -0
  27. package/docs/interfaces/internal_.AdyenAdditionalActionOptions_2.md +108 -0
  28. package/docs/interfaces/internal_.AdyenBaseCardComponentOptions.md +35 -0
  29. package/docs/interfaces/internal_.AdyenBaseCardComponentOptions_2.md +42 -0
  30. package/docs/interfaces/internal_.AdyenComponent.md +74 -0
  31. package/docs/interfaces/internal_.AdyenComponentEvents.md +76 -0
  32. package/docs/interfaces/internal_.AdyenComponentEvents_2.md +76 -0
  33. package/docs/interfaces/internal_.AdyenComponent_2.md +74 -0
  34. package/docs/interfaces/internal_.AdyenCreditCardComponentOptions.md +187 -0
  35. package/docs/interfaces/internal_.AdyenIdealComponentOptions.md +19 -0
  36. package/docs/interfaces/internal_.AdyenPaymentMethodState.md +23 -0
  37. package/docs/interfaces/internal_.AdyenPaymentMethodState_2.md +17 -0
  38. package/docs/interfaces/internal_.AdyenPlaceholderData.md +35 -0
  39. package/docs/interfaces/internal_.AdyenPlaceholderData_2.md +35 -0
  40. package/docs/interfaces/internal_.AdyenThreeDS2Options.md +99 -0
  41. package/docs/interfaces/internal_.AdyenV2PaymentInitializeOptions.md +162 -0
  42. package/docs/interfaces/internal_.AdyenV2ValidationState.md +59 -0
  43. package/docs/interfaces/internal_.AdyenV3CreditCardComponentOptions.md +198 -0
  44. package/docs/interfaces/internal_.AdyenV3PaymentInitializeOptions.md +137 -0
  45. package/docs/interfaces/internal_.AdyenV3ValidationState.md +59 -0
  46. package/docs/interfaces/internal_.AmazonPayCustomerInitializeOptions.md +67 -0
  47. package/docs/interfaces/internal_.AmazonPayOrderReference.md +32 -0
  48. package/docs/interfaces/internal_.AmazonPayPaymentInitializeOptions.md +102 -0
  49. package/docs/interfaces/internal_.AmazonPayShippingInitializeOptions.md +87 -0
  50. package/docs/interfaces/internal_.AmazonPayV2CustomerInitializeOptions.md +26 -0
  51. package/docs/interfaces/internal_.AmazonPayV2PaymentInitializeOptions.md +42 -0
  52. package/docs/interfaces/internal_.AmazonPayV2ShippingInitializeOptions.md +28 -0
  53. package/docs/interfaces/internal_.AmazonPayWidgetError.md +27 -0
  54. package/docs/interfaces/internal_.ApplePayCustomerInitializeOptions.md +79 -0
  55. package/docs/interfaces/internal_.ApplePayPaymentInitializeOptions.md +42 -0
  56. package/docs/interfaces/internal_.BankInstrument.md +114 -0
  57. package/docs/interfaces/internal_.Banner.md +24 -0
  58. package/docs/interfaces/internal_.BaseAccountInstrument.md +93 -0
  59. package/docs/interfaces/internal_.BaseCustomerInitializeOptions.md +237 -0
  60. package/docs/interfaces/internal_.BaseElementOptions.md +28 -0
  61. package/docs/interfaces/internal_.BaseElementOptions_2.md +50 -0
  62. package/docs/interfaces/internal_.BaseIndividualElementOptions.md +69 -0
  63. package/docs/interfaces/internal_.BaseInstrument.md +60 -0
  64. package/docs/interfaces/internal_.BasePaymentInitializeOptions.md +376 -0
  65. package/docs/interfaces/internal_.BillingAddress.md +184 -0
  66. package/docs/interfaces/internal_.BillingAddressRequestBody.md +155 -0
  67. package/docs/interfaces/internal_.BlockElementStyles.md +107 -0
  68. package/docs/interfaces/internal_.BlueSnapV2PaymentInitializeOptions.md +75 -0
  69. package/docs/interfaces/internal_.BlueSnapV2StyleProps.md +31 -0
  70. package/docs/interfaces/internal_.BodlEventsPayload.md +9 -0
  71. package/docs/interfaces/internal_.BodlService.md +172 -0
  72. package/docs/interfaces/internal_.BodyStyles.md +17 -0
  73. package/docs/interfaces/internal_.BoltCustomerInitializeOptions.md +32 -0
  74. package/docs/interfaces/internal_.BoltPaymentInitializeOptions.md +96 -0
  75. package/docs/interfaces/internal_.BraintreePaymentInitializeOptions.md +91 -0
  76. package/docs/interfaces/internal_.BraintreeThreeDSecureOptions.md +53 -0
  77. package/docs/interfaces/internal_.BraintreeVerifyPayload.md +53 -0
  78. package/docs/interfaces/internal_.BraintreeVisaCheckoutCustomerInitializeOptions.md +37 -0
  79. package/docs/interfaces/internal_.BraintreeVisaCheckoutPaymentInitializeOptions.md +72 -0
  80. package/docs/interfaces/internal_.BrowserInfo.md +52 -0
  81. package/docs/interfaces/internal_.ButtonResponse.md +21 -0
  82. package/docs/interfaces/internal_.ButtonStyles.md +143 -0
  83. package/docs/interfaces/internal_.CardCvcElementOptions.md +74 -0
  84. package/docs/interfaces/internal_.CardDataPaymentMethodState.md +17 -0
  85. package/docs/interfaces/internal_.CardDataPaymentMethodState_2.md +17 -0
  86. package/docs/interfaces/internal_.CardElementOptions.md +93 -0
  87. package/docs/interfaces/internal_.CardExpiryElementOptions.md +74 -0
  88. package/docs/interfaces/internal_.CardInstrument.md +117 -0
  89. package/docs/interfaces/internal_.CardNumberElementOptions.md +90 -0
  90. package/docs/interfaces/internal_.CardPaymentMethodState.md +62 -0
  91. package/docs/interfaces/internal_.CardPaymentMethodState_2.md +45 -0
  92. package/docs/interfaces/internal_.CardState.md +42 -0
  93. package/docs/interfaces/internal_.CardStateErrors.md +9 -0
  94. package/docs/interfaces/internal_.CardStateErrors_2.md +9 -0
  95. package/docs/interfaces/internal_.CardState_2.md +42 -0
  96. package/docs/interfaces/internal_.Cart.md +108 -0
  97. package/docs/interfaces/internal_.ChasePayCustomerInitializeOptions.md +17 -0
  98. package/docs/interfaces/internal_.ChasePayInitializeOptions.md +100 -0
  99. package/docs/interfaces/internal_.CheckableInputStyles.md +177 -0
  100. package/docs/interfaces/internal_.ChecklistStyles.md +129 -0
  101. package/docs/interfaces/internal_.Checkout.md +204 -0
  102. package/docs/interfaces/internal_.CheckoutParams.md +17 -0
  103. package/docs/interfaces/internal_.CheckoutPayment.md +44 -0
  104. package/docs/interfaces/internal_.CheckoutPaymentMethodExecutedOptions.md +17 -0
  105. package/docs/interfaces/internal_.CheckoutRequestBody.md +17 -0
  106. package/docs/interfaces/internal_.CheckoutSelectors.md +31 -0
  107. package/docs/interfaces/internal_.CheckoutServiceOptions.md +38 -0
  108. package/docs/interfaces/internal_.CheckoutSettings.md +203 -0
  109. package/docs/interfaces/internal_.CheckoutStoreErrorSelector.md +638 -0
  110. package/docs/interfaces/internal_.CheckoutStoreSelector.md +503 -0
  111. package/docs/interfaces/internal_.CheckoutStoreStatusSelector.md +760 -0
  112. package/docs/interfaces/internal_.Consignment.md +73 -0
  113. package/docs/interfaces/internal_.ConsignmentAssignmentBaseRequestBodyWithAddress.md +31 -0
  114. package/docs/interfaces/internal_.ConsignmentAssignmentBaseRequestBodyWithShippingAddress.md +31 -0
  115. package/docs/interfaces/internal_.ConsignmentCreateRequestBody.md +38 -0
  116. package/docs/interfaces/internal_.ConsignmentLineItem.md +24 -0
  117. package/docs/interfaces/internal_.ConsignmentPickupOption.md +17 -0
  118. package/docs/interfaces/internal_.ConsignmentUpdateRequestBody.md +45 -0
  119. package/docs/interfaces/internal_.Coordinates.md +24 -0
  120. package/docs/interfaces/internal_.Country.md +45 -0
  121. package/docs/interfaces/internal_.Coupon.md +45 -0
  122. package/docs/interfaces/internal_.CreditCardInstrument.md +87 -0
  123. package/docs/interfaces/internal_.CreditCardPlaceHolder.md +31 -0
  124. package/docs/interfaces/internal_.CreditCardPlaceHolder_2.md +31 -0
  125. package/docs/interfaces/internal_.CssProperties.md +213 -0
  126. package/docs/interfaces/internal_.CssProperties_2.md +213 -0
  127. package/docs/interfaces/internal_.Currency.md +38 -0
  128. package/docs/interfaces/internal_.CustomItem.md +52 -0
  129. package/docs/interfaces/internal_.Customer.md +93 -0
  130. package/docs/interfaces/internal_.CustomerAddress.md +184 -0
  131. package/docs/interfaces/internal_.CustomerCredentials.md +24 -0
  132. package/docs/interfaces/internal_.CustomerGroup.md +24 -0
  133. package/docs/interfaces/internal_.CustomerPasswordRequirements.md +38 -0
  134. package/docs/interfaces/internal_.CustomerRequestOptions.md +62 -0
  135. package/docs/interfaces/internal_.DigitalItem.md +312 -0
  136. package/docs/interfaces/internal_.DigitalRiverElementClasses.md +69 -0
  137. package/docs/interfaces/internal_.DigitalRiverPaymentInitializeOptions.md +148 -0
  138. package/docs/interfaces/internal_.Discount.md +24 -0
  139. package/docs/interfaces/internal_.DisplaySettings.md +17 -0
  140. package/docs/interfaces/internal_.EmbeddedCheckoutCompleteEvent.md +17 -0
  141. package/docs/interfaces/internal_.EmbeddedCheckoutError.md +31 -0
  142. package/docs/interfaces/internal_.EmbeddedCheckoutErrorEvent.md +24 -0
  143. package/docs/interfaces/internal_.EmbeddedCheckoutFrameErrorEvent.md +24 -0
  144. package/docs/interfaces/internal_.EmbeddedCheckoutFrameLoadedEvent.md +24 -0
  145. package/docs/interfaces/internal_.EmbeddedCheckoutLoadedEvent.md +17 -0
  146. package/docs/interfaces/internal_.EmbeddedCheckoutOptions.md +136 -0
  147. package/docs/interfaces/internal_.EmbeddedCheckoutSignedOutEvent.md +17 -0
  148. package/docs/interfaces/internal_.EmbeddedCheckoutStyles.md +143 -0
  149. package/docs/interfaces/internal_.EmbeddedContentOptions.md +17 -0
  150. package/docs/interfaces/internal_.ExecutePaymentMethodCheckoutOptions.md +95 -0
  151. package/docs/interfaces/internal_.FlashMessage.md +31 -0
  152. package/docs/interfaces/internal_.FormField.md +115 -0
  153. package/docs/interfaces/internal_.FormFieldItem.md +24 -0
  154. package/docs/interfaces/internal_.FormFieldOptions.md +31 -0
  155. package/docs/interfaces/internal_.FormFields.md +31 -0
  156. package/docs/interfaces/internal_.GatewayOrderPayment.md +110 -0
  157. package/docs/interfaces/internal_.GiftCertificate.md +45 -0
  158. package/docs/interfaces/internal_.GiftCertificateItem.md +80 -0
  159. package/docs/interfaces/internal_.GiftCertificateOrderPayment.md +96 -0
  160. package/docs/interfaces/{internal_.GooglePayButtonInitializeOptions.md → internal_.GooglePayCustomerInitializeOptions.md} +16 -5
  161. package/docs/interfaces/internal_.GooglePayPaymentInitializeOptions.md +95 -0
  162. package/docs/interfaces/internal_.HostedCardFieldOptions.md +37 -0
  163. package/docs/interfaces/internal_.HostedCardFieldOptionsMap.md +38 -0
  164. package/docs/interfaces/internal_.HostedFieldStylesMap.md +31 -0
  165. package/docs/interfaces/internal_.HostedFormOptions.md +116 -0
  166. package/docs/interfaces/internal_.HostedInputValidateErrorData.md +31 -0
  167. package/docs/interfaces/internal_.HostedInputValidateErrorDataMap.md +52 -0
  168. package/docs/interfaces/internal_.HostedInputValidateResults.md +24 -0
  169. package/docs/interfaces/internal_.HostedInstrument.md +24 -0
  170. package/docs/interfaces/internal_.HostedStoredCardFieldOptions.md +56 -0
  171. package/docs/interfaces/internal_.HostedStoredCardFieldOptionsMap.md +24 -0
  172. package/docs/interfaces/internal_.IbanElementOptions.md +84 -0
  173. package/docs/interfaces/internal_.IdealElementOptions.md +72 -0
  174. package/docs/interfaces/internal_.IndividualCardElementOptions.md +38 -0
  175. package/docs/interfaces/internal_.InitializationStrategy.md +23 -0
  176. package/docs/interfaces/internal_.InlineElementStyles.md +55 -0
  177. package/docs/interfaces/internal_.InputDetail.md +82 -0
  178. package/docs/interfaces/internal_.InputDetail_2.md +82 -0
  179. package/docs/interfaces/internal_.InputStyles.md +154 -0
  180. package/docs/interfaces/internal_.Item.md +24 -0
  181. package/docs/interfaces/internal_.Item_2.md +28 -0
  182. package/docs/interfaces/internal_.Item_3.md +28 -0
  183. package/docs/interfaces/internal_.KlarnaLoadResponse.md +30 -0
  184. package/docs/interfaces/internal_.KlarnaLoadResponse_2.md +30 -0
  185. package/docs/interfaces/internal_.KlarnaPaymentInitializeOptions.md +75 -0
  186. package/docs/interfaces/internal_.KlarnaV2PaymentInitializeOptions.md +75 -0
  187. package/docs/interfaces/internal_.LabelStyles.md +78 -0
  188. package/docs/interfaces/internal_.LanguageConfig.md +59 -0
  189. package/docs/interfaces/internal_.LineItem.md +163 -8
  190. package/docs/interfaces/internal_.LineItemCategory.md +17 -0
  191. package/docs/interfaces/internal_.LineItemMap.md +38 -0
  192. package/docs/interfaces/internal_.LineItemOption.md +38 -0
  193. package/docs/interfaces/internal_.LineItemSocialData.md +38 -0
  194. package/docs/interfaces/internal_.LinkStyles.md +92 -0
  195. package/docs/interfaces/internal_.LoadingIndicatorStyles.md +31 -0
  196. package/docs/interfaces/internal_.Locales.md +9 -0
  197. package/docs/interfaces/internal_.MasterpassCustomerInitializeOptions.md +19 -0
  198. package/docs/interfaces/internal_.MasterpassPaymentInitializeOptions.md +37 -0
  199. package/docs/interfaces/internal_.MolliePaymentInitializeOptions.md +126 -0
  200. package/docs/interfaces/internal_.MonerisPaymentInitializeOptions.md +59 -0
  201. package/docs/interfaces/internal_.MonerisStylingProps.md +82 -0
  202. package/docs/interfaces/internal_.NonceGenerationError.md +31 -0
  203. package/docs/interfaces/internal_.NonceInstrument.md +38 -0
  204. package/docs/interfaces/internal_.Option_2.md +24 -0
  205. package/docs/interfaces/internal_.OptionsResponse.md +79 -0
  206. package/docs/interfaces/internal_.OpyPaymentInitializeOptions.md +40 -0
  207. package/docs/interfaces/internal_.Order.md +199 -0
  208. package/docs/interfaces/internal_.OrderConsignment.md +17 -0
  209. package/docs/interfaces/internal_.OrderPayment.md +60 -0
  210. package/docs/interfaces/internal_.OrderPaymentRequestBody.md +41 -0
  211. package/docs/interfaces/internal_.OrderRequestBody.md +35 -0
  212. package/docs/interfaces/internal_.OrderShippingConsignment.md +220 -0
  213. package/docs/interfaces/internal_.PasswordRequirements.md +38 -0
  214. package/docs/interfaces/internal_.PayPalInstrument.md +93 -0
  215. package/docs/interfaces/internal_.PaymentMethod.md +100 -0
  216. package/docs/interfaces/internal_.PaymentMethodConfig.md +122 -0
  217. package/docs/interfaces/internal_.PaymentRequestOptions.md +69 -0
  218. package/docs/interfaces/internal_.PaymentSettings.md +24 -0
  219. package/docs/interfaces/internal_.PaypalCommerceCreditCardPaymentInitializeOptions.md +92 -0
  220. package/docs/interfaces/internal_.PaypalCommerceFormFieldCardTypeChangeEventData.md +17 -0
  221. package/docs/interfaces/internal_.PaypalCommerceFormFieldKeyboardEventData.md +17 -0
  222. package/docs/interfaces/internal_.PaypalCommerceFormFieldOptions.md +30 -0
  223. package/docs/interfaces/internal_.PaypalCommerceFormFieldStylesMap.md +31 -0
  224. package/docs/interfaces/internal_.PaypalCommerceFormFieldValidateErrorData.md +31 -0
  225. package/docs/interfaces/internal_.PaypalCommerceFormFieldValidateEventData.md +35 -0
  226. package/docs/interfaces/internal_.PaypalCommerceFormFieldsMap.md +38 -0
  227. package/docs/interfaces/internal_.PaypalCommerceFormOptions.md +150 -0
  228. package/docs/interfaces/internal_.PaypalCommercePaymentInitializeOptions.md +188 -0
  229. package/docs/interfaces/internal_.PaypalCommerceStoredCardFieldOptions.md +45 -0
  230. package/docs/interfaces/internal_.PaypalCommerceStoredCardFieldsMap.md +24 -0
  231. package/docs/interfaces/internal_.PaypalExpressPaymentInitializeOptions.md +38 -0
  232. package/docs/interfaces/internal_.PaypalFieldsStyleOptions.md +48 -0
  233. package/docs/interfaces/internal_.PhysicalItem.md +313 -0
  234. package/docs/interfaces/internal_.PickupMethod.md +45 -0
  235. package/docs/interfaces/internal_.PickupOptionResult.md +17 -0
  236. package/docs/interfaces/internal_.Promotion.md +17 -0
  237. package/docs/interfaces/internal_.Radius.md +24 -0
  238. package/docs/interfaces/internal_.Region.md +24 -0
  239. package/docs/interfaces/internal_.RequestOptions.md +5 -1
  240. package/docs/interfaces/internal_.SearchArea.md +24 -0
  241. package/docs/interfaces/internal_.SepaPlaceHolder.md +24 -0
  242. package/docs/interfaces/internal_.SepaPlaceHolder_2.md +24 -0
  243. package/docs/interfaces/internal_.ShippingInitializeOptions.md +100 -0
  244. package/docs/interfaces/internal_.ShippingOption.md +66 -0
  245. package/docs/interfaces/internal_.ShippingRequestOptions.md +67 -0
  246. package/docs/interfaces/internal_.ShopperConfig.md +31 -0
  247. package/docs/interfaces/internal_.ShopperCurrency.md +96 -0
  248. package/docs/interfaces/internal_.SignInEmail.md +24 -0
  249. package/docs/interfaces/internal_.SignInEmailRequestBody.md +24 -0
  250. package/docs/interfaces/internal_.SpamProtectionOptions.md +27 -0
  251. package/docs/interfaces/internal_.SquareFormElement.md +30 -0
  252. package/docs/interfaces/internal_.SquarePaymentInitializeOptions.md +133 -0
  253. package/docs/interfaces/internal_.StepStyles.md +122 -0
  254. package/docs/interfaces/internal_.StepTracker.md +66 -0
  255. package/docs/interfaces/internal_.StepTrackerConfig.md +17 -0
  256. package/docs/interfaces/internal_.StoreConfig.md +117 -0
  257. package/docs/interfaces/internal_.StoreCurrency.md +58 -0
  258. package/docs/interfaces/internal_.StoreLinks.md +59 -0
  259. package/docs/interfaces/internal_.StoreProfile.md +73 -0
  260. package/docs/interfaces/internal_.StripeCustomerEvent.md +76 -0
  261. package/docs/interfaces/internal_.StripeElementCSSProperties.md +172 -0
  262. package/docs/interfaces/internal_.StripeElementClasses.md +65 -0
  263. package/docs/interfaces/internal_.StripeElementStyle.md +46 -0
  264. package/docs/interfaces/internal_.StripeElementStyleVariant.md +289 -0
  265. package/docs/interfaces/internal_.StripeEvent.md +39 -0
  266. package/docs/interfaces/internal_.StripeShippingEvent.md +76 -0
  267. package/docs/interfaces/internal_.StripeUPECustomerInitializeOptions.md +94 -0
  268. package/docs/interfaces/internal_.StripeUPEPaymentInitializeOptions.md +72 -0
  269. package/docs/interfaces/internal_.StripeUPEShippingInitializeOptions.md +109 -0
  270. package/docs/interfaces/internal_.StripeV3PaymentInitializeOptions.md +78 -0
  271. package/docs/interfaces/internal_.StyleOptions.md +46 -0
  272. package/docs/interfaces/internal_.StyleOptions_2.md +46 -0
  273. package/docs/interfaces/internal_.SubInputDetail.md +64 -0
  274. package/docs/interfaces/internal_.SubInputDetail_2.md +64 -0
  275. package/docs/interfaces/internal_.Subscriptions.md +31 -0
  276. package/docs/interfaces/internal_.Tax.md +24 -0
  277. package/docs/interfaces/internal_.TextInputStyles.md +177 -0
  278. package/docs/interfaces/internal_.ThreeDSecure.md +52 -0
  279. package/docs/interfaces/internal_.ThreeDSecureToken.md +17 -0
  280. package/docs/interfaces/internal_.TranslationData.md +9 -0
  281. package/docs/interfaces/internal_.Translations.md +9 -0
  282. package/docs/interfaces/internal_.UnknownObject.md +9 -0
  283. package/docs/interfaces/internal_.VaultedInstrument.md +31 -0
  284. package/docs/interfaces/internal_.WechatDataPaymentMethodState.md +17 -0
  285. package/docs/interfaces/internal_.WechatDataPaymentMethodState_2.md +17 -0
  286. package/docs/interfaces/internal_.WechatState.md +17 -0
  287. package/docs/interfaces/internal_.WechatState_2.md +17 -0
  288. package/docs/interfaces/internal_.WithAccountCreation.md +17 -0
  289. package/docs/interfaces/internal_.WithAdyenV2PaymentInitializeOptions.md +20 -0
  290. package/docs/interfaces/internal_.WithAdyenV3PaymentInitializeOptions.md +20 -0
  291. package/docs/interfaces/internal_.WithApplePayCustomerInitializeOptions.md +20 -0
  292. package/docs/interfaces/internal_.WithApplePayPaymentInitializeOptions.md +20 -0
  293. package/docs/interfaces/internal_.WithCheckoutcomFawryInstrument.md +24 -0
  294. package/docs/interfaces/internal_.WithCheckoutcomSEPAInstrument.md +24 -0
  295. package/docs/interfaces/internal_.WithCheckoutcomiDealInstrument.md +17 -0
  296. package/docs/interfaces/internal_.WithDocumentInstrument.md +17 -0
  297. package/docs/interfaces/internal_.WithMollieIssuerInstrument.md +24 -0
  298. package/docs/interfaces/internal_.WorldpayAccessPaymentInitializeOptions.md +32 -0
  299. package/docs/interfaces/internal_.ZipCodeElementOptions.md +17 -0
  300. package/docs/modules/internal_.md +515 -51
  301. package/package.json +1 -1
  302. package/docs/classes/internal_.CheckoutButtonErrorSelector.md +0 -54
  303. package/docs/classes/internal_.CheckoutButtonInitializer.md +0 -179
  304. package/docs/classes/internal_.CheckoutButtonStatusSelector.md +0 -54
  305. package/docs/enums/internal_.AmazonPayV2ButtonColor.md +0 -31
  306. package/docs/enums/internal_.AmazonPayV2CheckoutLanguage.md +0 -59
  307. package/docs/enums/internal_.AmazonPayV2LedgerCurrency.md +0 -38
  308. package/docs/enums/internal_.AmazonPayV2PayOptions.md +0 -28
  309. package/docs/enums/internal_.AmazonPayV2Placement.md +0 -55
  310. package/docs/enums/internal_.CheckoutButtonMethodType.md +0 -164
  311. package/docs/enums/internal_.PaypalButtonStyleColorOption.md +0 -38
  312. package/docs/enums/internal_.PaypalButtonStyleLabelOption.md +0 -45
  313. package/docs/enums/internal_.PaypalButtonStyleLayoutOption.md +0 -24
  314. package/docs/enums/internal_.PaypalButtonStyleShapeOption.md +0 -24
  315. package/docs/enums/internal_.PaypalButtonStyleSizeOption.md +0 -38
  316. package/docs/enums/internal_.StyleButtonColor.md +0 -45
  317. package/docs/enums/internal_.StyleButtonLabel.md +0 -45
  318. package/docs/enums/internal_.StyleButtonLayout.md +0 -24
  319. package/docs/enums/internal_.StyleButtonShape.md +0 -24
  320. package/docs/interfaces/internal_.AmazonPayV2ButtonConfig.md +0 -82
  321. package/docs/interfaces/internal_.AmazonPayV2ButtonParams.md +0 -117
  322. package/docs/interfaces/internal_.AmazonPayV2CheckoutSession.md +0 -37
  323. package/docs/interfaces/internal_.AmazonPayV2CheckoutSessionConfig.md +0 -38
  324. package/docs/interfaces/internal_.AmazonPayV2NewButtonParams.md +0 -139
  325. package/docs/interfaces/internal_.AmazonPayV2Price.md +0 -28
  326. package/docs/interfaces/internal_.ApplePayButtonInitializeOptions.md +0 -40
  327. package/docs/interfaces/internal_.ApplePayButtonInitializeOptions_2.md +0 -40
  328. package/docs/interfaces/internal_.BaseCheckoutButtonInitializeOptions.md +0 -291
  329. package/docs/interfaces/internal_.BraintreeError.md +0 -37
  330. package/docs/interfaces/internal_.BraintreePaypalButtonInitializeOptions.md +0 -122
  331. package/docs/interfaces/internal_.BraintreePaypalCreditButtonInitializeOptions.md +0 -113
  332. package/docs/interfaces/internal_.BraintreeVenmoButtonInitializeOptions.md +0 -56
  333. package/docs/interfaces/internal_.BuyNowCartRequestBody.md +0 -26
  334. package/docs/interfaces/internal_.CheckoutButtonInitializerOptions.md +0 -24
  335. package/docs/interfaces/internal_.CheckoutButtonOptions.md +0 -57
  336. package/docs/interfaces/internal_.CheckoutButtonSelectors.md +0 -24
  337. package/docs/interfaces/internal_.PaypalButtonInitializeOptions.md +0 -78
  338. package/docs/interfaces/internal_.PaypalButtonStyleOptions.md +0 -66
  339. package/docs/interfaces/internal_.PaypalButtonStyleOptions_2.md +0 -69
  340. package/docs/interfaces/internal_.PaypalCommerceAlternativeMethodsButtonOptions.md +0 -61
  341. package/docs/interfaces/internal_.PaypalCommerceButtonInitializeOptions.md +0 -68
  342. package/docs/interfaces/internal_.PaypalCommerceCreditButtonInitializeOptions.md +0 -77
  343. package/docs/interfaces/internal_.PaypalCommerceInlineCheckoutButtonInitializeOptions.md +0 -58
  344. package/docs/interfaces/internal_.PaypalCommerceVenmoButtonInitializeOptions.md +0 -52
  345. package/docs/interfaces/internal_.WithApplePayButtonInitializeOptions.md +0 -17
@@ -0,0 +1,204 @@
1
+ [@bigcommerce/checkout-sdk](../README.md) / [<internal\>](../modules/internal_.md) / Checkout
2
+
3
+ # Interface: Checkout
4
+
5
+ [<internal>](../modules/internal_.md).Checkout
6
+
7
+ ## Table of contents
8
+
9
+ ### Properties
10
+
11
+ - [balanceDue](internal_.Checkout.md#balancedue)
12
+ - [billingAddress](internal_.Checkout.md#billingaddress)
13
+ - [cart](internal_.Checkout.md#cart)
14
+ - [channelId](internal_.Checkout.md#channelid)
15
+ - [consignments](internal_.Checkout.md#consignments)
16
+ - [coupons](internal_.Checkout.md#coupons)
17
+ - [createdTime](internal_.Checkout.md#createdtime)
18
+ - [customer](internal_.Checkout.md#customer)
19
+ - [customerMessage](internal_.Checkout.md#customermessage)
20
+ - [discounts](internal_.Checkout.md#discounts)
21
+ - [giftCertificates](internal_.Checkout.md#giftcertificates)
22
+ - [giftWrappingCostTotal](internal_.Checkout.md#giftwrappingcosttotal)
23
+ - [grandTotal](internal_.Checkout.md#grandtotal)
24
+ - [handlingCostTotal](internal_.Checkout.md#handlingcosttotal)
25
+ - [id](internal_.Checkout.md#id)
26
+ - [isStoreCreditApplied](internal_.Checkout.md#isstorecreditapplied)
27
+ - [orderId](internal_.Checkout.md#orderid)
28
+ - [outstandingBalance](internal_.Checkout.md#outstandingbalance)
29
+ - [payments](internal_.Checkout.md#payments)
30
+ - [promotions](internal_.Checkout.md#promotions)
31
+ - [shippingCostBeforeDiscount](internal_.Checkout.md#shippingcostbeforediscount)
32
+ - [shippingCostTotal](internal_.Checkout.md#shippingcosttotal)
33
+ - [shouldExecuteSpamCheck](internal_.Checkout.md#shouldexecutespamcheck)
34
+ - [subtotal](internal_.Checkout.md#subtotal)
35
+ - [taxTotal](internal_.Checkout.md#taxtotal)
36
+ - [taxes](internal_.Checkout.md#taxes)
37
+ - [updatedTime](internal_.Checkout.md#updatedtime)
38
+
39
+ ## Properties
40
+
41
+ ### balanceDue
42
+
43
+ • **balanceDue**: `number`
44
+
45
+ ___
46
+
47
+ ### billingAddress
48
+
49
+ • `Optional` **billingAddress**: [`BillingAddress`](internal_.BillingAddress.md)
50
+
51
+ ___
52
+
53
+ ### cart
54
+
55
+ • **cart**: [`Cart`](internal_.Cart.md)
56
+
57
+ ___
58
+
59
+ ### channelId
60
+
61
+ • **channelId**: `number`
62
+
63
+ ___
64
+
65
+ ### consignments
66
+
67
+ • **consignments**: [`Consignment`](internal_.Consignment.md)[]
68
+
69
+ ___
70
+
71
+ ### coupons
72
+
73
+ • **coupons**: [`Coupon`](internal_.Coupon.md)[]
74
+
75
+ ___
76
+
77
+ ### createdTime
78
+
79
+ • **createdTime**: `string`
80
+
81
+ ___
82
+
83
+ ### customer
84
+
85
+ • **customer**: [`Customer`](internal_.Customer.md)
86
+
87
+ ___
88
+
89
+ ### customerMessage
90
+
91
+ • **customerMessage**: `string`
92
+
93
+ ___
94
+
95
+ ### discounts
96
+
97
+ • **discounts**: [`Discount`](internal_.Discount.md)[]
98
+
99
+ ___
100
+
101
+ ### giftCertificates
102
+
103
+ • **giftCertificates**: [`GiftCertificate`](internal_.GiftCertificate.md)[]
104
+
105
+ ___
106
+
107
+ ### giftWrappingCostTotal
108
+
109
+ • **giftWrappingCostTotal**: `number`
110
+
111
+ ___
112
+
113
+ ### grandTotal
114
+
115
+ • **grandTotal**: `number`
116
+
117
+ ___
118
+
119
+ ### handlingCostTotal
120
+
121
+ • **handlingCostTotal**: `number`
122
+
123
+ ___
124
+
125
+ ### id
126
+
127
+ • **id**: `string`
128
+
129
+ ___
130
+
131
+ ### isStoreCreditApplied
132
+
133
+ • **isStoreCreditApplied**: `boolean`
134
+
135
+ ___
136
+
137
+ ### orderId
138
+
139
+ • `Optional` **orderId**: `number`
140
+
141
+ ___
142
+
143
+ ### outstandingBalance
144
+
145
+ • **outstandingBalance**: `number`
146
+
147
+ ___
148
+
149
+ ### payments
150
+
151
+ • `Optional` **payments**: [`CheckoutPayment`](internal_.CheckoutPayment.md)[]
152
+
153
+ ___
154
+
155
+ ### promotions
156
+
157
+ • `Optional` **promotions**: [`Promotion`](internal_.Promotion.md)[]
158
+
159
+ ___
160
+
161
+ ### shippingCostBeforeDiscount
162
+
163
+ • **shippingCostBeforeDiscount**: `number`
164
+
165
+ ___
166
+
167
+ ### shippingCostTotal
168
+
169
+ • **shippingCostTotal**: `number`
170
+
171
+ ___
172
+
173
+ ### shouldExecuteSpamCheck
174
+
175
+ • **shouldExecuteSpamCheck**: `boolean`
176
+
177
+ Whether the current checkout must execute spam protection
178
+ before placing the order.
179
+
180
+ Note: You need to enable Google ReCAPTCHA bot protection in your Checkout Settings.
181
+
182
+ ___
183
+
184
+ ### subtotal
185
+
186
+ • **subtotal**: `number`
187
+
188
+ ___
189
+
190
+ ### taxTotal
191
+
192
+ • **taxTotal**: `number`
193
+
194
+ ___
195
+
196
+ ### taxes
197
+
198
+ • **taxes**: [`Tax`](internal_.Tax.md)[]
199
+
200
+ ___
201
+
202
+ ### updatedTime
203
+
204
+ • **updatedTime**: `string`
@@ -0,0 +1,17 @@
1
+ [@bigcommerce/checkout-sdk](../README.md) / [<internal\>](../modules/internal_.md) / CheckoutParams
2
+
3
+ # Interface: CheckoutParams
4
+
5
+ [<internal>](../modules/internal_.md).CheckoutParams
6
+
7
+ ## Table of contents
8
+
9
+ ### Properties
10
+
11
+ - [include](internal_.CheckoutParams.md#include)
12
+
13
+ ## Properties
14
+
15
+ ### include
16
+
17
+ • `Optional` **include**: [`CheckoutIncludes`](../enums/internal_.CheckoutIncludes.md)[] \| [`CheckoutIncludeParam`](../modules/internal_.md#checkoutincludeparam)
@@ -0,0 +1,44 @@
1
+ [@bigcommerce/checkout-sdk](../README.md) / [<internal\>](../modules/internal_.md) / CheckoutPayment
2
+
3
+ # Interface: CheckoutPayment
4
+
5
+ [<internal>](../modules/internal_.md).CheckoutPayment
6
+
7
+ ## Table of contents
8
+
9
+ ### Properties
10
+
11
+ - [detail](internal_.CheckoutPayment.md#detail)
12
+ - [gatewayId](internal_.CheckoutPayment.md#gatewayid)
13
+ - [providerId](internal_.CheckoutPayment.md#providerid)
14
+ - [providerType](internal_.CheckoutPayment.md#providertype)
15
+
16
+ ## Properties
17
+
18
+ ### detail
19
+
20
+ • **detail**: `Object`
21
+
22
+ #### Type declaration
23
+
24
+ | Name | Type |
25
+ | :------ | :------ |
26
+ | `step` | `string` |
27
+
28
+ ___
29
+
30
+ ### gatewayId
31
+
32
+ • `Optional` **gatewayId**: `string`
33
+
34
+ ___
35
+
36
+ ### providerId
37
+
38
+ • **providerId**: `string`
39
+
40
+ ___
41
+
42
+ ### providerType
43
+
44
+ • **providerType**: `string`
@@ -0,0 +1,17 @@
1
+ [@bigcommerce/checkout-sdk](../README.md) / [<internal\>](../modules/internal_.md) / CheckoutPaymentMethodExecutedOptions
2
+
3
+ # Interface: CheckoutPaymentMethodExecutedOptions
4
+
5
+ [<internal>](../modules/internal_.md).CheckoutPaymentMethodExecutedOptions
6
+
7
+ ## Table of contents
8
+
9
+ ### Properties
10
+
11
+ - [hasBoltAccount](internal_.CheckoutPaymentMethodExecutedOptions.md#hasboltaccount)
12
+
13
+ ## Properties
14
+
15
+ ### hasBoltAccount
16
+
17
+ • `Optional` **hasBoltAccount**: `boolean`
@@ -0,0 +1,17 @@
1
+ [@bigcommerce/checkout-sdk](../README.md) / [<internal\>](../modules/internal_.md) / CheckoutRequestBody
2
+
3
+ # Interface: CheckoutRequestBody
4
+
5
+ [<internal>](../modules/internal_.md).CheckoutRequestBody
6
+
7
+ ## Table of contents
8
+
9
+ ### Properties
10
+
11
+ - [customerMessage](internal_.CheckoutRequestBody.md#customermessage)
12
+
13
+ ## Properties
14
+
15
+ ### customerMessage
16
+
17
+ • **customerMessage**: `string`
@@ -0,0 +1,31 @@
1
+ [@bigcommerce/checkout-sdk](../README.md) / [<internal\>](../modules/internal_.md) / CheckoutSelectors
2
+
3
+ # Interface: CheckoutSelectors
4
+
5
+ [<internal>](../modules/internal_.md).CheckoutSelectors
6
+
7
+ ## Table of contents
8
+
9
+ ### Properties
10
+
11
+ - [data](internal_.CheckoutSelectors.md#data)
12
+ - [errors](internal_.CheckoutSelectors.md#errors)
13
+ - [statuses](internal_.CheckoutSelectors.md#statuses)
14
+
15
+ ## Properties
16
+
17
+ ### data
18
+
19
+ • **data**: [`CheckoutStoreSelector`](internal_.CheckoutStoreSelector.md)
20
+
21
+ ___
22
+
23
+ ### errors
24
+
25
+ • **errors**: [`CheckoutStoreErrorSelector`](internal_.CheckoutStoreErrorSelector.md)
26
+
27
+ ___
28
+
29
+ ### statuses
30
+
31
+ • **statuses**: [`CheckoutStoreStatusSelector`](internal_.CheckoutStoreStatusSelector.md)
@@ -0,0 +1,38 @@
1
+ [@bigcommerce/checkout-sdk](../README.md) / [<internal\>](../modules/internal_.md) / CheckoutServiceOptions
2
+
3
+ # Interface: CheckoutServiceOptions
4
+
5
+ [<internal>](../modules/internal_.md).CheckoutServiceOptions
6
+
7
+ ## Table of contents
8
+
9
+ ### Properties
10
+
11
+ - [externalSource](internal_.CheckoutServiceOptions.md#externalsource)
12
+ - [host](internal_.CheckoutServiceOptions.md#host)
13
+ - [locale](internal_.CheckoutServiceOptions.md#locale)
14
+ - [shouldWarnMutation](internal_.CheckoutServiceOptions.md#shouldwarnmutation)
15
+
16
+ ## Properties
17
+
18
+ ### externalSource
19
+
20
+ • `Optional` **externalSource**: `string`
21
+
22
+ ___
23
+
24
+ ### host
25
+
26
+ • `Optional` **host**: `string`
27
+
28
+ ___
29
+
30
+ ### locale
31
+
32
+ • `Optional` **locale**: `string`
33
+
34
+ ___
35
+
36
+ ### shouldWarnMutation
37
+
38
+ • `Optional` **shouldWarnMutation**: `boolean`
@@ -0,0 +1,203 @@
1
+ [@bigcommerce/checkout-sdk](../README.md) / [<internal\>](../modules/internal_.md) / CheckoutSettings
2
+
3
+ # Interface: CheckoutSettings
4
+
5
+ [<internal>](../modules/internal_.md).CheckoutSettings
6
+
7
+ ## Table of contents
8
+
9
+ ### Properties
10
+
11
+ - [checkoutBillingSameAsShippingEnabled](internal_.CheckoutSettings.md#checkoutbillingsameasshippingenabled)
12
+ - [enableOrderComments](internal_.CheckoutSettings.md#enableordercomments)
13
+ - [enableTermsAndConditions](internal_.CheckoutSettings.md#enabletermsandconditions)
14
+ - [features](internal_.CheckoutSettings.md#features)
15
+ - [googleMapsApiKey](internal_.CheckoutSettings.md#googlemapsapikey)
16
+ - [googleRecaptchaSitekey](internal_.CheckoutSettings.md#googlerecaptchasitekey)
17
+ - [guestCheckoutEnabled](internal_.CheckoutSettings.md#guestcheckoutenabled)
18
+ - [hasMultiShippingEnabled](internal_.CheckoutSettings.md#hasmultishippingenabled)
19
+ - [isAccountCreationEnabled](internal_.CheckoutSettings.md#isaccountcreationenabled)
20
+ - [isAnalyticsEnabled](internal_.CheckoutSettings.md#isanalyticsenabled)
21
+ - [isCardVaultingEnabled](internal_.CheckoutSettings.md#iscardvaultingenabled)
22
+ - [isCouponCodeCollapsed](internal_.CheckoutSettings.md#iscouponcodecollapsed)
23
+ - [isPaymentRequestCanMakePaymentEnabled](internal_.CheckoutSettings.md#ispaymentrequestcanmakepaymentenabled)
24
+ - [isPaymentRequestEnabled](internal_.CheckoutSettings.md#ispaymentrequestenabled)
25
+ - [isSignInEmailEnabled](internal_.CheckoutSettings.md#issigninemailenabled)
26
+ - [isSpamProtectionEnabled](internal_.CheckoutSettings.md#isspamprotectionenabled)
27
+ - [isStorefrontSpamProtectionEnabled](internal_.CheckoutSettings.md#isstorefrontspamprotectionenabled)
28
+ - [isTrustedShippingAddressEnabled](internal_.CheckoutSettings.md#istrustedshippingaddressenabled)
29
+ - [orderTermsAndConditions](internal_.CheckoutSettings.md#ordertermsandconditions)
30
+ - [orderTermsAndConditionsLink](internal_.CheckoutSettings.md#ordertermsandconditionslink)
31
+ - [orderTermsAndConditionsType](internal_.CheckoutSettings.md#ordertermsandconditionstype)
32
+ - [privacyPolicyUrl](internal_.CheckoutSettings.md#privacypolicyurl)
33
+ - [providerWithCustomCheckout](internal_.CheckoutSettings.md#providerwithcustomcheckout)
34
+ - [realtimeShippingProviders](internal_.CheckoutSettings.md#realtimeshippingproviders)
35
+ - [remoteCheckoutProviders](internal_.CheckoutSettings.md#remotecheckoutproviders)
36
+ - [requiresMarketingConsent](internal_.CheckoutSettings.md#requiresmarketingconsent)
37
+ - [shippingQuoteFailedMessage](internal_.CheckoutSettings.md#shippingquotefailedmessage)
38
+
39
+ ## Properties
40
+
41
+ ### checkoutBillingSameAsShippingEnabled
42
+
43
+ • **checkoutBillingSameAsShippingEnabled**: `boolean`
44
+
45
+ ___
46
+
47
+ ### enableOrderComments
48
+
49
+ • **enableOrderComments**: `boolean`
50
+
51
+ ___
52
+
53
+ ### enableTermsAndConditions
54
+
55
+ • **enableTermsAndConditions**: `boolean`
56
+
57
+ ___
58
+
59
+ ### features
60
+
61
+ • **features**: `Object`
62
+
63
+ #### Index signature
64
+
65
+ ▪ [featureName: `string`]: `boolean`
66
+
67
+ ___
68
+
69
+ ### googleMapsApiKey
70
+
71
+ • **googleMapsApiKey**: `string`
72
+
73
+ ___
74
+
75
+ ### googleRecaptchaSitekey
76
+
77
+ • **googleRecaptchaSitekey**: `string`
78
+
79
+ ___
80
+
81
+ ### guestCheckoutEnabled
82
+
83
+ • **guestCheckoutEnabled**: `boolean`
84
+
85
+ ___
86
+
87
+ ### hasMultiShippingEnabled
88
+
89
+ • **hasMultiShippingEnabled**: `boolean`
90
+
91
+ ___
92
+
93
+ ### isAccountCreationEnabled
94
+
95
+ • **isAccountCreationEnabled**: `boolean`
96
+
97
+ ___
98
+
99
+ ### isAnalyticsEnabled
100
+
101
+ • **isAnalyticsEnabled**: `boolean`
102
+
103
+ ___
104
+
105
+ ### isCardVaultingEnabled
106
+
107
+ • **isCardVaultingEnabled**: `boolean`
108
+
109
+ ___
110
+
111
+ ### isCouponCodeCollapsed
112
+
113
+ • **isCouponCodeCollapsed**: `boolean`
114
+
115
+ ___
116
+
117
+ ### isPaymentRequestCanMakePaymentEnabled
118
+
119
+ • **isPaymentRequestCanMakePaymentEnabled**: `boolean`
120
+
121
+ ___
122
+
123
+ ### isPaymentRequestEnabled
124
+
125
+ • **isPaymentRequestEnabled**: `boolean`
126
+
127
+ ___
128
+
129
+ ### isSignInEmailEnabled
130
+
131
+ • **isSignInEmailEnabled**: `boolean`
132
+
133
+ ___
134
+
135
+ ### isSpamProtectionEnabled
136
+
137
+ • **isSpamProtectionEnabled**: `boolean`
138
+
139
+ ___
140
+
141
+ ### isStorefrontSpamProtectionEnabled
142
+
143
+ • **isStorefrontSpamProtectionEnabled**: `boolean`
144
+
145
+ ___
146
+
147
+ ### isTrustedShippingAddressEnabled
148
+
149
+ • **isTrustedShippingAddressEnabled**: `boolean`
150
+
151
+ ___
152
+
153
+ ### orderTermsAndConditions
154
+
155
+ • **orderTermsAndConditions**: `string`
156
+
157
+ ___
158
+
159
+ ### orderTermsAndConditionsLink
160
+
161
+ • **orderTermsAndConditionsLink**: `string`
162
+
163
+ ___
164
+
165
+ ### orderTermsAndConditionsType
166
+
167
+ • **orderTermsAndConditionsType**: `string`
168
+
169
+ ___
170
+
171
+ ### privacyPolicyUrl
172
+
173
+ • **privacyPolicyUrl**: `string`
174
+
175
+ ___
176
+
177
+ ### providerWithCustomCheckout
178
+
179
+ • **providerWithCustomCheckout**: ``null`` \| `string`
180
+
181
+ ___
182
+
183
+ ### realtimeShippingProviders
184
+
185
+ • **realtimeShippingProviders**: `string`[]
186
+
187
+ ___
188
+
189
+ ### remoteCheckoutProviders
190
+
191
+ • **remoteCheckoutProviders**: `any`[]
192
+
193
+ ___
194
+
195
+ ### requiresMarketingConsent
196
+
197
+ • **requiresMarketingConsent**: `boolean`
198
+
199
+ ___
200
+
201
+ ### shippingQuoteFailedMessage
202
+
203
+ • **shippingQuoteFailedMessage**: `string`