sfcc-dev-mcp 1.0.19 → 1.0.21

package/docs/dw_customer/Wallet.md

@@ -1,118 +0,0 @@
-## Package: dw.customer
-
-# Class Wallet
-
-## Inheritance Hierarchy
-
-- Object
-  - dw.customer.Wallet
-
-## Description
-
-Represents a set of payment instruments associated with a registered customer. Note: this class allows access to sensitive personal and private information. Pay attention to appropriate legal and regulatory requirements when developing.
-
-## Properties
-
-### paymentInstruments
-
-**Type:** Collection (Read Only)
-
-A collection of all payment instruments associated with the
- related customer.
-
-## Constructor Summary
-
-## Method Summary
-
-### createPaymentInstrument
-
-**Signature:** `createPaymentInstrument(paymentMethodId : String) : CustomerPaymentInstrument`
-
-Creates a new, empty payment instrument object associated with the related customer for the given payment method.
-
-### getPaymentInstruments
-
-**Signature:** `getPaymentInstruments() : Collection`
-
-Returns a collection of all payment instruments associated with the related customer.
-
-### getPaymentInstruments
-
-**Signature:** `getPaymentInstruments(paymentMethodID : String) : Collection`
-
-Returns a collection of all payment instruments associated with the related customer filtered by the given payment method id.
-
-### removePaymentInstrument
-
-**Signature:** `removePaymentInstrument(instrument : CustomerPaymentInstrument) : void`
-
-Removes a payment instrument associated with the customer.
-
-## Method Detail
-
-## Method Details
-
-### createPaymentInstrument
-
-**Signature:** `createPaymentInstrument(paymentMethodId : String) : CustomerPaymentInstrument`
-
-**Description:** Creates a new, empty payment instrument object associated with the related customer for the given payment method.
-
-**Parameters:**
-
-- `paymentMethodId`: the id of a payment method
-
-**Returns:**
-
-the new payment instrument object.
-
-**Throws:**
-
-NullArgumentException - If passed 'paymentMethodId' is null.
-
----
-
-### getPaymentInstruments
-
-**Signature:** `getPaymentInstruments() : Collection`
-
-**Description:** Returns a collection of all payment instruments associated with the related customer.
-
-**Returns:**
-
-Collection of all payment instruments.
-
----
-
-### getPaymentInstruments
-
-**Signature:** `getPaymentInstruments(paymentMethodID : String) : Collection`
-
-**Description:** Returns a collection of all payment instruments associated with the related customer filtered by the given payment method id. If null is passed as payment method id all payment instruments of the customer will be retrieved. If for the given payment method id no payment instrument is associated with the customer an empty collection will be returned.
-
-**Parameters:**
-
-- `paymentMethodID`: the paymentMethodID the payment method id to filter for
-
-**Returns:**
-
-Collection of payment instruments for a payment method.
-
----
-
-### removePaymentInstrument
-
-**Signature:** `removePaymentInstrument(instrument : CustomerPaymentInstrument) : void`
-
-**Description:** Removes a payment instrument associated with the customer.
-
-**Parameters:**
-
-- `instrument`: the instrument associated with this customer
-
-**Throws:**
-
-NullArgumentException - If passed 'instrument' is null.
-IllegalArgumentException - If passed 'instrument' belongs to an other customer
-
----

package/docs/dw_extensions.applepay/ApplePayHookResult.md

