@paydock/client-sdk 1.142.0 → 1.144.0-beta

package/docs/api-canvas3ds.md

@@ -28,7 +28,7 @@ Class Canvas3ds include method for working on html
     * [new Canvas3ds(selector, token)](#new_Canvas3ds_new)
     * [.load()](#Canvas3ds+load)
     * [.setEnv(env, [alias])](#Canvas3ds+setEnv)
-    * [.on(eventName, [cb])](#Canvas3ds+on) ⇒ <code>Promise.&lt;IEventData&gt;</code> \| <code>void</code>
+    * [.on(eventName, cb)](#Canvas3ds+on) ⇒
     * [.hide([saveSize])](#Canvas3ds+hide)
     * [.show()](#Canvas3ds+show)
     * [.reload()](#Canvas3ds+reload)
@@ -71,24 +71,31 @@ widget.setEnv('production');
 ```
 <a name="Canvas3ds+on" id="Canvas3ds+on" href="#Canvas3ds+on">&nbsp;</a>
 
-### canvas3ds.on(eventName, [cb]) ⇒ <code>Promise.&lt;IEventData&gt;</code> \| <code>void</code>
-Listen to events of widget
+### canvas3ds.on(eventName, cb) ⇒
+Listen to events of widget.
+
+Available event names are defined in [Canvas3dsEventMap](Canvas3dsEventMap) (typed) and
+[CANVAS_3DS_EVENT](CANVAS_3DS_EVENT) (string constants). Using a literal event name
+narrows the callback payload via the typed overloads.
 
 **Kind**: instance method of [<code>Canvas3ds</code>](#Canvas3ds)  
+**Returns**: `void` when a callback is provided; otherwise a Promise that resolves with the event payload.  
 
-| Param | Type | Description |
-| --- | --- | --- |
-| eventName | <code>string</code> | Available event names [EVENT](#EVENT) [STANDALONE_3DS_EVENT](#STANDALONE_3DS_EVENT) |
-| [cb] | <code>listener</code> |  |
+| Param | Description |
+| --- | --- |
+| eventName | Event name from [Canvas3dsEventMap](Canvas3dsEventMap) or any string for dynamic events. |
+| cb | Optional listener callback. If omitted, returns a Promise that resolves on the next emission. |
 
 **Example**  
 ```js
-widget.on('chargeAuthReject', function (data) {
-     console.log(data);
+// Callback form — payload is narrowed by the event name
+widget.on('chargeAuthReject', (data) => {
+  console.log(data); // data is Canvas3dsAuthPayload | Canvas3dsChargeAuthEventPayload
 });
-// or
-widget.on('chargeAuthReject').then(function (data) {
-     console.log(data);
+
+// Promise form
+widget.on('chargeAuthReject').then((data) => {
+  console.log(data);
 });
 ```
 <a name="Canvas3ds+hide" id="Canvas3ds+hide" href="#Canvas3ds+hide">&nbsp;</a>

package/docs/open-wallet-buttons.md

@@ -45,6 +45,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>
@@ -470,6 +488,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)
@@ -529,6 +549,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])
@@ -834,6 +889,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)
@@ -891,6 +948,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])
@@ -1196,6 +1288,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)*
@@ -1224,6 +1318,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])*
@@ -1570,6 +1699,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>

package/docs/wallet-buttons-express.md

@@ -20,6 +20,20 @@
 </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>
@@ -388,6 +402,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)
@@ -460,6 +476,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)
@@ -667,6 +705,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)
@@ -739,6 +779,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)
@@ -972,6 +1034,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>

package/package.json

@@ -104,7 +104,7 @@
     }
   },
   "name": "@paydock/client-sdk",
-  "version": "1.142.0",
+  "version": "1.144.0-beta",
   "scripts": {
     "build:doc": "node docs/html/marked.js",
     "build:js": "rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
@@ -230,12 +230,15 @@
     "ajv": "8.18.0",
     "serialize-javascript": ">=7.0.3",
     "underscore": ">=1.13.8",
-    "dompurify": ">=3.3.2",
+    "dompurify": ">=3.4.0",
     "immutable": ">=5.1.5",
     "flatted": ">=3.4.2",
     "node-forge": ">=1.4.0",
     "picomatch": ">=2.3.2",
-    "socket.io-parser": ">=4.2.6"
+    "socket.io-parser": ">=4.2.6",
+    "lodash": ">=4.18.0",
+    "vite": ">=6.4.2",
+    "follow-redirects": ">=1.16.0"
   },
   "engines": {
     "node": ">=16.0.0"