@paydock/client-sdk 1.147.0 → 1.148.0-beta

package/docs/api-canvas3ds.md

@@ -29,6 +29,7 @@ Class Canvas3ds include method for working on html
     * [.load()](#Canvas3ds+load)
     * [.setEnv(env, [alias])](#Canvas3ds+setEnv)
     * [.on(eventName, cb)](#Canvas3ds+on) ⇒
+    * [.authenticate()](#Canvas3ds+authenticate)
     * [.hide([saveSize])](#Canvas3ds+hide)
     * [.show()](#Canvas3ds+show)
     * [.reload()](#Canvas3ds+reload)
@@ -98,6 +99,35 @@ widget.on('chargeAuthReject').then((data) => {
   console.log(data);
 });
 ```
+<a name="Canvas3ds+authenticate" id="Canvas3ds+authenticate" href="#Canvas3ds+authenticate">&nbsp;</a>
+
+### canvas3ds.authenticate()
+Two-step mode only (`_3ds.authentication_flow: 'two_step'`): runs the authentication the API deferred after the
+fingerprint. Call it when the shopper confirms (e.g. presses "Pay"); the outcome arrives through the
+usual events (`chargeAuthChallenge`, `chargeAuthSuccess`, `chargeAuthReject`, `error`).
+
+Never throws. After `chargeAuthReady` the authentication starts at once; before it, the call is
+remembered and runs as soon as the fingerprint completes. One-step charges, repeated calls and calls after
+a terminal outcome are no-ops. For inbuilt 3DS (`html` / `url`) tokens it is a silent no-op: no event is
+emitted at all, so do not wait for `error` there. Calling it before `load()` is an integration error: it emits `error` and
+is not remembered. If `/process` could not be reached (`error` with `error_code` `service_unreachable` /
+`aborted`), `authenticate()` may be called once more; any other `error`, and any failure of that retry,
+is final.
+No client-side deadline: a stale 3DS Server session surfaces as `error` / `chargeAuthReject`.
+
+**Kind**: instance method of [<code>Canvas3ds</code>](#Canvas3ds)  
+**Example**  
+```js
+const widget = new Canvas3ds('#widget', token); // charge created with _3ds.authentication_flow: 'two_step'
+widget.on('chargeAuthReady', () => payButton.disabled = false);
+widget.on('chargeAuthChallenge', () => showChallengeModal());
+widget.on('chargeAuthSuccess', (data) => completePayment(data.charge_3ds_id));
+widget.on('chargeAuthReject', () => showDeclined());
+widget.on('error', () => showError());
+widget.load(); // fingerprint runs while the shopper reviews the order
+
+payButton.addEventListener('click', () => widget.authenticate());
+```
 <a name="Canvas3ds+hide" id="Canvas3ds+hide" href="#Canvas3ds+hide">&nbsp;</a>
 
 ### canvas3ds.hide([saveSize])
@@ -160,6 +190,7 @@ List of available event's name for Standalone 3ds flow
 | AUTH_ERROR | <code>string</code> | <code>&quot;chargeAuthReject&quot;</code> |  |
 | DECOUPLED | <code>string</code> | <code>&quot;chargeAuthDecoupled&quot;</code> |  |
 | CHALLENGE | <code>string</code> | <code>&quot;chargeAuthChallenge&quot;</code> |  |
+| READY | <code>string</code> | <code>&quot;chargeAuthReady&quot;</code> | two-step mode only: fingerprint done, waiting for `authenticate()` |
 | CHALLENGE_LOADED | <code>string</code> | <code>&quot;chargeAuthChallengeLoaded&quot;</code> | challenge iframe painted (first `load`, or 2.5 s fallback); reveal your challenge UI here |
 | CHALLENGE_COMPLETED | <code>string</code> | <code>&quot;chargeAuthChallengeCompleted&quot;</code> | the shopper finished the challenge (issuer result delivered to the 3DS Server); cover the challenge iframe with your own loader until the terminal event |
 | INFO | <code>string</code> | <code>&quot;chargeAuthInfo&quot;</code> |  |

package/package.json

@@ -104,7 +104,7 @@
     }
   },
   "name": "@paydock/client-sdk",
-  "version": "1.147.0",
+  "version": "1.148.0-beta",
   "scripts": {
     "build:doc": "node docs/html/marked.js",
     "build:js": "rollup --config rollup.config.ts --configPlugin @rollup/plugin-typescript",
@@ -213,15 +213,17 @@
     "tsify": "3.0.4",
     "tslib": "2.6.2",
     "typescript": "5.4.5",
-    "vitest": "3.2.6",
+    "vitest": "4.1.11",
     "zod": "3.23.8"
   },
   "overrides": {
     "sha.js@>=2.0.0 <=2.4.11": "2.4.12",
     "pbkdf2": ">=3.1.3",
     "form-data": ">=4.0.6",
-    "qs": ">=6.15.2",
-    "js-yaml": "4.3.1",
+    "qs": "6.16.0",
+    "js-yaml": "4.3.2",
+    "fflate@0.4": "0.4.9",
+    "fflate@0.7": "0.7.5",
     "@babel/plugin-transform-modules-systemjs": ">=7.29.4",
     "fast-uri": "3.1.7",
     "tmp": ">=0.2.6",
@@ -230,8 +232,8 @@
     "minimatch@^5": "5.1.9",
     "minimatch@^9": "9.0.9",
     "@isaacs/brace-expansion": ">=5.0.1",
-    "brace-expansion@1": "1.1.18",
-    "brace-expansion@2": "2.1.4",
+    "brace-expansion@1": "1.1.21",
+    "brace-expansion@2": "2.1.7",
     "postcss": "8.5.23",
     "bn.js": ">=5.2.3",
     "ajv": "8.18.0",
@@ -243,7 +245,7 @@
     "node-forge": ">=1.4.0",
     "picomatch": ">=2.3.2",
     "socket.io-parser": "4.2.7",
-    "engine.io": "6.6.9",
+    "engine.io": "6.6.11",
     "lodash": ">=4.18.0",
     "vite": ">=6.4.2 <7",
     "follow-redirects": ">=1.16.0",
@@ -251,7 +253,8 @@
     "esbuild": ">=0.28.1",
     "linkify-it": "5.0.2",
     "body-parser": "1.20.6",
-    "nanoid": "3.3.18"
+    "nanoid": "3.3.18",
+    "markdown-it": "14.2.0"
   },
   "engines": {
     "node": ">=16.0.0"