@@ -1,209 +0,0 @@
-## Package: dw.extensions.applepay
-
-# Class ApplePayHookResult
-
-## Inheritance Hierarchy
-
-- Object
-  - dw.extensions.applepay.ApplePayHookResult
-
-## Description
-
-Result of a hook handling an Apple Pay request. Use the constants in this type to indicate specific error reasons to be provided to Apple Pay JS. For example, the following code creates a Status that indicates the shipping contact information provided by Apple Pay is invalid: var ApplePayHookResult = require('dw/extensions/applepay/ApplePayHookResult'); var Status = require('dw/system/Status'); var error = new Status(Status.ERROR); error.addDetail(ApplePayHookResult.STATUS_REASON_DETAIL_KEY, ApplePayHookResult.REASON_SHIPPING_CONTACT); If a specific error reason is not provided, the generic Apple Pay STATUS_FAILURE reason will be used when necessary.
-
-## Constants
-
-### REASON_BILLING_ADDRESS
-
-**Type:** String = "InvalidBillingPostalAddress"
-
-Error reason code representing an invalid billing address.
-
-### REASON_FAILURE
-
-**Type:** String = "Failure"
-
-Error reason code representing an error or failure not otherwise specified.
-
-### REASON_PIN_INCORRECT
-
-**Type:** String = "PINIncorrect"
-
-Error reason code representing the PIN is incorrect.
-
-### REASON_PIN_LOCKOUT
-
-**Type:** String = "PINLockout"
-
-Error reason code representing a PIN lockout.
-
-### REASON_PIN_REQUIRED
-
-**Type:** String = "PINRequired"
-
-Error reason code representing a PIN is required.
-
-### REASON_SHIPPING_ADDRESS
-
-**Type:** String = "InvalidShippingPostalAddress"
-
-Error reason code representing an invalid shipping address.
-
-### REASON_SHIPPING_CONTACT
-
-**Type:** String = "InvalidShippingContact"
-
-Error reason code representing invalid shipping contact information.
-
-### STATUS_REASON_DETAIL_KEY
-
-**Type:** String = "reason"
-
-Key for the detail to be used in Status objects to indicate the reason to communicate to Apple Pay for errors.
-
-## Properties
-
-### eventDetail
-
-**Type:** Object (Read Only)
-
-Detail to the JS custom event to dispatch in response to this result.
-
-### eventName
-
-**Type:** String (Read Only)
-
-Name of the JS custom event to dispatch in response to this result.
-
-### redirect
-
-**Type:** URL (Read Only)
-
-URL to navigate to in response to this result.
-
-### status
-
-**Type:** Status (Read Only)
-
-Status describing the outcome of this result.
-
-## Constructor Summary
-
-ApplePayHookResult(status : Status, redirect : URL) Constructs a result with the given outcome information.
-
-## Method Summary
-
-### getEventDetail
-
-**Signature:** `getEventDetail() : Object`
-
-Detail to the JS custom event to dispatch in response to this result.
-
-### getEventName
-
-**Signature:** `getEventName() : String`
-
-Name of the JS custom event to dispatch in response to this result.
-
-### getRedirect
-
-**Signature:** `getRedirect() : URL`
-
-URL to navigate to in response to this result.
-
-### getStatus
-
-**Signature:** `getStatus() : Status`
-
-Status describing the outcome of this result.
-
-### setEvent
-
-**Signature:** `setEvent(name : String) : void`
-
-Sets the name of the JS custom event to dispatch in response to this result.
-
-### setEvent
-
-**Signature:** `setEvent(name : String, detail : Object) : void`
-
-Sets the name and detail of the JS custom event to dispatch in response to this result.
-
-## Constructor Detail
-
-## Method Detail
-
-## Method Details
-
-### getEventDetail
-
-**Signature:** `getEventDetail() : Object`
-
-**Description:** Detail to the JS custom event to dispatch in response to this result.
-
-**Returns:**
-
-event detail
-
----
-
-### getEventName
-
-**Signature:** `getEventName() : String`
-
-**Description:** Name of the JS custom event to dispatch in response to this result.
-
-**Returns:**
-
-event name
-
----
-
-### getRedirect
-
-**Signature:** `getRedirect() : URL`
-
-**Description:** URL to navigate to in response to this result.
-
-**Returns:**
-
-redirect URL
-
----
-
-### getStatus
-
-**Signature:** `getStatus() : Status`
-
-**Description:** Status describing the outcome of this result.
-
-**Returns:**
-
-status of this result
-
----
-
-### setEvent
-
-**Signature:** `setEvent(name : String) : void`
-
-**Description:** Sets the name of the JS custom event to dispatch in response to this result.
-
-**Parameters:**
-
-- `name`: JS custom event name
-
----
-
-### setEvent
-
-**Signature:** `setEvent(name : String, detail : Object) : void`
-
-**Description:** Sets the name and detail of the JS custom event to dispatch in response to this result.
-
-**Parameters:**
-
-- `name`: JS custom event name
-- `detail`: JS custom event detail
-
----

