@paydock/client-sdk 1.142.0 → 1.144.0-beta

package/README.md

@@ -4429,6 +4429,20 @@ A full description of the meta parameters for [PaypalWalletButtonExpress](#Paypa
 </dd>
 </dl>
 
+## Functions
+
+<dl>
+<dt><a href="#enable">enable()</a></dt>
+<dd><p>Enables the wallet button, restoring interactivity and visual appearance.
+Available on both ApplePayWalletButtonExpress and PaypalWalletButtonExpress.</p>
+</dd>
+<dt><a href="#disable">disable()</a></dt>
+<dd><p>Disables the wallet button, preventing clicks and applying a visual disabled state.
+When disabled, the button appears grayed out and does not respond to user interaction.
+Available on both ApplePayWalletButtonExpress and PaypalWalletButtonExpress.</p>
+</dd>
+</dl>
+
 ## Typedefs
 
 <dl>
@@ -4797,6 +4811,8 @@ Class ApplePayWalletButtonExpress to work with Apple Pay Wallet.
     * [.load()](#ApplePayWalletButtonExpress+load)
     * [.setMeta(meta)](#ApplePayWalletButtonExpress+setMeta)
     * [.setEnv(env, [alias])](#BaseWalletButton+setEnv)
+    * [.enable()](#BaseWalletButton+enable)
+    * [.disable()](#BaseWalletButton+disable)
     * [.onClick(handler)](#BaseWalletButton+onClick)
     * [.onPaymentSuccessful([handler])](#BaseWalletButton+onPaymentSuccessful)
     * [.onPaymentInReview([handler])](#BaseWalletButton+onPaymentInReview)
@@ -4869,6 +4885,28 @@ Bear in mind that you must set an environment before calling `button.load()`.
 ```js
 button.setEnv('production', 'paydock.com');
 ```
+<a name="BaseWalletButton+enable" id="BaseWalletButton+enable" href="#BaseWalletButton+enable">&nbsp;</a>
+
+### applePayWalletButtonExpress.enable()
+Enables the wallet button, restoring interactivity and visual appearance.
+
+**Kind**: instance method of [<code>ApplePayWalletButtonExpress</code>](#ApplePayWalletButtonExpress)  
+**Overrides**: [<code>enable</code>](#BaseWalletButton+enable)  
+**Example**  
+```js
+button.enable();
+```
+<a name="BaseWalletButton+disable" id="BaseWalletButton+disable" href="#BaseWalletButton+disable">&nbsp;</a>
+
+### applePayWalletButtonExpress.disable()
+Disables the wallet button, preventing clicks and applying a visual disabled state.
+
+**Kind**: instance method of [<code>ApplePayWalletButtonExpress</code>](#ApplePayWalletButtonExpress)  
+**Overrides**: [<code>disable</code>](#BaseWalletButton+disable)  
+**Example**  
+```js
+button.disable();
+```
 <a name="BaseWalletButton+onClick" id="BaseWalletButton+onClick" href="#BaseWalletButton+onClick">&nbsp;</a>
 
 ### applePayWalletButtonExpress.onClick(handler)
@@ -5076,6 +5114,8 @@ Class PaypalWalletButtonExpress to work with Paypal Wallet.
     * [.load()](#PaypalWalletButtonExpress+load)
     * [.setMeta(meta)](#PaypalWalletButtonExpress+setMeta)
     * [.setEnv(env, [alias])](#BaseWalletButton+setEnv)
+    * [.enable()](#BaseWalletButton+enable)
+    * [.disable()](#BaseWalletButton+disable)
     * [.onClick(handler)](#BaseWalletButton+onClick)
     * [.onPaymentSuccessful([handler])](#BaseWalletButton+onPaymentSuccessful)
     * [.onPaymentInReview([handler])](#BaseWalletButton+onPaymentInReview)
@@ -5148,6 +5188,28 @@ Bear in mind that you must set an environment before calling `button.load()`.
 ```js
 button.setEnv('production', 'paydock.com');
 ```
+<a name="BaseWalletButton+enable" id="BaseWalletButton+enable" href="#BaseWalletButton+enable">&nbsp;</a>
+
+### paypalWalletButtonExpress.enable()
+Enables the wallet button, restoring interactivity and visual appearance.
+
+**Kind**: instance method of [<code>PaypalWalletButtonExpress</code>](#PaypalWalletButtonExpress)  
+**Overrides**: [<code>enable</code>](#BaseWalletButton+enable)  
+**Example**  
+```js
+button.enable();
+```
+<a name="BaseWalletButton+disable" id="BaseWalletButton+disable" href="#BaseWalletButton+disable">&nbsp;</a>
+
+### paypalWalletButtonExpress.disable()
+Disables the wallet button, preventing clicks and applying a visual disabled state.
+
+**Kind**: instance method of [<code>PaypalWalletButtonExpress</code>](#PaypalWalletButtonExpress)  
+**Overrides**: [<code>disable</code>](#BaseWalletButton+disable)  
+**Example**  
+```js
+button.disable();
+```
 <a name="BaseWalletButton+onClick" id="BaseWalletButton+onClick" href="#BaseWalletButton+onClick">&nbsp;</a>
 
 ### paypalWalletButtonExpress.onClick(handler)
@@ -5381,6 +5443,29 @@ List of available contact fields for ContactFieldType
 | address_country | <code>string</code> | 
 | address_country_code | <code>string</code> | 
 
+<a name="enable" id="enable" href="#enable">&nbsp;</a>
+
+## enable()
+Enables the wallet button, restoring interactivity and visual appearance.
+Available on both ApplePayWalletButtonExpress and PaypalWalletButtonExpress.
+
+**Kind**: global function  
+**Example**  
+```js
+button.enable();
+```
+<a name="disable" id="disable" href="#disable">&nbsp;</a>
+
+## disable()
+Disables the wallet button, preventing clicks and applying a visual disabled state.
+When disabled, the button appears grayed out and does not respond to user interaction.
+Available on both ApplePayWalletButtonExpress and PaypalWalletButtonExpress.
+
+**Kind**: global function  
+**Example**  
+```js
+button.disable();
+```
 <a name="OnClickCallback" id="OnClickCallback" href="#OnClickCallback">&nbsp;</a>
 
 ## OnClickCallback ⇒ <code>Promise.&lt;string&gt;</code>
@@ -6421,6 +6506,24 @@ Used in the <code>context.operation</code> field of <a href="#OnErrorEventData">
 </dd>
 </dl>
 
+## Functions
+
+<dl>
+<dt><a href="#enable">enable()</a></dt>
+<dd><p>Enables the wallet button, restoring interactivity and visual appearance.
+Available on both ApplePayOpenWalletButton and GooglePayOpenWalletButton.</p>
+<p>Idempotent — calling on an already-enabled button has no effect.</p>
+</dd>
+<dt><a href="#disable">disable()</a></dt>
+<dd><p>Disables the wallet button, preventing clicks and applying a visual disabled state.
+When disabled, the button appears grayed out and does not respond to user interaction.
+Available on both ApplePayOpenWalletButton and GooglePayOpenWalletButton.</p>
+<p>Idempotent — calling on an already-disabled button has no effect.
+Safe to call before <code>load()</code> (no-throw); the disabled styles are applied
+once the container element exists.</p>
+</dd>
+</dl>
+
 ## Typedefs
 
 <dl>
@@ -6846,6 +6949,8 @@ if the service type does not match Apple Pay.
 * [ApplePayOpenWalletButton](#ApplePayOpenWalletButton) ⇐ [<code>OpenWalletButtons</code>](#OpenWalletButtons)
     * [new ApplePayOpenWalletButton(selector, publicKeyOrAccessToken, serviceId, meta)](#new_ApplePayOpenWalletButton_new)
     * [.load()](#OpenWalletButtons+load)
+    * [.enable()](#OpenWalletButtons+enable)
+    * [.disable()](#OpenWalletButtons+disable)
     * [.setEnv(env, [alias])](#OpenWalletButtons+setEnv)
     * [.setMeta(meta)](#OpenWalletButtons+setMeta)
     * [.destroy()](#OpenWalletButtons+destroy)
@@ -6905,6 +7010,41 @@ button.onSuccess((data) => { ... });
 button.onError((error) => { ... });
 button.load();
 ```
+<a name="OpenWalletButtons+enable" id="OpenWalletButtons+enable" href="#OpenWalletButtons+enable">&nbsp;</a>
+
+### applePayOpenWalletButton.enable()
+Enables the wallet button, restoring interactivity and visual appearance.
+If the button was previously disabled via `disable()`, calling this method
+re-enables clicks and removes the disabled visual state.
+
+Idempotent — calling on an already-enabled button has no effect.
+
+**Kind**: instance method of [<code>ApplePayOpenWalletButton</code>](#ApplePayOpenWalletButton)  
+**Example**  
+```js
+button.enable();
+```
+<a name="OpenWalletButtons+disable" id="OpenWalletButtons+disable" href="#OpenWalletButtons+disable">&nbsp;</a>
+
+### applePayOpenWalletButton.disable()
+Disables the wallet button, preventing clicks and applying a visual disabled state.
+When disabled, the button appears grayed out (`opacity: 0.5`) and does not
+respond to user interaction (`pointer-events: none`). For accessibility, the
+`aria-disabled="true"` attribute is also set on the container.
+
+Programmatic clicks (e.g. invoked by the wallet provider's SDK) are blocked
+by an explicit guard inside the click handler — the button's wallet service
+checks the disabled state before processing.
+
+Idempotent — calling on an already-disabled button has no effect.
+Safe to call before `load()` (no-throw); the styles are applied once the
+container element exists.
+
+**Kind**: instance method of [<code>ApplePayOpenWalletButton</code>](#ApplePayOpenWalletButton)  
+**Example**  
+```js
+button.disable();
+```
 <a name="OpenWalletButtons+setEnv" id="OpenWalletButtons+setEnv" href="#OpenWalletButtons+setEnv">&nbsp;</a>
 
 ### applePayOpenWalletButton.setEnv(env, [alias])
@@ -7210,6 +7350,8 @@ if the service type does not match Google Pay.
 * [GooglePayOpenWalletButton](#GooglePayOpenWalletButton) ⇐ [<code>OpenWalletButtons</code>](#OpenWalletButtons)
     * [new GooglePayOpenWalletButton(selector, publicKeyOrAccessToken, serviceId, meta)](#new_GooglePayOpenWalletButton_new)
     * [.load()](#OpenWalletButtons+load)
+    * [.enable()](#OpenWalletButtons+enable)
+    * [.disable()](#OpenWalletButtons+disable)
     * [.setEnv(env, [alias])](#OpenWalletButtons+setEnv)
     * [.setMeta(meta)](#OpenWalletButtons+setMeta)
     * [.destroy()](#OpenWalletButtons+destroy)
@@ -7267,6 +7409,41 @@ button.onSuccess((data) => { ... });
 button.onError((error) => { ... });
 button.load();
 ```
+<a name="OpenWalletButtons+enable" id="OpenWalletButtons+enable" href="#OpenWalletButtons+enable">&nbsp;</a>
+
+### googlePayOpenWalletButton.enable()
+Enables the wallet button, restoring interactivity and visual appearance.
+If the button was previously disabled via `disable()`, calling this method
+re-enables clicks and removes the disabled visual state.
+
+Idempotent — calling on an already-enabled button has no effect.
+
+**Kind**: instance method of [<code>GooglePayOpenWalletButton</code>](#GooglePayOpenWalletButton)  
+**Example**  
+```js
+button.enable();
+```
+<a name="OpenWalletButtons+disable" id="OpenWalletButtons+disable" href="#OpenWalletButtons+disable">&nbsp;</a>
+
+### googlePayOpenWalletButton.disable()
+Disables the wallet button, preventing clicks and applying a visual disabled state.
+When disabled, the button appears grayed out (`opacity: 0.5`) and does not
+respond to user interaction (`pointer-events: none`). For accessibility, the
+`aria-disabled="true"` attribute is also set on the container.
+
+Programmatic clicks (e.g. invoked by the wallet provider's SDK) are blocked
+by an explicit guard inside the click handler — the button's wallet service
+checks the disabled state before processing.
+
+Idempotent — calling on an already-disabled button has no effect.
+Safe to call before `load()` (no-throw); the styles are applied once the
+container element exists.
+
+**Kind**: instance method of [<code>GooglePayOpenWalletButton</code>](#GooglePayOpenWalletButton)  
+**Example**  
+```js
+button.disable();
+```
 <a name="OpenWalletButtons+setEnv" id="OpenWalletButtons+setEnv" href="#OpenWalletButtons+setEnv">&nbsp;</a>
 
 ### googlePayOpenWalletButton.setEnv(env, [alias])
@@ -7572,6 +7749,8 @@ These subclasses inherit all event handlers and lifecycle methods documented bel
 
 * *[OpenWalletButtons](#OpenWalletButtons)*
     * *[.load()](#OpenWalletButtons+load)*
+    * *[.enable()](#OpenWalletButtons+enable)*
+    * *[.disable()](#OpenWalletButtons+disable)*
     * *[.setEnv(env, [alias])](#OpenWalletButtons+setEnv)*
     * *[.setMeta(meta)](#OpenWalletButtons+setMeta)*
     * *[.destroy()](#OpenWalletButtons+destroy)*
@@ -7600,6 +7779,41 @@ button.onSuccess((data) => { ... });
 button.onError((error) => { ... });
 button.load();
 ```
+<a name="OpenWalletButtons+enable" id="OpenWalletButtons+enable" href="#OpenWalletButtons+enable">&nbsp;</a>
+
+### *openWalletButtons.enable()*
+Enables the wallet button, restoring interactivity and visual appearance.
+If the button was previously disabled via `disable()`, calling this method
+re-enables clicks and removes the disabled visual state.
+
+Idempotent — calling on an already-enabled button has no effect.
+
+**Kind**: instance method of [<code>OpenWalletButtons</code>](#OpenWalletButtons)  
+**Example**  
+```js
+button.enable();
+```
+<a name="OpenWalletButtons+disable" id="OpenWalletButtons+disable" href="#OpenWalletButtons+disable">&nbsp;</a>
+
+### *openWalletButtons.disable()*
+Disables the wallet button, preventing clicks and applying a visual disabled state.
+When disabled, the button appears grayed out (`opacity: 0.5`) and does not
+respond to user interaction (`pointer-events: none`). For accessibility, the
+`aria-disabled="true"` attribute is also set on the container.
+
+Programmatic clicks (e.g. invoked by the wallet provider's SDK) are blocked
+by an explicit guard inside the click handler — the button's wallet service
+checks the disabled state before processing.
+
+Idempotent — calling on an already-disabled button has no effect.
+Safe to call before `load()` (no-throw); the styles are applied once the
+container element exists.
+
+**Kind**: instance method of [<code>OpenWalletButtons</code>](#OpenWalletButtons)  
+**Example**  
+```js
+button.disable();
+```
 <a name="OpenWalletButtons+setEnv" id="OpenWalletButtons+setEnv" href="#OpenWalletButtons+setEnv">&nbsp;</a>
 
 ### *openWalletButtons.setEnv(env, [alias])*
@@ -7946,6 +8160,35 @@ Used in the `context.operation` field of [OnErrorEventData](#OnErrorEventData).
 | HANDLER_REGISTRATION | <code>string</code> | <code>&quot;handler_registration&quot;</code> | A required event handler was not registered before calling load(). |
 | SHIPPING_UPDATE | <code>string</code> | <code>&quot;shipping_update&quot;</code> | Processing a shipping address or shipping option update failed. |
 
+<a name="enable" id="enable" href="#enable">&nbsp;</a>
+
+## enable()
+Enables the wallet button, restoring interactivity and visual appearance.
+Available on both ApplePayOpenWalletButton and GooglePayOpenWalletButton.
+
+Idempotent — calling on an already-enabled button has no effect.
+
+**Kind**: global function  
+**Example**  
+```js
+button.enable();
+```
+<a name="disable" id="disable" href="#disable">&nbsp;</a>
+
+## disable()
+Disables the wallet button, preventing clicks and applying a visual disabled state.
+When disabled, the button appears grayed out and does not respond to user interaction.
+Available on both ApplePayOpenWalletButton and GooglePayOpenWalletButton.
+
+Idempotent — calling on an already-disabled button has no effect.
+Safe to call before `load()` (no-throw); the disabled styles are applied
+once the container element exists.
+
+**Kind**: global function  
+**Example**  
+```js
+button.disable();
+```
 <a name="OnClickCallback" id="OnClickCallback" href="#OnClickCallback">&nbsp;</a>
 
 ## OnClickCallback ⇒ <code>boolean</code> \| <code>void</code> \| <code>Promise.&lt;(boolean\|void)&gt;</code>