@sheerid/jslib 1.109.0 → 1.112.0

package/README.md

@@ -104,3 +104,60 @@ You will want to provide localized messaging for your field, which can be done w
 **Note:** placeholder and label message keys are automatically formulated based on the fieldId: `${fieldId}Placeholder` and `${fieldId}Label`
 
 See it in action: https://jsfiddle.net/AaronSheerID/n91p2sya/
+
+Custom form fields of type `checkbox` are available as well. They do not use placeholder or required values. You can construct a validation callback to enforce that they are true or false, and display any error message accordingly.
+
+## Hooks
+
+Hooks are a convenient way to run your own javascript function(s) when the core jslib does certain things. They are helpful because you don't need to know a lot about the system to do certain things at certain times.
+
+To add a hook, call addHook with the HookName and a callback. The callback will be passed relevant parameter(s) that you may or may not choose to utilize.
+
+```javascript
+sheerId.addHook({
+  name: "ON_VERIFICATION_SUCCESS",
+  callback: function (verificationResponse) {
+    window.location = "new.html";
+  },
+});
+```
+
+At the time of writing, there are 3 hooks you can use:
+
+`ON_VERIFICATION_READY`
+
+When the page loads, several api requests take place. Once they've all returned, and the library has initialized, ON_VERIFICATION_READY is called. After calling this hook once, your callbacks are removed/reset to ensure this happens only once per page-load (UX-346)
+
+Your callback is given the `VerificationResponse` object
+
+`ON_VERIFICATION_SUCCESS`
+
+Called right after the API responds with the success step, but before the viewModel is updated in response to that API response.
+
+Your callback is given the `VerificationResponse` object
+
+`ON_VERIFICATION_STEP_CHANGE`
+
+Called any time the current viewModel's step is different from the API response (just received)'s step. In other words, when the library determines we're about to display a different step.
+Your callback is given the `VerificationResponse` object
+
+See it in action [here](https://jsfiddle.net/AaronSheerID/adnj61ke/)
+
+## Extra Messages
+
+In addition to overriding any message, you can add extra text to a specific region on the form. Normally no text is shown in these spots. To add text, just define it using `setOptions()` along with the appropriate message key:
+
+```
+sheerId.setOptions({
+    messagesWithLocale: {
+        "en-US": {
+          extraMessageCollectAboveSubmit: 'Lorem ipsum...',
+        },
+        es: {
+          extraMessageCollectAboveSubmit: 'Lorem ipsum... (es)',
+        },
+    },
+});
+```
+
+At this time only `extraMessageCollectAboveSubmit` is available. This message with show right above the Submit button on the collect step for any Segment.

package/es5/Tmetrix.bundle.js

@@ -1,10 +1,10 @@
 /*!
  * 
- *     VERSION: 1.109.0
- *     BUILD_TIMESTAMP: 1659985090713
- *     BUILD_DATE: Mon Aug 08 2022 18:58:10 GMT+0000 (Coordinated Universal Time)
- *     BUILD_COMMIT: ad2320d3b2f9cbe444c1e33fcb9bd5455909a348
+ *     VERSION: 1.112.0
+ *     BUILD_TIMESTAMP: 1661357918059
+ *     BUILD_DATE: Wed Aug 24 2022 16:18:38 GMT+0000 (Coordinated Universal Time)
+ *     BUILD_COMMIT: eb32bc3fe23c3932f023918e36180d7f9e8b6337
  * 
  */
-window.sheerIdCurrentScript=document.currentScript,window.sheerIdEs5="true",window.sheerIdPubV="1.109.0",(window.webpackJsonpsheerid=window.webpackJsonpsheerid||[]).push([[0],{516:function(e,t,n){"use strict";n.r(t),n.d(t,"ThreatMetrix",(function(){return r}));const r=(()=>{let e=window.hp_frame||null,t=window.tmx_frame||null,n=window.tmx_script||null;var r=r||{};return r.version=3,r.create_url=function(e,t,n,c,o){function i(){return Math.floor(2742745743359*Math.random())}function u(){return a(i())}function a(e){return(e+78364164096).toString(36)}var s=i(),l=i(),d=885187064159;l=((l=l-l%256+r.version)+s)%2742745743359,d=(d+s)%2742745743359;var p="https://"+e+"/"+(s=u()+a(s))+t,m=[(l=a(d)+a(l))+"="+n,u()+u()+"="+c];return void 0!==o&&o.length>0&&m.push(u()+u()+"="+o),p+"?"+m.join("&")},r.beacon=function(e,t,n,r){var c="turn:aa.online-metrix.net?transport=",o="1:"+t+":"+n,i={iceServers:[{urls:c+"tcp",username:o,credential:n},{urls:c+"udp",username:o,credential:n}]};try{var u=new RTCPeerConnection(i);u.createDataChannel(Math.random().toString());var a=function(){},s=function(e){u.setLocalDescription(e,a,a)};"undefined"==typeof Promise||u.createOffer.length>0?u.createOffer(s,a):u.createOffer().then(s,a)}catch(e){}},r.load_tags=function(e,t,n,c){r.beacon(e,t,n,c);var o=document.getElementsByTagName("head").item(0),i=document.createElement("script");i.id="tmx_tags_js",i.setAttribute("type","text/javascript");var u=r.create_url(e,".js",t,n,c);i.setAttribute("src",u),r.set_csp_nonce(i),o.appendChild(i)},r.load_iframe_tags=function(e,t,n,c){r.beacon(e,t,n,c);var o=r.create_url(e,".htm",t,n,c),i=document.createElement("iframe");i.title="empty",i.setAttribute("aria-disabled","true"),i.width="0",i.height="0",i.setAttribute("style","color:rgba(0,0,0,0); float:left; position:absolute; top:-200; left:-200; border:0px"),i.setAttribute("src",o),document.body.appendChild(i)},r.csp_nonce=null,r.register_csp_nonce=function(e){if(void 0!==e.currentScript&&null!==e.currentScript){var t=e.currentScript.getAttribute("nonce");null!=t&&""!==t?r.csp_nonce=t:void 0!==e.currentScript.nonce&&null!==e.currentScript.nonce&&""!==e.currentScript.nonce&&(r.csp_nonce=e.currentScript.nonce)}},r.set_csp_nonce=function(e){null!==r.csp_nonce&&(e.setAttribute("nonce",r.csp_nonce),e.getAttribute("nonce")!==r.csp_nonce&&(e.nonce=r.csp_nonce))},r.cleanup=function(){for(;null!==(e=document.getElementById("tdz_ifrm"));)e.parentElement.removeChild(e);for(;null!==(t=document.getElementById("tmx_tags_iframe"));)t.parentElement.removeChild(t);for(;null!==(n=document.getElementById("tmx_tags_js"));)n.parentElement.removeChild(n)},r.profile=function(e,t,n,c){r.cleanup(),r.register_csp_nonce(document),r.load_tags(e,t,n,c)},r.profile_iframe=function(e,t,n,c){r.cleanup(),r.register_csp_nonce(document),r.load_iframe_tags(e,t,n,c)},r})()}}]);
+window.sheerIdCurrentScript=document.currentScript,window.sheerIdEs5="true",window.sheerIdPubV="1.112.0",(window.webpackJsonpsheerid=window.webpackJsonpsheerid||[]).push([[0],{516:function(e,t,n){"use strict";n.r(t),n.d(t,"ThreatMetrix",(function(){return r}));const r=(()=>{let e=window.hp_frame||null,t=window.tmx_frame||null,n=window.tmx_script||null;var r=r||{};return r.version=3,r.create_url=function(e,t,n,c,o){function i(){return Math.floor(2742745743359*Math.random())}function u(){return a(i())}function a(e){return(e+78364164096).toString(36)}var s=i(),l=i(),d=885187064159;l=((l=l-l%256+r.version)+s)%2742745743359,d=(d+s)%2742745743359;var p="https://"+e+"/"+(s=u()+a(s))+t,m=[(l=a(d)+a(l))+"="+n,u()+u()+"="+c];return void 0!==o&&o.length>0&&m.push(u()+u()+"="+o),p+"?"+m.join("&")},r.beacon=function(e,t,n,r){var c="turn:aa.online-metrix.net?transport=",o="1:"+t+":"+n,i={iceServers:[{urls:c+"tcp",username:o,credential:n},{urls:c+"udp",username:o,credential:n}]};try{var u=new RTCPeerConnection(i);u.createDataChannel(Math.random().toString());var a=function(){},s=function(e){u.setLocalDescription(e,a,a)};"undefined"==typeof Promise||u.createOffer.length>0?u.createOffer(s,a):u.createOffer().then(s,a)}catch(e){}},r.load_tags=function(e,t,n,c){r.beacon(e,t,n,c);var o=document.getElementsByTagName("head").item(0),i=document.createElement("script");i.id="tmx_tags_js",i.setAttribute("type","text/javascript");var u=r.create_url(e,".js",t,n,c);i.setAttribute("src",u),r.set_csp_nonce(i),o.appendChild(i)},r.load_iframe_tags=function(e,t,n,c){r.beacon(e,t,n,c);var o=r.create_url(e,".htm",t,n,c),i=document.createElement("iframe");i.title="empty",i.setAttribute("aria-disabled","true"),i.width="0",i.height="0",i.setAttribute("style","color:rgba(0,0,0,0); float:left; position:absolute; top:-200; left:-200; border:0px"),i.setAttribute("src",o),document.body.appendChild(i)},r.csp_nonce=null,r.register_csp_nonce=function(e){if(void 0!==e.currentScript&&null!==e.currentScript){var t=e.currentScript.getAttribute("nonce");null!=t&&""!==t?r.csp_nonce=t:void 0!==e.currentScript.nonce&&null!==e.currentScript.nonce&&""!==e.currentScript.nonce&&(r.csp_nonce=e.currentScript.nonce)}},r.set_csp_nonce=function(e){null!==r.csp_nonce&&(e.setAttribute("nonce",r.csp_nonce),e.getAttribute("nonce")!==r.csp_nonce&&(e.nonce=r.csp_nonce))},r.cleanup=function(){for(;null!==(e=document.getElementById("tdz_ifrm"));)e.parentElement.removeChild(e);for(;null!==(t=document.getElementById("tmx_tags_iframe"));)t.parentElement.removeChild(t);for(;null!==(n=document.getElementById("tmx_tags_js"));)n.parentElement.removeChild(n)},r.profile=function(e,t,n,c){r.cleanup(),r.register_csp_nonce(document),r.load_tags(e,t,n,c)},r.profile_iframe=function(e,t,n,c){r.cleanup(),r.register_csp_nonce(document),r.load_iframe_tags(e,t,n,c)},r})()}}]);
 //# sourceMappingURL=Tmetrix.bundle.js.map