package/docs/dw_extensions.applepay/ApplePayHooks.md

@@ -1,255 +0,0 @@
-## Package: dw.extensions.applepay
-
-# Class ApplePayHooks
-
-## Inheritance Hierarchy
-
-- dw.extensions.applepay.ApplePayHooks
-
-## Description
-
-ApplePayHooks interface containing extension points for customizing Apple Pay. These hooks are executed in a transaction. The extension points (hook names), and the functions that are called by each extension point. A function must be defined inside a JavaScript source and must be exported. The script with the exported hook function must be located inside a site cartridge. Inside the site cartridge a 'package.json' file with a 'hooks' entry must exist. "hooks": "./hooks.json" The hooks entry links to a json file, relative to the 'package.json' file. This file lists all registered hooks inside the hooks property: "hooks": [ {"name": "dw.extensions.applepay.getRequest", "script": "./applepay.ds"} {"name": "dw.extensions.applepay.shippingContactSelected", "script": "./applepay.ds"} ] A hook entry has a 'name' and a 'script' property. The 'name' contains the extension point, the hook name. The 'script' contains the script relative to the hooks file, with the exported hook function.
-
-## Constants
-
-## Properties
-
-## Constructor Summary
-
-## Method Summary
-
-### authorizeOrderPayment
-
-**Signature:** `authorizeOrderPayment(order : Order, event : Object) : Status`
-
-Called to authorize the Apple Pay payment for the order.
-
-### cancel
-
-**Signature:** `cancel(basket : Basket) : ApplePayHookResult`
-
-Called after the Apple Pay payment sheet was canceled.
-
-### createOrder
-
-**Signature:** `createOrder(basket : Basket, event : Object) : Order`
-
-Called after handling the given ApplePayPaymentAuthorizedEvent for the given basket.
-
-### failOrder
-
-**Signature:** `failOrder(order : Order, status : Status) : ApplePayHookResult`
-
-Called after payment authorization is unsuccessful and the given Apple Pay order must be failed.
-
-### getRequest
-
-**Signature:** `getRequest(basket : Basket, request : Object) : ApplePayHookResult`
-
-Called to get the Apple Pay JS PaymentRequest for the given basket.
-
-### paymentMethodSelected
-
-**Signature:** `paymentMethodSelected(basket : Basket, event : Object, response : Object) : ApplePayHookResult`
-
-Called after handling the given ApplePayPaymentMethodSelectedEvent for the given basket.
-
-### placeOrder
-
-**Signature:** `placeOrder(order : Order) : ApplePayHookResult`
-
-Called after payment has been authorized and the given Apple Pay order is ready to be placed.
-
-### prepareBasket
-
-**Signature:** `prepareBasket(basket : Basket, parameters : Object) : ApplePayHookResult`
-
-Called to prepare the given basket for an Apple Pay checkout.
-
-### shippingContactSelected
-
-**Signature:** `shippingContactSelected(basket : Basket, event : Object, response : Object) : ApplePayHookResult`
-
-Called after handling the given ApplePayShippingContactSelectedEvent for the given basket.
-
-### shippingMethodSelected
-
-**Signature:** `shippingMethodSelected(basket : Basket, shippingMethod : ShippingMethod, event : Object, response : Object) : ApplePayHookResult`
-
-Called after handling the given ApplePayShippingMethodSelectedEvent for the given basket.
-
-## Method Detail
-
-## Method Details
-
-### authorizeOrderPayment
-
-**Signature:** `authorizeOrderPayment(order : Order, event : Object) : Status`
-
-**Description:** Called to authorize the Apple Pay payment for the order. The given order will have been created by the extensionPointPaymentAuthorizedCreateOrder hook, after the basket was populated with data from the ApplePayPaymentAuthorizedEvent. Return a non-error status if you have successfully authorized the payment with your payment service provider. Your hook implementation must set the necessary payment status and transaction identifier data on the order as returned by the provider. Return an error status to indicate a problem, including unsuccessful authorization. See ApplePayHookResult for how to indicate error statuses with detail information to be provided to Apple Pay. See the Apple Pay JS API Reference for more information.
-
-**Parameters:**
-
-- `order`: the order paid using Apple Pay
-- `event`: ApplePayPaymentAuthorizedEvent object
-
-**Returns:**
-
-a non-null status ends the hook execution
-
----
-
-### cancel
-
-**Signature:** `cancel(basket : Basket) : ApplePayHookResult`
-
-**Description:** Called after the Apple Pay payment sheet was canceled. There is no Apple Pay JS event object for this case. The given basket is the one that was passed to other hooks earlier in the Apple Pay checkout process. It is not guaranteed that this hook will be executed for all Apple Pay payment sheets canceled by shoppers or otherwise ended without a successful order. Calls to this hook are provided on a best-effort basis. If the returned result includes a redirect URL, the shopper browser will be navigated to that URL if possible. It is not guaranteed that the response with the hook result will be handled in the shopper browser in all cases.
-
-**Parameters:**
-
-- `basket`: the basket that was being checked out using Apple Pay
-
-**Returns:**
-
-a non-null result ends the hook execution
-
----
-
-### createOrder
-
-**Signature:** `createOrder(basket : Basket, event : Object) : Order`
-
-**Description:** Called after handling the given ApplePayPaymentAuthorizedEvent for the given basket. Customer information, billing address, and/or shipping address for the default shipment will have already been updated to reflect the available contact information provided by Apple Pay based on the Apple Pay configuration for your site. Any preexisting payment instruments on the basket will have been removed, and a single DW_APPLE_PAY payment instrument added for the total amount. The purpose of this hook is to populate the created order with any necessary information from the basket or the Apple Pay event. Do not use this hook for address verification, or any other validation. Instead use the extensionPointPaymentAuthorizedAuthorizeOrderPayment hook which allows you to return an ApplePayHookResult with error status information. The default implementation of this hook simply calls OrderMgr.createOrder and returns the created order. Throw an error to indicate a problem creating the order.
-
-**Parameters:**
-
-- `basket`: the basket being checked out using Apple Pay
-- `event`: ApplePayPaymentAuthorizedEvent object
-
-**Returns:**
-
-a non-null order ends the hook execution
-
----
-
-### failOrder
-
-**Signature:** `failOrder(order : Order, status : Status) : ApplePayHookResult`
-
-**Description:** Called after payment authorization is unsuccessful and the given Apple Pay order must be failed. The purpose of this hook is to fail the order, or return a redirect URL that results in the order being failed when the shopper browser is navigated to it. The given status object is the result of calling the extensionPointPaymentAuthorizedAuthorizeOrderPayment hook. The default implementation of this hook simply calls OrderMgr.failOrder, and returns a result with the given status and no redirect URL. Return a result with an error status to indicate a problem. See ApplePayHookResult for how to indicate error statuses with detail information to be provided to Apple Pay. If the returned result includes a redirect URL, the shopper browser will be navigated to that URL if the Apple Pay payment sheet is canceled.
-
-**Parameters:**
-
-- `order`: the order created for a failed Apple Pay checkout
-- `status`: status code returned by the extensionPointPaymentAuthorizedAuthorizeOrderPayment hook
-
-**Returns:**
-
-ApplePayHookResult containing a status code to be provided to Apple Pay. A non-null result ends the hook execution
-
----
-
-### getRequest
-
-**Signature:** `getRequest(basket : Basket, request : Object) : ApplePayHookResult`
-
-**Description:** Called to get the Apple Pay JS PaymentRequest for the given basket. You can set properties in the given request object to extend or override default properties set automatically based on the Apple Pay configuration for your site. Return a result with an error status to indicate a problem. See ApplePayHookResult for how to indicate error statuses with detail information to be provided to Apple Pay. If the returned result includes a redirect URL, the shopper browser will be navigated to that URL if the Apple Pay payment sheet is canceled. See the Apple Pay JS API Reference for more information.
-
-**Parameters:**
-
-- `basket`: the basket for the Apple Pay request
-- `request`: the Apple Pay payment request object
-
-**Returns:**
-
-a non-null result ends the hook execution
-
----
-
-### paymentMethodSelected
-
-**Signature:** `paymentMethodSelected(basket : Basket, event : Object, response : Object) : ApplePayHookResult`
-
-**Description:** Called after handling the given ApplePayPaymentMethodSelectedEvent for the given basket. This Apple Pay event does not contain payment card or device information. The given response object will contain properties whose values are to be passed as parameters to the ApplePaySession.completePaymentMethodSelection event callback: total - Updated total line item object lineItems - Array of updated line item objects Return a result with an error status to indicate a problem. See ApplePayHookResult for how to indicate error statuses with detail information to be provided to Apple Pay. If the returned result includes a redirect URL, the shopper browser will be navigated to that URL if the Apple Pay payment sheet is canceled. See the Apple Pay JS API Reference for more information.
-
-**Parameters:**
-
-- `basket`: the basket being checked out using Apple Pay
-- `event`: ApplePayPaymentMethodSelectedEvent object
-- `response`: JS object containing Apple Pay event callback parameters
-
-**Returns:**
-
-a non-null result ends the hook execution
-
----
-
-### placeOrder
-
-**Signature:** `placeOrder(order : Order) : ApplePayHookResult`
-
-**Description:** Called after payment has been authorized and the given Apple Pay order is ready to be placed. The purpose of this hook is to place the order, or return a redirect URL that results in the order being placed when the shopper browser is navigated to it. The default implementation of this hook returns a redirect to COPlaceOrder-Submit with URL parameters order_id set to Order.getOrderNo() and order_token set to Order.getOrderToken() which corresponds to SiteGenesis-based implementations. Your hook implementation should return a result with a different redirect URL as necessary to place the order and show an order confirmation. Alternatively, your hook implementation itself can place the order and return a result with a redirect URL to an order confirmation page that does not place the order. This is inconsistent with SiteGenesis-based implementations so is not the default. Return an error status to indicate a problem. See ApplePayHookResult for how to indicate error statuses with detail information to be provided to Apple Pay. If the returned result includes a redirect URL, the shopper browser will be navigated to that URL if the Apple Pay payment sheet is canceled.
-
-**Parameters:**
-
-- `order`: the order paid using Apple Pay
-
-**Returns:**
-
-a non-null result ends the hook execution
-
----
-
-### prepareBasket
-
-**Signature:** `prepareBasket(basket : Basket, parameters : Object) : ApplePayHookResult`
-
-**Description:** Called to prepare the given basket for an Apple Pay checkout. This hook will be executed after the user clicks the Apple Pay button. The default implementation of this hook calculates the basket. A custom hook implementation that returns a non-null result must calculate the basket. The given parameters object will contain properties whose values are passed from the <isapplepay></isapplepay> tag: sku - SKU of product to checkout exclusively Return a result with an error status to indicate a problem. For this hook there is no opportunity to provide user feedback, so if any error status is returned, the Apple Pay payment sheet will be aborted. If the returned result includes a redirect URL, the shopper browser will be navigated to that URL after the Apple Pay payment sheet is aborted.
-
-**Parameters:**
-
-- `basket`: the basket for the Apple Pay request
-- `parameters`: parameters from the <isapplepay></isapplepay> tag
-
-**Returns:**
-
-a non-null result ends the hook execution
-
----
-
-### shippingContactSelected
-
-**Signature:** `shippingContactSelected(basket : Basket, event : Object, response : Object) : ApplePayHookResult`
-
-**Description:** Called after handling the given ApplePayShippingContactSelectedEvent for the given basket. Basket customer information and/or shipping address for the default shipment will have already been updated to reflect the available shipping contact information provided by Apple Pay based on the Apple Pay configuration for your site. The basket will have already been calculated before this hook is called. The given response object will contain properties whose values are to be passed as parameters to the ApplePaySession.completeShippingContactSelection event callback: shippingMethods - Array of applicable shipping method JS objects total - Updated total line item object lineItems - Array of updated line item objects Return a result with an error status to indicate a problem. See ApplePayHookResult for how to indicate error statuses with detail information to be provided to Apple Pay. If the returned result includes a redirect URL, the shopper browser will be navigated to that URL if the Apple Pay payment sheet is canceled. See the Apple Pay JS API Reference for more information.
-
-**Parameters:**
-
-- `basket`: the basket being checked out using Apple Pay
-- `event`: ApplePayShippingContactSelectedEvent object
-- `response`: JS object containing Apple Pay event callback parameters
-
-**Returns:**
-
-a non-null result ends the hook execution
-
----
-
-### shippingMethodSelected
-
-**Signature:** `shippingMethodSelected(basket : Basket, shippingMethod : ShippingMethod, event : Object, response : Object) : ApplePayHookResult`
-
-**Description:** Called after handling the given ApplePayShippingMethodSelectedEvent for the given basket. The given shipping method will have already been set on the basket. The basket will have already been calculated before this hook is called. The given response object will contain properties whose values are to be passed as parameters to the ApplePaySession.completeShippingMethodSelection event callback: total - Updated total line item object lineItems - Array of updated line item objects Return a result with an error status to indicate a problem. See ApplePayHookResult for how to indicate error statuses with detail information to be provided to Apple Pay. If the returned result includes a redirect URL, the shopper browser will be navigated to that URL if the Apple Pay payment sheet is canceled. See the Apple Pay JS API Reference for more information.
-
-**Parameters:**
-
-- `basket`: the basket being checked out using Apple Pay
-- `shippingMethod`: the shipping method that was selected
-- `event`: ApplePayShippingMethodSelectedEvent object
-- `response`: JS object containing Apple Pay event callback parameters
-
-**Returns:**
-
-a non-null result ends the hook execution
-
----

