@roomle/embedding-lib 4.24.1-alpha.2 → 4.25.0-alpha.3

package/roomle-configurator-api.es.js

@@ -1,3 +1,5 @@
+import '@/common/styles/Global.module.scss';
+
 class MessageHandler {
     constructor(side, incomingMessageBus, outgoingMessageBus, messageExecution) {
         this._outgoingMessageBus = null;
@@ -160,6 +162,51 @@ const isInIframe = () => {
     }
 };
 
+// see why: so#/58065241/10800831
+const isAndroid = () => /(android)/i.test(navigator.userAgent);
+
+/* TO DOs in Google Analytics Admin UI
+
+ To track the Hit ID, Hit Time, and Hit Type and custom dimensions, first create them in Google Analytics
+ and set their scope to "Hit"
+
+ Once you've created the custom metrics in Google Analytics
+ (and set their scope to "Hit" and their formatting type to "Integer")
+ this setup is ready to go. You need to do this in every GA property
+
+ For more details see: https://philipwalton.com/articles/the-google-analytics-setup-i-use-on-every-site-i-build/
+
+ */
+// Probably we could add const enums here
+// but we need to investigate: https://roomle.atlassian.net/browse/CONF-238
+var GA_CUSTOM;
+(function (GA_CUSTOM) {
+    GA_CUSTOM["DIMENSION"] = "dimension";
+    GA_CUSTOM["METRIC"] = "metric";
+})(GA_CUSTOM || (GA_CUSTOM = {}));
+var GA_HIT_TYPE;
+(function (GA_HIT_TYPE) {
+    GA_HIT_TYPE["EVENT"] = "event";
+})(GA_HIT_TYPE || (GA_HIT_TYPE = {}));
+var GA_ACTION_TYPE;
+(function (GA_ACTION_TYPE) {
+    GA_ACTION_TYPE["EXCEPTION"] = "exception";
+    GA_ACTION_TYPE["TIMING"] = "timing_complete";
+})(GA_ACTION_TYPE || (GA_ACTION_TYPE = {}));
+var CUSTOM_ACTION_TYPE;
+(function (CUSTOM_ACTION_TYPE) {
+    CUSTOM_ACTION_TYPE["TRACK_TIMING"] = "track_timing";
+})(CUSTOM_ACTION_TYPE || (CUSTOM_ACTION_TYPE = {}));
+var GA_CATEGORY;
+(function (GA_CATEGORY) {
+    GA_CATEGORY["ERROR"] = "Error";
+    GA_CATEGORY["NAVIGATION_TIMING"] = "Navigation Timing";
+    GA_CATEGORY["TIMING"] = "Timing";
+    GA_CATEGORY["INTERACTION"] = "Interaction";
+    GA_CATEGORY["TRACKING"] = "Tracking";
+    GA_CATEGORY["DEPRECATION"] = "Deprecation";
+})(GA_CATEGORY || (GA_CATEGORY = {}));
+
 /**
  * Recursively merge properties of two objects.
  * If a property exists in both it, property of obj2 is used.
@@ -305,16 +352,13 @@ const getFallbackInitData = () => {
     if (hostname && isDemoHostname(hostname)) {
         fallbackInitData.configuratorId = 'demoConfigurator';
     }
-    fallbackInitData.customApiUrl = 'https://alpha.roomle.com/api/v2';
+    fallbackInitData.customApiUrl = 'https://www.roomle.com/api/v2';
     fallbackInitData.emails = false;
     return fallbackInitData;
 };
 const LEGACY_SHARE_PLACEHOLDER = '<CONF_ID>';
 const SHARE_PLACEHOLDER = '#CONFIGURATIONID#';
 
-// see why: so#/58065241/10800831
-const isAndroid = () => /(android)/i.test(navigator.userAgent);
-
 const setDefaultBehaviour = (object, callbackName, defaultBehaviour) => {
     let customBehaviour = null;
     Object.defineProperty(object, callbackName, {

package/roomle-configurator-api.es.min.js

@@ -1 +1 @@
-class t{constructor(t,e,r,s){this.t=null,this.s=null,this.i=t,this.o=e,this.t=r,this.s=s,this.o.addEventListener("message",this.l.bind(this))}setOutgoingMessageBus(t){this.t=t}setMessageExecution(t){this.s=t}sendMessage(t,e=[]){return new Promise((r,s)=>{const i=new MessageChannel;i.port1.onmessage=t=>{if(!t||!t.data)return i.port1.close(),i.port2.close(),s(new Error(this.i+" received message but response can not be interpreted"));let e;try{e=JSON.parse(t.data)}catch(t){return i.port1.close(),i.port2.close(),this.h(t),s(t)}e.error?s(e.error):void 0!==e.result?r(e.result):r(),i.port1.close(),i.port2.close()};let o="";try{o=JSON.stringify({message:t,args:e})}catch(t){return s(new Error(this.i+": can not create command because it is not JSON.stringify able"))}if(!this.t)return s(new Error(this.i+": outgoing bus not set yet"));this.t.postMessage(o,"*",[i.port2])})}l(t){const e=t.ports&&Array.isArray(t.ports)&&t.ports.length>0?t.ports[0]:null;if(t.data&&e)try{const r=JSON.parse(t.data);if(!this.s)return e.postMessage(JSON.stringify({error:this.i+" is not ready to handle messages"}));Array.isArray(r.args)||(r.args=[r.args]);const s=this.s(r,t);if(void 0===s)return;s.then((t={})=>{let r=void 0,s=void 0;"object"==typeof t&&null!==t&&(r=t.error,s=t.result),r?e.postMessage(JSON.stringify({error:r})):void 0!==s?e.postMessage(JSON.stringify({result:s})):e.postMessage(JSON.stringify({result:t}))},t=>{e.postMessage(JSON.stringify({error:this.h(t)}))})}catch(t){e.postMessage(JSON.stringify({error:this.h(t)}))}}h(t){if("string"==typeof t){const e=this.i+": "+t;return console.error(e),e}return t.message=this.i+": "+t.message,console.error(t),t.message}}const e=(t,r)=>{for(const s in r)try{r[s].constructor===Object?t[s]=e(t[s],r[s]):t[s]=r[s]}catch(e){t[s]=r[s]}return t},r=["127.0.0.1","localhost","0.0.0.0"],s=["language","browserLanguage","userLanguage","systemLanguage"],i=t=>{if(!t)return;const e=Object.keys(t);for(const r of e){const e=t[r];if(!Array.isArray(e)&&"object"==typeof e&&null!==e)return i(e);if(Array.isArray(e)){for(const t of e)i(t);return}"true"!==e&&"false"!==e||(t[r]="true"===e)}},o=()=>/(android)/i.test(navigator.userAgent),n=(t,e,r)=>{let s=null;Object.defineProperty(t,e,{get:()=>s||r,set(t){(null==t?void 0:t.mute)?s=t.value:(console.warn("You override Roomle defined behaviour. To disalbe this warning pass in an object with the following properties"),console.warn("{ mute: true, value: () => void }"),s=t)}})},a=()=>.01*window.innerHeight+"px",l=t=>{t&&setTimeout(()=>t.style.setProperty(h,a()),0)},h="--rml-full-height",c=new Map;class u{constructor(e,r,s,i){if(this.ui={callbacks:null},this.extended={callbacks:null},this.analytics={callbacks:{}},this.global={callbacks:{}},this.u={},!e||"string"!=typeof e.id)throw new Error("Please provide a correct configuratorId, you get the correct ID from your Roomle Contact Person");if(c.has(r))throw new Error("There is already an instance on this DOM element");if(!document.getElementById("rml-styles")){const t=s.zIndex||9999999,e=document.createElement("style");e.type="text/css",e.id="rml-styles";const r="transition:all ease-in-out 450ms;",i=["-webkit-","-o-"].reduce((t,e)=>t+(e+r),"")+r,o=a();e.innerHTML=`\n        .rml-container{${h}:${o};}\n        .rml-pos{position:fixed;top:0;left:0;z-index:${t};opacity:0}\n        .rml-transition{${i}}\n        .rml-fill{width:100%;height:100%;opacity:1}\n        .rml-android-height{height:calc(var(${h},1vh)*100)}\n        .rml-overflow-hidden{overflow:hidden}\n      `,document.head.appendChild(e)}this.m=this.m.bind(this),o()&&window.addEventListener("resize",this.m),this.g=r,this.u=s,this.p=e;const n=this.v();this.O=this.O.bind(this),this.N=this.N.bind(this),this.P=this.P.bind(this),this._=new t("website",window,null,this.N),this.J=i,this.g.appendChild(n),this.S=n,c.set(r,!0)}static createPlanner(t,e,r){return this.k(t,e,r)}static createConfigurator(t,e,r){return this.k(t,e,r)}static create(t,e,r){return this.k(t,e,r)}static createViewer(t,e,r){return this.k(t,e,r)}static k(t,o,n){return new Promise(async(a,l)=>{try{const l=e((()=>{const t={};t.locale||(t.locale=((t=null)=>{const e=window.navigator;if(t)return t.substr(0,2);if(Array.isArray(e.languages)&&e.languages.length>0)return e.languages[0].substr(0,2);for(let t=0,r=s.length;t<r;t++){const r=e[s[t]];if(r)return r.substr(0,2)}return"en"})()),"(idle)"===t.id&&delete t.id;const e=(()=>{const t=(()=>{try{return window.self!==window.top}catch(t){return!0}})();let e=window.location.href;if(t){if(!document.referrer)return null;e=document.referrer}const{hostname:r}=new URL(e);return r})();return e&&(t=>!!r.includes(t)||!!t.endsWith("roomle.com")||!(!t.endsWith("gitlab.io")&&!t.endsWith("gitlab.com")))(e)&&(t.configuratorId="demoConfigurator"),t.customApiUrl="https://alpha.roomle.com/api/v2",t.emails=!1,t})(),(t=>(i(t),(null==t?void 0:t.customApiUrl)&&(t.customApiUrl=decodeURIComponent(t.customApiUrl)),t.shareUrl&&(t.deeplink=t.shareUrl.replace("<CONF_ID>","#CONFIGURATIONID#")),t))(n));l.featureFlags||(l.featureFlags={}),"boolean"!=typeof l.featureFlags.realPartList&&(l.featureFlags.realPartList=!0),"boolean"!=typeof l.featureFlags.globalCallbacks&&(l.featureFlags.globalCallbacks=!0);const h=await(async(t,e)=>{if("string"!=typeof t)throw new Error('Configurator ID is not a string type: "'+typeof t+'"');const r=e.customApiUrl?e.customApiUrl:"https://api.roomle.com/v2",s=e.overrideTenant||9,i=r+"/configurators/"+t,o="03-"+window.btoa((new Date).toISOString()+";anonymous;roomle_portal_v2"),n=new Request(i,{method:"GET",headers:new Headers({apiKey:"roomle_portal_v2",currentTenant:s,locale:"en",language:"en",device:1,token:o,platform:"web"}),mode:"cors",cache:"default"}),a=await fetch(n),{configurator:l}=await a.json();return l})(t,l);return n=((t,r)=>{r.configuratorId=t.id;const s=t.settings||{};return!r.overrideTenant&&t.tenant&&(r.overrideTenant=t.tenant),((t,r)=>{const s=JSON.parse(JSON.stringify(t));return e(s,r)})(s,r)})(h,l),new this(h,o,n,a)}catch(t){return l(t)}})}teardown(){this.g&&c.delete(this.g);const t=this.g.querySelector("iframe");t&&this.g.removeChild(t),window.removeEventListener("resize",this.m)}v(){var t;const e=document.createElement("iframe");let r=(null===(t=this.p)||void 0===t?void 0:t.url)||"https://www.roomle.com/t/cp/";return this.u.useLocalRoomle&&(r=location.href.replace("embedding.html","")),location.href.includes("roomle.gitlab.io")&&(r=location.href.replace("embedding.html","index.html")),this.u.overrideServerUrl&&(r=this.u.overrideServerUrl),e.src=r,e.classList.add("rml-container"),e.classList.add("rml-fill"),e}m(){l(this.S)}O(){this.S.classList.add("rml-pos"),document.documentElement.classList.add("rml-overflow-hidden"),window.document.body.classList.add("rml-overflow-hidden"),o()&&(l(this.S),this.S.classList.add("rml-android-height"))}P(){this.S.classList.remove("rml-pos"),this.S.classList.remove("rml-android-height"),document.documentElement.classList.remove("rml-overflow-hidden"),window.document.body.classList.remove("rml-overflow-hidden")}N({message:t,args:e},r){var s;if(!r.source)return;if(r.source!==(null===(s=this.S)||void 0===s?void 0:s.contentWindow))return;if("requestBoot"===t)return this._.setOutgoingMessageBus(r.source),Promise.resolve({result:this.u});if("setup"===t){const{methods:t,callbacks:r}=e[0];return t.forEach(t=>{const e=t.split("."),r=e[0],s=e[1];this[r]||(this[r]={}),this[r][s]=function(){return this._.sendMessage(t,[...arguments])}.bind(this)}),r.forEach(t=>{const e=t.split("."),r=e[0],s=e[1],i=e[2];this[r]||(this[r]={}),this[r][s]||(this[r][s]={}),this[r][s][i]=()=>{}}),n(this.ui.callbacks,"onUseFullPage",this.O),n(this.ui.callbacks,"onBackToWebsite",this.P),this.J(this),setTimeout(()=>this._.sendMessage("websiteReady"),0),Promise.resolve({result:null})}const i=t.split("."),o=i[0],a=i[1],l=3===i.length?i[2]:null;if(l&&this[o][a][l]){const t=this[o][a][l](...e);return t instanceof Promise?t.then(t=>({result:t})):void 0!==t?Promise.resolve({result:t}):Promise.resolve({result:null})}return Promise.reject('Message "'+t+'" is unkown')}}export{u as default};
+import"@/common/styles/Global.module.scss";class t{constructor(t,e,r,i){this.t=null,this.i=null,this.o=t,this.s=e,this.t=r,this.i=i,this.s.addEventListener("message",this.l.bind(this))}setOutgoingMessageBus(t){this.t=t}setMessageExecution(t){this.i=t}sendMessage(t,e=[]){return new Promise((r,i)=>{const o=new MessageChannel;o.port1.onmessage=t=>{if(!t||!t.data)return o.port1.close(),o.port2.close(),i(new Error(this.o+" received message but response can not be interpreted"));let e;try{e=JSON.parse(t.data)}catch(t){return o.port1.close(),o.port2.close(),this.h(t),i(t)}e.error?i(e.error):void 0!==e.result?r(e.result):r(),o.port1.close(),o.port2.close()};let s="";try{s=JSON.stringify({message:t,args:e})}catch(t){return i(new Error(this.o+": can not create command because it is not JSON.stringify able"))}if(!this.t)return i(new Error(this.o+": outgoing bus not set yet"));this.t.postMessage(s,"*",[o.port2])})}l(t){const e=t.ports&&Array.isArray(t.ports)&&t.ports.length>0?t.ports[0]:null;if(t.data&&e)try{const r=JSON.parse(t.data);if(!this.i)return e.postMessage(JSON.stringify({error:this.o+" is not ready to handle messages"}));Array.isArray(r.args)||(r.args=[r.args]);const i=this.i(r,t);if(void 0===i)return;i.then((t={})=>{let r=void 0,i=void 0;"object"==typeof t&&null!==t&&(r=t.error,i=t.result),r?e.postMessage(JSON.stringify({error:r})):void 0!==i?e.postMessage(JSON.stringify({result:i})):e.postMessage(JSON.stringify({result:t}))},t=>{e.postMessage(JSON.stringify({error:this.h(t)}))})}catch(t){e.postMessage(JSON.stringify({error:this.h(t)}))}}h(t){if("string"==typeof t){const e=this.o+": "+t;return console.error(e),e}return t.message=this.o+": "+t.message,console.error(t),t.message}}const e=()=>/(android)/i.test(navigator.userAgent);var r,i,o,s,n;!function(t){t.DIMENSION="dimension",t.METRIC="metric"}(r||(r={})),function(t){t.EVENT="event"}(i||(i={})),function(t){t.EXCEPTION="exception",t.TIMING="timing_complete"}(o||(o={})),function(t){t.TRACK_TIMING="track_timing"}(s||(s={})),function(t){t.ERROR="Error",t.NAVIGATION_TIMING="Navigation Timing",t.TIMING="Timing",t.INTERACTION="Interaction",t.TRACKING="Tracking",t.DEPRECATION="Deprecation"}(n||(n={}));const a=(t,e)=>{for(const r in e)try{e[r].constructor===Object?t[r]=a(t[r],e[r]):t[r]=e[r]}catch(i){t[r]=e[r]}return t},l=["127.0.0.1","localhost","0.0.0.0"],c=["language","browserLanguage","userLanguage","systemLanguage"],h=t=>{if(!t)return;const e=Object.keys(t);for(const r of e){const e=t[r];if(!Array.isArray(e)&&"object"==typeof e&&null!==e)return h(e);if(Array.isArray(e)){for(const t of e)h(t);return}"true"!==e&&"false"!==e||(t[r]="true"===e)}},u=(t,e,r)=>{let i=null;Object.defineProperty(t,e,{get:()=>i||r,set(t){(null==t?void 0:t.mute)?i=t.value:(console.warn("You override Roomle defined behaviour. To disalbe this warning pass in an object with the following properties"),console.warn("{ mute: true, value: () => void }"),i=t)}})},d=()=>.01*window.innerHeight+"px",m=t=>{t&&setTimeout(()=>t.style.setProperty(f,d()),0)},f="--rml-full-height",w=new Map;class g{constructor(r,i,o,s){if(this.ui={callbacks:null},this.extended={callbacks:null},this.analytics={callbacks:{}},this.global={callbacks:{}},this.u={},!r||"string"!=typeof r.id)throw new Error("Please provide a correct configuratorId, you get the correct ID from your Roomle Contact Person");if(w.has(i))throw new Error("There is already an instance on this DOM element");if(!document.getElementById("rml-styles")){const t=o.zIndex||9999999,e=document.createElement("style");e.type="text/css",e.id="rml-styles";const r="transition:all ease-in-out 450ms;",i=["-webkit-","-o-"].reduce((t,e)=>t+(e+r),"")+r,s=d();e.innerHTML=`\n        .rml-container{${f}:${s};}\n        .rml-pos{position:fixed;top:0;left:0;z-index:${t};opacity:0}\n        .rml-transition{${i}}\n        .rml-fill{width:100%;height:100%;opacity:1}\n        .rml-android-height{height:calc(var(${f},1vh)*100)}\n        .rml-overflow-hidden{overflow:hidden}\n      `,document.head.appendChild(e)}this.m=this.m.bind(this),e()&&window.addEventListener("resize",this.m),this.g=i,this.u=o,this.p=r;const n=this.v();this.O=this.O.bind(this),this.N=this.N.bind(this),this._=this._.bind(this),this.P=new t("website",window,null,this.N),this.k=s,this.g.appendChild(n),this.J=n,w.set(i,!0)}static createPlanner(t,e,r){return this.S(t,e,r)}static createConfigurator(t,e,r){return this.S(t,e,r)}static create(t,e,r){return this.S(t,e,r)}static createViewer(t,e,r){return this.S(t,e,r)}static S(t,e,r){return new Promise(async(i,o)=>{try{const o=a((()=>{const t={};t.locale||(t.locale=((t=null)=>{const e=window.navigator;if(t)return t.substr(0,2);if(Array.isArray(e.languages)&&e.languages.length>0)return e.languages[0].substr(0,2);for(let t=0,r=c.length;t<r;t++){const r=e[c[t]];if(r)return r.substr(0,2)}return"en"})()),"(idle)"===t.id&&delete t.id;const e=(()=>{const t=(()=>{try{return window.self!==window.top}catch(t){return!0}})();let e=window.location.href;if(t){if(!document.referrer)return null;e=document.referrer}const{hostname:r}=new URL(e);return r})();return e&&(t=>!!l.includes(t)||!!t.endsWith("roomle.com")||!(!t.endsWith("gitlab.io")&&!t.endsWith("gitlab.com")))(e)&&(t.configuratorId="demoConfigurator"),t.customApiUrl="https://www.roomle.com/api/v2",t.emails=!1,t})(),(t=>(h(t),(null==t?void 0:t.customApiUrl)&&(t.customApiUrl=decodeURIComponent(t.customApiUrl)),t.shareUrl&&(t.deeplink=t.shareUrl.replace("<CONF_ID>","#CONFIGURATIONID#")),t))(r));o.featureFlags||(o.featureFlags={}),"boolean"!=typeof o.featureFlags.realPartList&&(o.featureFlags.realPartList=!0),"boolean"!=typeof o.featureFlags.globalCallbacks&&(o.featureFlags.globalCallbacks=!0);const s=await(async(t,e)=>{if("string"!=typeof t)throw new Error('Configurator ID is not a string type: "'+typeof t+'"');const r=e.customApiUrl?e.customApiUrl:"https://api.roomle.com/v2",i=e.overrideTenant||9,o=r+"/configurators/"+t,s="03-"+window.btoa((new Date).toISOString()+";anonymous;roomle_portal_v2"),n=new Request(o,{method:"GET",headers:new Headers({apiKey:"roomle_portal_v2",currentTenant:i,locale:"en",language:"en",device:1,token:s,platform:"web"}),mode:"cors",cache:"default"}),a=await fetch(n),{configurator:l}=await a.json();return l})(t,o);return r=((t,e)=>{e.configuratorId=t.id;const r=t.settings||{};return!e.overrideTenant&&t.tenant&&(e.overrideTenant=t.tenant),((t,e)=>{const r=JSON.parse(JSON.stringify(t));return a(r,e)})(r,e)})(s,o),new this(s,e,r,i)}catch(t){return o(t)}})}teardown(){this.g&&w.delete(this.g);const t=this.g.querySelector("iframe");t&&this.g.removeChild(t),window.removeEventListener("resize",this.m)}v(){var t;const e=document.createElement("iframe");let r=(null===(t=this.p)||void 0===t?void 0:t.url)||"https://www.roomle.com/t/cp/";return this.u.useLocalRoomle&&(r=location.href.replace("embedding.html","")),location.href.includes("roomle.gitlab.io")&&(r=location.href.replace("embedding.html","index.html")),this.u.overrideServerUrl&&(r=this.u.overrideServerUrl),e.src=r,e.classList.add("rml-container"),e.classList.add("rml-fill"),e}m(){m(this.J)}O(){this.J.classList.add("rml-pos"),document.documentElement.classList.add("rml-overflow-hidden"),window.document.body.classList.add("rml-overflow-hidden"),e()&&(m(this.J),this.J.classList.add("rml-android-height"))}_(){this.J.classList.remove("rml-pos"),this.J.classList.remove("rml-android-height"),document.documentElement.classList.remove("rml-overflow-hidden"),window.document.body.classList.remove("rml-overflow-hidden")}N({message:t,args:e},r){var i;if(!r.source)return;if(r.source!==(null===(i=this.J)||void 0===i?void 0:i.contentWindow))return;if("requestBoot"===t)return this.P.setOutgoingMessageBus(r.source),Promise.resolve({result:this.u});if("setup"===t){const{methods:t,callbacks:r}=e[0];return t.forEach(t=>{const e=t.split("."),r=e[0],i=e[1];this[r]||(this[r]={}),this[r][i]=function(){return this.P.sendMessage(t,[...arguments])}.bind(this)}),r.forEach(t=>{const e=t.split("."),r=e[0],i=e[1],o=e[2];this[r]||(this[r]={}),this[r][i]||(this[r][i]={}),this[r][i][o]=()=>{}}),u(this.ui.callbacks,"onUseFullPage",this.O),u(this.ui.callbacks,"onBackToWebsite",this._),this.k(this),setTimeout(()=>this.P.sendMessage("websiteReady"),0),Promise.resolve({result:null})}const o=t.split("."),s=o[0],n=o[1],a=3===o.length?o[2]:null;if(a&&this[s][n][a]){const t=this[s][n][a](...e);return t instanceof Promise?t.then(t=>({result:t})):void 0!==t?Promise.resolve({result:t}):Promise.resolve({result:null})}return Promise.reject('Message "'+t+'" is unkown')}}export{g as default};

package/roomle-configurator-api.js

@@ -1,3 +1,5 @@
+import '@/common/styles/Global.module.scss';
+
 class MessageHandler {
     constructor(side, incomingMessageBus, outgoingMessageBus, messageExecution) {
         this._outgoingMessageBus = null;
@@ -160,6 +162,51 @@ const isInIframe = () => {
     }
 };
 
+// see why: so#/58065241/10800831
+const isAndroid = () => /(android)/i.test(navigator.userAgent);
+
+/* TO DOs in Google Analytics Admin UI
+
+ To track the Hit ID, Hit Time, and Hit Type and custom dimensions, first create them in Google Analytics
+ and set their scope to "Hit"
+
+ Once you've created the custom metrics in Google Analytics
+ (and set their scope to "Hit" and their formatting type to "Integer")
+ this setup is ready to go. You need to do this in every GA property
+
+ For more details see: https://philipwalton.com/articles/the-google-analytics-setup-i-use-on-every-site-i-build/
+
+ */
+// Probably we could add const enums here
+// but we need to investigate: https://roomle.atlassian.net/browse/CONF-238
+var GA_CUSTOM;
+(function (GA_CUSTOM) {
+    GA_CUSTOM["DIMENSION"] = "dimension";
+    GA_CUSTOM["METRIC"] = "metric";
+})(GA_CUSTOM || (GA_CUSTOM = {}));
+var GA_HIT_TYPE;
+(function (GA_HIT_TYPE) {
+    GA_HIT_TYPE["EVENT"] = "event";
+})(GA_HIT_TYPE || (GA_HIT_TYPE = {}));
+var GA_ACTION_TYPE;
+(function (GA_ACTION_TYPE) {
+    GA_ACTION_TYPE["EXCEPTION"] = "exception";
+    GA_ACTION_TYPE["TIMING"] = "timing_complete";
+})(GA_ACTION_TYPE || (GA_ACTION_TYPE = {}));
+var CUSTOM_ACTION_TYPE;
+(function (CUSTOM_ACTION_TYPE) {
+    CUSTOM_ACTION_TYPE["TRACK_TIMING"] = "track_timing";
+})(CUSTOM_ACTION_TYPE || (CUSTOM_ACTION_TYPE = {}));
+var GA_CATEGORY;
+(function (GA_CATEGORY) {
+    GA_CATEGORY["ERROR"] = "Error";
+    GA_CATEGORY["NAVIGATION_TIMING"] = "Navigation Timing";
+    GA_CATEGORY["TIMING"] = "Timing";
+    GA_CATEGORY["INTERACTION"] = "Interaction";
+    GA_CATEGORY["TRACKING"] = "Tracking";
+    GA_CATEGORY["DEPRECATION"] = "Deprecation";
+})(GA_CATEGORY || (GA_CATEGORY = {}));
+
 /**
  * Recursively merge properties of two objects.
  * If a property exists in both it, property of obj2 is used.
@@ -305,16 +352,13 @@ const getFallbackInitData = () => {
     if (hostname && isDemoHostname(hostname)) {
         fallbackInitData.configuratorId = 'demoConfigurator';
     }
-    fallbackInitData.customApiUrl = 'https://alpha.roomle.com/api/v2';
+    fallbackInitData.customApiUrl = 'https://www.roomle.com/api/v2';
     fallbackInitData.emails = false;
     return fallbackInitData;
 };
 const LEGACY_SHARE_PLACEHOLDER = '<CONF_ID>';
 const SHARE_PLACEHOLDER = '#CONFIGURATIONID#';
 
-// see why: so#/58065241/10800831
-const isAndroid = () => /(android)/i.test(navigator.userAgent);
-
 const setDefaultBehaviour = (object, callbackName, defaultBehaviour) => {
     let customBehaviour = null;
     Object.defineProperty(object, callbackName, {

package/types/index.d.ts

@@ -7,9 +7,10 @@ declare module "common/utils/types" {
     export const enum USER_ACTION_MODULE {
         CONFIGURATOR = 3
     }
-    export const enum USER_ACTION {
+    export enum USER_ACTION {
         CONVERSION = 11,
-        SHARE_AR = 301
+        SHARE_AR = 301,
+        SAVE_DRAFT = 302
     }
 }
 declare module "configurator/embedding/message-handler" {
@@ -62,7 +63,10 @@ declare module "configurator/embedding/types" {
         STARTCONFIGURE = "startconfigure",
         PAUSECONFIGURE = "pauseconfigure",
         EXPORT_3D = "export3d",
-        ROTATE = "rotate"
+        ROTATE = "rotate",
+        SNAPPING = "snapping",
+        UNDO = "undo",
+        REDO = "redo"
     }
     interface FeatureFlags {
         realPartList?: boolean;
@@ -86,6 +90,9 @@ declare module "configurator/embedding/types" {
             [UI_BUTTON.STARTCONFIGURE]?: boolean;
             [UI_BUTTON.PAUSECONFIGURE]?: boolean;
             [UI_BUTTON.EXPORT_3D]?: boolean;
+            [UI_BUTTON.SNAPPING]?: boolean;
+            [UI_BUTTON.UNDO]?: boolean;
+            [UI_BUTTON.REDO]?: boolean;
         };
         skin?: EmbeddingSkin;
         zIndex?: number;
@@ -339,9 +346,124 @@ declare module "common/utils/init-data" {
         [key: string]: any;
     }, path: string, value: any) => void;
 }
+declare module "common/utils/user-agent" {
+    import { Nullable } from "common/utils/types";
+    export const isIOs: () => boolean;
+    export const hasARQuicklook: () => Nullable<boolean>;
+    export const isInAppBrowser: () => Nullable<boolean>;
+    export const isAndroid: () => boolean;
+    export const deviceSupportsAR: () => boolean;
+}
+declare module "common/utils/dom" {
+    import { Nullable } from "common/utils/types";
+    export const isScrolledToRightEnd: (element: Nullable<HTMLElement>, threshold?: number) => boolean;
+    export const hasVerticalOverflow: (element: HTMLElement) => boolean;
+    export const hasHorizontalOverflow: (element: HTMLElement) => boolean;
+    export const lastVisibleElement: (container: HTMLElement, threshold?: number) => Element;
+    export const cssVariableToNumber: (cssVariable: string) => number;
+    export const remToPixel: (remValue: string, remBase: number) => number;
+    export const percentInStringToFloat: (percentInString: string) => number;
+    export const animationDurationInMsToFloat: (animationDuration: string) => number;
+    export const calcIsDesktop: () => boolean;
+    export const removeLoadingScreen: () => Promise<void>;
+    export const showLoadingScreen: () => Promise<void>;
+    export const copyToClipboard: (text: string) => void;
+    export const setLoadingProgress: (percent: number) => void;
+    export const hideLoadingCircle: () => void;
+}
+declare module "common/utils/script-loader" {
+    export default class ScriptLoader {
+        static fetch(url: string, options: {
+            id: string;
+        }): Promise<void>;
+    }
+}
+declare module "common/utils/google-analytics" {
+    import { Nullable } from "common/utils/types";
+    export const GA_DIMENSIONS: {
+        [key: string]: string;
+    };
+    export const GA_METRICS: {
+        RESPONSE_END_TIME: string;
+        DOM_LOAD_TIME: string;
+        WINDOW_LOAD_TIME: string;
+        TIME_TO_FIRST_BTYE: string;
+        KERNEL_IS_READY: string;
+        INIT_LOADING_SCREEN_CLOSE: string;
+    };
+    enum GA_ACTION_TYPE {
+        EXCEPTION = "exception",
+        TIMING = "timing_complete"
+    }
+    enum CUSTOM_ACTION_TYPE {
+        TRACK_TIMING = "track_timing"
+    }
+    export const GA_NULL_VALUE = "(not set)";
+    export enum GA_CATEGORY {
+        ERROR = "Error",
+        NAVIGATION_TIMING = "Navigation Timing",
+        TIMING = "Timing",
+        INTERACTION = "Interaction",
+        TRACKING = "Tracking",
+        DEPRECATION = "Deprecation"
+    }
+    export type GoogleAnalyticsCallback = (...args: any[]) => void;
+    export const MAX_QUEUE_LENGTH = 1500;
+    export default class GoogleAnalytics {
+        history: IArguments[];
+        private _settings;
+        private _queue;
+        private _trackingId;
+        private _useTracking;
+        private _callbacks;
+        private _gaReady;
+        private get _gtag();
+        constructor(configuratorId: string, useTracking?: boolean);
+        giveConsent(): void;
+        trackEvent(action: CUSTOM_ACTION_TYPE | GA_ACTION_TYPE | string, category: GA_CATEGORY, label: string, value?: Nullable<number>, fieldsObject?: object): void;
+        trackTiming(category: GA_CATEGORY, label: any, value: number, fieldsObject?: object): void;
+        setDimension(dimension: string, value: any): void;
+        setDimensions(dimensions: {
+            [key: string]: any;
+        }): void;
+        trackError(message: string, specialErrorName?: Nullable<string>): void;
+        trackContentError(message: string): void;
+        addCallback(listener: GoogleAnalyticsCallback): void;
+        removeUiCallback(listener: GoogleAnalyticsCallback): void;
+        cleanUpHistory(): void;
+        trackWrongDomain(): void;
+        trackNoActivePackage(): void;
+        private _execCommand;
+        private _loadLibScript;
+        private _send;
+        private _flushQueue;
+        private _setObjectProperties;
+        private _trackException;
+        private _trackErrors;
+        private _trackErrorEvent;
+        private _setSettings;
+        private _findDimension;
+        private _sendNavigationTimingMetrics;
+    }
+}
+declare module "common/plugins/analytics" {
+    import GoogleAnalytics from "common/utils/google-analytics";
+    export interface Analytics {
+        ga: GoogleAnalytics;
+    }
+    const AnalyticsPlugin: {
+        install(Vue: any, { configuratorId, useTracking }: {
+            configuratorId: string;
+            useTracking: boolean;
+        }): void;
+    };
+    export default AnalyticsPlugin;
+}
 declare module "common/utils/helper" {
     import { Nullable } from "common/utils/types";
     import { RapiConfiguration, RapiItem, RapiTenant } from '@roomle/web-sdk/lib/definitions/typings/rapi-types';
+    import { Analytics } from "common/plugins/analytics";
+    import { SdkConnector } from "configurator/business-logic/sdk-connector";
     export const throttle: <T extends (...args: any[]) => any>(func: T, delay?: number) => (...funcArgs: Parameters<T>) => void;
     export const round: (float: number, precision: number) => number;
     export const isIdAnItem: (id: string) => boolean;
@@ -400,6 +522,7 @@ declare module "common/utils/helper" {
     export const runOnIdle: any;
     export const createShareLinkFromUrl: (url: string) => string;
     export const isLocationJestTest: () => boolean;
+    export const loadVariant: (id: string, applyCurrentGlobalParameters: boolean, sdkConnector: SdkConnector, analytics?: Analytics) => Promise<void>;
 }
 declare module "configurator/store/core-data" {
     import { Module } from 'vuex';
@@ -471,14 +594,14 @@ declare module "common/utils/parameters" {
 }
 declare module "configurator/components/-utils/overlays" {
     export enum OVERLAYS {
-        PART_LIST = 0,
-        NO_DOCKING = 1,
-        SAVE_DRAFT = 2,
-        VARIANT_WARNING = 3,
-        OPEN_AR = 4,
-        EXPORT_3D = 5,
-        ELEMENT_DISABLED = 6,
-        DELETE_WARNING = 7
+        NO_DOCKING = 0,
+        SAVE_DRAFT = 1,
+        VARIANT_WARNING = 2,
+        OPEN_AR = 3,
+        EXPORT_3D = 4,
+        ELEMENT_DISABLED = 5,
+        DELETE_WARNING = 6,
+        GENERIC_ERROR = 7
     }
     export interface OverlayState {
         open: boolean;
@@ -538,7 +661,7 @@ declare module "common/store/collection-view-state" {
     import { CollectionViewElement } from "configurator/components/collection-view/-utils/types";
     import { StoreState } from "common/store/index";
     export interface GridViewUiState {
-        filter: Nullable<string>;
+        filter: string[];
         showAllAsList: boolean;
         search: Nullable<string>;
         userInitiatedSearch: boolean;
@@ -556,7 +679,7 @@ declare module "common/store/collection-view-state" {
     export enum GRID_VIEW_STATE_MUTATIONS {
         SET_SEARCH = "GV_SET_SEARCH",
         TOGGLE_LIST_DISPLAY_TYPE = "GV_TOGGLE_LIST_DISPLAY_TYPE",
-        SET_FILTER = "GV_SET_FILTER",
+        TOGGLE_FILTER = "GV_TOGGLE_FILTER",
         SET_USER_INITIATED_SEARCH = "GV_SET_USER_INITIATED_SEARCH"
     }
     interface MuationPayload<T, V> {
@@ -567,6 +690,24 @@ declare module "common/store/collection-view-state" {
     export type CollectionViewMutationPayload<T> = MuationPayload<CollectionViewUiState, T>;
     export const collectionViewUiStateHelper: Module<CollectionViewUiState, StoreState>;
 }
+declare module "configurator/components/grid-view/-utils/GridViewHelper" {
+    import { RapiItem, RapiMaterial } from '@roomle/web-sdk/lib/definitions/typings/rapi-types';
+    import { KernelValue, UiPossibleChild } from '@roomle/web-sdk/lib/definitions/typings/kernel';
+    import { Nullable } from "common/utils/types";
+    export interface GridViewElement {
+        key: string;
+        payload: RapiMaterial | KernelValue | UiPossibleChild | RapiItem;
+    }
+    export interface GridViewVariantElement extends GridViewElement {
+        hash: string;
+    }
+    export interface GridViewGroup {
+        id: string;
+        label: Nullable<string>;
+        elements: GridViewElement[];
+    }
+    export const toGridViewElements: (elements: Array<RapiMaterial | KernelValue | UiPossibleChild | RapiItem>, key: string) => GridViewElement[];
+}
 declare module "configurator/store/ui-state" {
     import { Module } from 'vuex';
     import { SharedUiState, StoreState } from "common/store/index";
@@ -576,6 +717,7 @@ declare module "configurator/store/ui-state" {
     import { OverlaysOpenState } from "configurator/components/-utils/overlays";
     import { UiInitData } from "configurator/embedding/types";
     import { RapiTagForUi } from '@roomle/web-sdk/lib/definitions/typings/rapi-types';
+    import { GridViewVariantElement } from "configurator/components/grid-view/-utils/GridViewHelper";
     export enum BUTTON_ACTIONS {
         AR = 0,
         PARTLIST = 1,
@@ -584,7 +726,10 @@ declare module "configurator/store/ui-state" {
         FULLSCREEN = 4,
         RESET_CAMERA = 5,
         RENDER_IMAGE = 6,
-        ROTATE = 7
+        ROTATE = 7,
+        SNAPPING = 8,
+        UNDO = 9,
+        REDO = 10
     }
     export interface SceneSelection {
         selectionMode: string;
@@ -608,6 +753,11 @@ declare module "configurator/store/ui-state" {
         isConfigurator: boolean;
         isPlanner: boolean;
         email: Nullable<string>;
+        lastSelectedVariant: Nullable<GridViewVariantElement>;
+        undoEnabled: boolean;
+        redoEnabled: boolean;
+        undoEnabledPlanner: boolean;
+        redoEnabledPlanner: boolean;
     }
     export enum UI_STATE_MUTATIONS {
         SET_SELECTED_GROUP = "setSelectedGroup",
@@ -631,7 +781,12 @@ declare module "configurator/store/ui-state" {
         SET_CURRENT_VARIANTS = "SET_CURRENT_VARIANTS",
         SET_SHOW_VARIANTS = "SET_SHOW_VARIANTS",
         SET_EMAIL = "SET_EMAIL",
-        RESET_UI = "RESET_UI"
+        RESET_UI = "RESET_UI",
+        SET_LAST_SELECTED_VARIANT = "SET_LAST_SELECTED_VARIANT",
+        SET_UNDO = "SET_UNDO",
+        SET_REDO = "SET_REDO",
+        SET_UNDO_PLANNER = "SET_UNDO_PLANNER",
+        SET_REDO_PLANNER = "SET_REDO_PLANNER"
     }
     export enum UI_STATE_ACTIONS {
         SELECT_GROUP = "SELECT_GROUP",
@@ -643,10 +798,12 @@ declare module "configurator/store/ui-state" {
         PAUSE_CONFIGURING = "PAUSE_CONFIGURING",
         USE_VIEWER = "USE_VIEWER",
         USE_PLANNER = "USE_PLANNER",
-        USE_CONFIGURATOR = "USE_CONFIGURATOR"
+        USE_CONFIGURATOR = "USE_CONFIGURATOR",
+        SHOW_PARAMS = "SHOW_PARAMS"
     }
     export enum UI_STATE_GETTERS {
         USE_REGULAR_LAYOUT = "USE_REGULAR_LAYOUT",
+        PART_LIST_SHOWN = "PART_LIST_SHOWN",
         COLLECTION_VIEW_ELEMENTS = "COLLECTION_VIEW_ELEMENTS",
         COLLECTION_VIEW_ADDON_ELEMENTS = "COLLECTION_VIEW_ADDON_ELEMENTS",
         COLLECTION_VIEW_VARIANTS = "COLLECTION_VIEW_VARIANTS",
@@ -743,6 +900,11 @@ declare module "common/store/index" {
         SET_SHOW_VARIANTS: UI_STATE_MUTATIONS.SET_SHOW_VARIANTS;
         SET_EMAIL: UI_STATE_MUTATIONS.SET_EMAIL;
         RESET_UI: UI_STATE_MUTATIONS.RESET_UI;
+        SET_LAST_SELECTED_VARIANT: UI_STATE_MUTATIONS.SET_LAST_SELECTED_VARIANT;
+        SET_UNDO: UI_STATE_MUTATIONS.SET_UNDO;
+        SET_REDO: UI_STATE_MUTATIONS.SET_REDO;
+        SET_UNDO_PLANNER: UI_STATE_MUTATIONS.SET_UNDO_PLANNER;
+        SET_REDO_PLANNER: UI_STATE_MUTATIONS.SET_REDO_PLANNER;
         UPDATE_GROUPS: CORE_DATA_MUTATIONS.UPDATE_GROUPS;
         UPDATE_PARAMETERS: CORE_DATA_MUTATIONS.UPDATE_PARAMETERS;
         UPDATE_ADDONS: CORE_DATA_MUTATIONS.UPDATE_ADDONS;
@@ -767,6 +929,7 @@ declare module "common/store/index" {
         USE_VIEWER: UI_STATE_ACTIONS.USE_VIEWER;
         USE_PLANNER: UI_STATE_ACTIONS.USE_PLANNER;
         USE_CONFIGURATOR: UI_STATE_ACTIONS.USE_CONFIGURATOR;
+        SHOW_PARAMS: UI_STATE_ACTIONS.SHOW_PARAMS;
         UPDATE_PRICE: CORE_DATA_ACTIONS.UPDATE_PRICE;
         SET_LABEL: CORE_STATE_ACTIONS.SET_LABEL;
         SET_COMPONENT_HAS_CHILDREN: CORE_STATE_ACTIONS.SET_COMPONENT_HAS_CHILDREN;
@@ -782,119 +945,6 @@ declare module "common/store/index" {
     const _default: import("vuex").Store<StoreState>;
     export default _default;
 }
-declare module "common/utils/user-agent" {
-    import { Nullable } from "common/utils/types";
-    export const isIOs: () => boolean;
-    export const hasARQuicklook: () => Nullable<boolean>;
-    export const isInAppBrowser: () => Nullable<boolean>;
-    export const isAndroid: () => boolean;
-    export const deviceSupportsAR: () => boolean;
-}
-declare module "common/utils/dom" {
-    import { Nullable } from "common/utils/types";
-    export const isScrolledToRightEnd: (element: Nullable<HTMLElement>, threshold?: number) => boolean;
-    export const hasVerticalOverflow: (element: HTMLElement) => boolean;
-    export const hasHorizontalOverflow: (element: HTMLElement) => boolean;
-    export const lastVisibleElement: (container: HTMLElement, threshold?: number) => Element;
-    export const cssVariableToNumber: (cssVariable: string) => number;
-    export const remToPixel: (remValue: string, remBase: number) => number;
-    export const percentInStringToFloat: (percentInString: string) => number;
-    export const animationDurationInMsToFloat: (animationDuration: string) => number;
-    export const calcIsDesktop: () => boolean;
-    export const removeLoadingScreen: () => Promise<void>;
-    export const showLoadingScreen: () => Promise<void>;
-    export const copyToClipboard: (text: string) => void;
-    export const setLoadingProgress: (percent: number) => void;
-    export const hideLoadingCircle: () => void;
-}
-declare module "common/utils/script-loader" {
-    export default class ScriptLoader {
-        static fetch(url: string, options: {
-            id: string;
-        }): Promise<void>;
-    }
-}
-declare module "common/utils/google-analytics" {
-    import { Nullable } from "common/utils/types";
-    export const GA_DIMENSIONS: {
-        [key: string]: string;
-    };
-    export const GA_METRICS: {
-        RESPONSE_END_TIME: string;
-        DOM_LOAD_TIME: string;
-        WINDOW_LOAD_TIME: string;
-        TIME_TO_FIRST_BTYE: string;
-        KERNEL_IS_READY: string;
-        INIT_LOADING_SCREEN_CLOSE: string;
-    };
-    enum GA_ACTION_TYPE {
-        EXCEPTION = "exception",
-        TIMING = "timing_complete"
-    }
-    enum CUSTOM_ACTION_TYPE {
-        TRACK_TIMING = "track_timing"
-    }
-    export const GA_NULL_VALUE = "(not set)";
-    export enum GA_CATEGORY {
-        ERROR = "Error",
-        NAVIGATION_TIMING = "Navigation Timing",
-        TIMING = "Timing",
-        INTERACTION = "Interaction",
-        TRACKING = "Tracking",
-        DEPRECATION = "Deprecation"
-    }
-    export type GoogleAnalyticsCallback = (...args: any[]) => void;
-    export const MAX_QUEUE_LENGTH = 1500;
-    export default class GoogleAnalytics {
-        history: IArguments[];
-        private _settings;
-        private _queue;
-        private _trackingId;
-        private _useTracking;
-        private _callbacks;
-        private _gaReady;
-        private get _gtag();
-        constructor(configuratorId: string, useTracking?: boolean);
-        giveConsent(): void;
-        trackEvent(action: CUSTOM_ACTION_TYPE | GA_ACTION_TYPE | string, category: GA_CATEGORY, label: string, value?: Nullable<number>, fieldsObject?: object): void;
-        trackTiming(category: GA_CATEGORY, label: any, value: number, fieldsObject?: object): void;
-        setDimension(dimension: string, value: any): void;
-        setDimensions(dimensions: {
-            [key: string]: any;
-        }): void;
-        trackError(message: string, specialErrorName?: Nullable<string>): void;
-        trackContentError(message: string): void;
-        addCallback(listener: GoogleAnalyticsCallback): void;
-        removeUiCallback(listener: GoogleAnalyticsCallback): void;
-        cleanUpHistory(): void;
-        trackWrongDomain(): void;
-        trackNoActivePackage(): void;
-        private _execCommand;
-        private _loadLibScript;
-        private _send;
-        private _flushQueue;
-        private _setObjectProperties;
-        private _trackException;
-        private _trackErrors;
-        private _trackErrorEvent;
-        private _setSettings;
-        private _findDimension;
-        private _sendNavigationTimingMetrics;
-    }
-}
-declare module "common/plugins/analytics" {
-    import GoogleAnalytics from "common/utils/google-analytics";
-    export interface Analytics {
-        ga: GoogleAnalytics;
-    }
-    const AnalyticsPlugin: {
-        install(Vue: any, { configuratorId, useTracking }: {
-            configuratorId: string;
-            useTracking: boolean;
-        }): void;
-    };
-    export default AnalyticsPlugin;
-}
 declare module "common/utils/performance" {
     export const addLoadMark: () => void;
     export const calcTiming: () => void;
@@ -1117,6 +1167,7 @@ declare module "configurator/business-logic/sdk-connector" {
         private _execLoadingConfiguratorProcess;
         private _startLoading;
         private _finishLoading;
+        private _showGenericError;
     }
 }
 declare module "configurator/embedding/helper" {
@@ -1153,6 +1204,7 @@ declare module "configurator/embedding/exposed-api" {
     import RoomleGLBViewer from '@roomle/web-sdk/lib/definitions/glb-viewer-core/src/roomle-glb-viewer';
     import RoomlePlanner from '@roomle/web-sdk/lib/definitions/planner-core/src/roomle-planner';
     import { GlobalCallback } from '@roomle/web-sdk/lib/definitions/common-core/src/services/global-callback';
+    import { Position3 } from '@roomle/web-sdk/lib/definitions/common-core/src/common-interfaces';
     export class ExposedApi {
         private _sdk;
         private _exposedCallbacks;
@@ -1171,6 +1223,7 @@ declare module "configurator/embedding/exposed-api" {
         /**
          * call this method to load the configuration string you want into the 3d Scene
          * @param configurationString string of the configuration, starts with `{` and ends with `}`
+         * @returns null if configuration can not be loaded
          */
         loadConfigurationString(configurationString: string): Promise<Nullable<LoadResponse>>;
         /**
@@ -1218,6 +1271,14 @@ declare module "configurator/embedding/exposed-api" {
          * call this method if consent of Google Analytics is given later and not already in init-data on boot
          */
         giveGaConsent(): void;
+        /**
+         * Insert an object into the current MOC/planner scene
+         * If no position or rotation is set then it will be placed automatically (without overlapping other objects) with rotation 0
+         * @param id
+         * @param position as x (left/right), y (up/down) and z (front/back)
+         * @param rotation in radians
+         */
+        insertObject(id: string, position?: Position3, rotation?: number): Promise<void>;
         private _websiteReady;
         private _handleMessage;
         private _forwardSdkCallbacks;