package/docs/dw_extensions.facebook/FacebookFeedHooks.md

@@ -1,47 +0,0 @@
-## Package: dw.extensions.facebook
-
-# Class FacebookFeedHooks
-
-## Inheritance Hierarchy
-
-- dw.extensions.facebook.FacebookFeedHooks
-
-## Description
-
-FacebookFeedHooks interface containing extension points for customizing Facebook export feeds. These hooks are not executed in a transaction. The extension points (hook names), and the functions that are called by each extension point. A function must be defined inside a JavaScript source and must be exported. The script with the exported hook function must be located inside a site cartridge. Inside the site cartridge a 'package.json' file with a 'hooks' entry must exist. "hooks": "./hooks.json" The hooks entry links to a json file, relative to the 'package.json' file. This file lists all registered hooks inside the hooks property: "hooks": [ {"name": "dw.extensions.facebook.feed.transformProduct", "script": "./hooks.ds"} ] A hook entry has a 'name' and a 'script' property. The 'name' contains the extension point, the hook name. The 'script' contains the script relative to the hooks file, with the exported hook function.
-
-## Constants
-
-## Properties
-
-## Constructor Summary
-
-## Method Summary
-
-### transformProduct
-
-**Signature:** `transformProduct(product : Product, facebookProduct : FacebookProduct, feedId : String) : Status`
-
-Called after default transformation of given Demandware product to Facebook product as part of the catalog feed export.
-
-## Method Detail
-
-## Method Details
-
-### transformProduct
-
-**Signature:** `transformProduct(product : Product, facebookProduct : FacebookProduct, feedId : String) : Status`
-
-**Description:** Called after default transformation of given Demandware product to Facebook product as part of the catalog feed export. To customize multiple feeds differently, for example if one is for Facebook Dynamic Ads and the other is for Instagram Commerce, use the feedId parameter to determine which feed is being exported. If the same customization should apply to all feeds, ignore the parameter.
-
-**Parameters:**
-
-- `product`: the Demandware product
-- `facebookProduct`: the Facebook representation of the product
-- `feedId`: the merchant-selected ID for the feed being exported
-
-**Returns:**
-
-a non-null Status ends the hook execution
-
----