@suprsend/node-sdk 1.1.0 → 1.1.2

package/README.md

@@ -3,109 +3,20 @@ This package can be included in a node project to easily integrate with `Suprsen
 
 Refer full documentation [here](https://docs.suprsend.com/docs/node)
 
-We're working towards creating SDK in other languages as well.
-
-### Suprsend SDKs available in following languages
-* node (`suprsend-node-sdk`)
-* python3 >= 3.7 (`suprsend-py-sdk`)
-
 ### Installation
 `suprsend-node-sdk` is available as npm package. You can install using npm or yarn.
-
-Using npm:
 ```bash
 npm install @suprsend/node-sdk
 ```
-Using yarn:
-```bash
-yarn add @suprsend/node-sdk
-```
 
-### Usage
+### Initialization
 Initialize the Suprsend SDK
 ```node
-const Suprsend = require("@suprsend/node-sdk");
+const {Suprsend} = require("@suprsend/node-sdk");
 
 // Initialize SDK
-const supr_client = new Suprsend("env_key", "env_secret");
-```
-
-Following example shows a sample request for triggering a workflow.
-It triggers a notification to a user with id: `distinct_id`,
-email: `user@example.com` & androidpush-token: `__android_push_token__`
-using template `purchase-made` and notification_category `system`
-
-```node
-// Prepare Workflow body
-const workflow_body = {
-    "name": "Purchase Workflow",
-    "template": "purchase-made",
-    "notification_category": "system",
-    "delay": "15m",
-    "users": [
-        {
-            "distinct_id": "0f988f74-6982-41c5-8752-facb6911fb08",
-            "$email": ["user@example.com"],
-            "$androidpush": ["__android_push_token__"],
-        }
-    ],
-    "data": {
-        "template": {
-            "first_name": "User",
-            "spend_amount": "$10"
-        },
-    }
-}
-
-// Trigger workflow
-const response = supr_client.trigger_workflow(workflow_body); // returns promise
-response.then((res) => console.log("response", res));
-```
-
-When you call `supr_client.trigger_workflow`, the SDK internally makes an HTTP call to SuprSend
-Platform to register this request, and you'll receive a promise which resolve to response indicating
-the acceptance status.
-
-Note: The actual processing/execution of workflow happens asynchronously.
-
-```node
-// If the call succeeds, response will looks like:
-{
-    "success": true,
-    "status_code": 202,
-    "message": "Accepted",
-}
-
-// In case the call fails. You will receive a response with success=false
-{
-    "success": false,
-    "status": 400,
-    "message": "error message",
-}
+const supr_client = new Suprsend("workspace_key", "workspace_secret");
 ```
 
-### Add attachments
-
-To add one or more Attachments to a Notification (viz. Email, Whatsapp),
-call `supr_client.add_attachment(...)` for each file.
-Ensure that file_path is proper, otherwise it will raise error.
-```node
-// this snippet can be used to add attachment to workflow_body.
-const file_path = "/home/user/billing.pdf"
-supr_client.add_attachment(workflow_body, file_path);
-```
-
-#### Attachment structure
-The `add_attachment(...)` call appends below structure to `data->'$attachments'`
-
-```json
-{
-    "filename": "billing.pdf",
-    "contentType": "application/pdf",
-    "data": "Q29uZ3JhdHVsYXRpb25zLCB5b3UgY2FuIGJhc2U2NCBkZWNvZGUh",
-}
-```
-Where
-* `filename` - name of file.
-* `contentType` - MIME-type of file content.
-* `data` - base64-encoded content of file.
+### License
+MIT © [https://github.com/suprsend](https://github.com/https://github.com/suprsend)

package/dist/brands.js

@@ -0,0 +1,245 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+
+var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
+
+var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
+
+var _signature = _interopRequireDefault(require("./signature"));
+
+var _utils = require("./utils");
+
+var _axios = _interopRequireDefault(require("axios"));
+
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2["default"])(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+
+var BrandsApi = /*#__PURE__*/function () {
+  function BrandsApi(config) {
+    (0, _classCallCheck2["default"])(this, BrandsApi);
+    this.config = config;
+    this.list_url = this.__list_url();
+    this.__headers = this.__common_headers();
+  }
+
+  (0, _createClass2["default"])(BrandsApi, [{
+    key: "__list_url",
+    value: function __list_url() {
+      var list_uri_template = "".concat(this.config.base_url, "v1/brand/");
+      return list_uri_template;
+    }
+  }, {
+    key: "__common_headers",
+    value: function __common_headers() {
+      return {
+        "Content-Type": "application/json; charset=utf-8",
+        "User-Agent": this.config.user_agent
+      };
+    }
+  }, {
+    key: "cleaned_limit_offset",
+    value: function cleaned_limit_offset(limit, offset) {
+      var cleaned_limit = typeof limit === "number" && limit > 0 && limit <= 1000 ? limit : 20;
+      var cleaned_offset = typeof offset === "number" && offset >= 0 ? offset : 0;
+      return [cleaned_limit, cleaned_offset];
+    }
+  }, {
+    key: "__dynamic_headers",
+    value: function __dynamic_headers() {
+      return {
+        Date: new Date().toUTCString()
+      };
+    }
+  }, {
+    key: "list",
+    value: function () {
+      var _list = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee() {
+        var kwargs,
+            limit,
+            offset,
+            _this$cleaned_limit_o,
+            _this$cleaned_limit_o2,
+            cleaned_limit,
+            cleaner_offset,
+            final_url_obj,
+            final_url_string,
+            headers,
+            signature,
+            response,
+            _args = arguments;
+
+        return _regenerator["default"].wrap(function _callee$(_context) {
+          while (1) {
+            switch (_context.prev = _context.next) {
+              case 0:
+                kwargs = _args.length > 0 && _args[0] !== undefined ? _args[0] : {};
+                limit = kwargs === null || kwargs === void 0 ? void 0 : kwargs.limit;
+                offset = kwargs === null || kwargs === void 0 ? void 0 : kwargs.offset;
+                _this$cleaned_limit_o = this.cleaned_limit_offset(limit, offset), _this$cleaned_limit_o2 = (0, _slicedToArray2["default"])(_this$cleaned_limit_o, 2), cleaned_limit = _this$cleaned_limit_o2[0], cleaner_offset = _this$cleaned_limit_o2[1];
+                final_url_obj = new URL(this.list_url);
+                final_url_obj.searchParams.append("limit", cleaned_limit);
+                final_url_obj.searchParams.append("offset", cleaner_offset);
+                final_url_string = final_url_obj.href;
+                headers = _objectSpread(_objectSpread({}, this.__headers), this.__dynamic_headers());
+                signature = (0, _signature["default"])(final_url_string, "GET", "", headers, this.config.workspace_secret);
+                headers["Authorization"] = "".concat(this.config.workspace_key, ":").concat(signature);
+                _context.prev = 11;
+                _context.next = 14;
+                return _axios["default"].get(final_url_string, {
+                  headers: headers
+                });
+
+              case 14:
+                response = _context.sent;
+                return _context.abrupt("return", response.data);
+
+              case 18:
+                _context.prev = 18;
+                _context.t0 = _context["catch"](11);
+                throw new _utils.SuprsendApiError(_context.t0);
+
+              case 21:
+              case "end":
+                return _context.stop();
+            }
+          }
+        }, _callee, this, [[11, 18]]);
+      }));
+
+      function list() {
+        return _list.apply(this, arguments);
+      }
+
+      return list;
+    }()
+  }, {
+    key: "detail_url",
+    value: function detail_url() {
+      var brand_id = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : "";
+      var cleaned_brand_id = brand_id.toString().trim();
+      var brand_id_encoded = encodeURI(cleaned_brand_id);
+      var url = "".concat(this.list_url).concat(brand_id_encoded, "/");
+      return url;
+    }
+  }, {
+    key: "get",
+    value: function () {
+      var _get = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee2() {
+        var brand_id,
+            url,
+            headers,
+            signature,
+            response,
+            _args2 = arguments;
+        return _regenerator["default"].wrap(function _callee2$(_context2) {
+          while (1) {
+            switch (_context2.prev = _context2.next) {
+              case 0:
+                brand_id = _args2.length > 0 && _args2[0] !== undefined ? _args2[0] : "";
+                url = this.detail_url(brand_id);
+                headers = _objectSpread(_objectSpread({}, this.__headers), this.__dynamic_headers());
+                signature = (0, _signature["default"])(url, "GET", "", headers, this.config.workspace_secret);
+                headers["Authorization"] = "".concat(this.config.workspace_key, ":").concat(signature);
+                _context2.prev = 5;
+                _context2.next = 8;
+                return _axios["default"].get(url, {
+                  headers: headers
+                });
+
+              case 8:
+                response = _context2.sent;
+                return _context2.abrupt("return", response.data);
+
+              case 12:
+                _context2.prev = 12;
+                _context2.t0 = _context2["catch"](5);
+                throw new _utils.SuprsendApiError(_context2.t0);
+
+              case 15:
+              case "end":
+                return _context2.stop();
+            }
+          }
+        }, _callee2, this, [[5, 12]]);
+      }));
+
+      function get() {
+        return _get.apply(this, arguments);
+      }
+
+      return get;
+    }()
+  }, {
+    key: "upsert",
+    value: function () {
+      var _upsert = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee3() {
+        var brand_id,
+            brand_payload,
+            url,
+            headers,
+            content_text,
+            signature,
+            response,
+            _args3 = arguments;
+        return _regenerator["default"].wrap(function _callee3$(_context3) {
+          while (1) {
+            switch (_context3.prev = _context3.next) {
+              case 0:
+                brand_id = _args3.length > 0 && _args3[0] !== undefined ? _args3[0] : "";
+                brand_payload = _args3.length > 1 && _args3[1] !== undefined ? _args3[1] : {};
+                url = this.detail_url(brand_id);
+                headers = _objectSpread(_objectSpread({}, this.__headers), this.__dynamic_headers());
+                content_text = JSON.stringify(brand_payload);
+                signature = (0, _signature["default"])(url, "POST", content_text, headers, this.config.workspace_secret);
+                headers["Authorization"] = "".concat(this.config.workspace_key, ":").concat(signature);
+                _context3.prev = 7;
+                _context3.next = 10;
+                return _axios["default"].post(url, content_text, {
+                  headers: headers
+                });
+
+              case 10:
+                response = _context3.sent;
+                return _context3.abrupt("return", response.data);
+
+              case 14:
+                _context3.prev = 14;
+                _context3.t0 = _context3["catch"](7);
+                throw new _utils.SuprsendApiError(_context3.t0);
+
+              case 17:
+              case "end":
+                return _context3.stop();
+            }
+          }
+        }, _callee3, this, [[7, 14]]);
+      }));
+
+      function upsert() {
+        return _upsert.apply(this, arguments);
+      }
+
+      return upsert;
+    }()
+  }]);
+  return BrandsApi;
+}();
+
+var _default = BrandsApi;
+exports["default"] = _default;
+module.exports = exports.default;

package/dist/event.js

@@ -42,7 +42,8 @@ var Event = /*#__PURE__*/function () {
     this.distinct_id = distinct_id;
     this.event_name = event_name;
     this.properties = properties;
-    this.idempotency_key = kwargs === null || kwargs === void 0 ? void 0 : kwargs.idempotency_key; // --- validate
+    this.idempotency_key = kwargs === null || kwargs === void 0 ? void 0 : kwargs.idempotency_key;
+    this.brand_id = kwargs === null || kwargs === void 0 ? void 0 : kwargs.brand_id; // --- validate
 
     this.__validate_distinct_id();
 
@@ -135,6 +136,10 @@ var Event = /*#__PURE__*/function () {
         event_dict["$idempotency_key"] = this.idempotency_key;
       }
 
+      if (this.brand_id) {
+        event_dict["brand_id"] = this.brand_id;
+      }
+
       event_dict = (0, _utils.validate_track_event_schema)(event_dict);
       var apparent_size = (0, _utils.get_apparent_event_size)(event_dict, is_part_of_bulk);
 

package/dist/index.js

@@ -41,6 +41,8 @@ var _subscriber = _interopRequireDefault(require("./subscriber"));
 
 var _subscribers_bulk = _interopRequireDefault(require("./subscribers_bulk"));
 
+var _brands = _interopRequireDefault(require("./brands"));
+
 var _constants = require("./constants");
 
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
@@ -66,6 +68,7 @@ var Suprsend = /*#__PURE__*/function () {
     this._bulk_events = new _events_bulk.BulkEventsFactory(this);
     this._bulk_users = new _subscribers_bulk["default"](this);
     this._user = new _subscriber["default"](this);
+    this.brands = new _brands["default"](this);
 
     this._validate();
   }

package/dist/language_codes.js

@@ -0,0 +1,200 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+
+var LANG_CODE_NAME_MAPPING = {
+  aa: "Afar",
+  ab: "Abkhazian",
+  ae: "Avestan",
+  af: "Afrikaans",
+  ak: "Akan",
+  am: "Amharic",
+  an: "Aragonese",
+  ar: "Arabic",
+  as: "Assamese",
+  av: "Avaric",
+  ay: "Aymara",
+  az: "Azerbaijani",
+  ba: "Bashkir",
+  be: "Belarusian",
+  bg: "Bulgarian",
+  bi: "Bislama",
+  bm: "Bambara",
+  bn: "Bengali",
+  bo: "Tibetan",
+  br: "Breton",
+  bs: "Bosnian",
+  ca: "Catalan; Valencian",
+  ce: "Chechen",
+  ch: "Chamorro",
+  co: "Corsican",
+  cr: "Cree",
+  cs: "Czech",
+  cu: "Church Slavic; Old Slavonic; Church Slavonic; Old Bulgarian; Old Church Slavonic",
+  cv: "Chuvash",
+  cy: "Welsh",
+  da: "Danish",
+  de: "German",
+  dv: "Divehi; Dhivehi; Maldivian",
+  dz: "Dzongkha",
+  ee: "Ewe",
+  el: "Greek, Modern (1453-)",
+  en: "English",
+  eo: "Esperanto",
+  es: "Spanish; Castilian",
+  et: "Estonian",
+  eu: "Basque",
+  fa: "Persian",
+  ff: "Fulah",
+  fi: "Finnish",
+  fj: "Fijian",
+  fo: "Faroese",
+  fr: "French",
+  fy: "Western Frisian",
+  ga: "Irish",
+  gd: "Gaelic; Scottish Gaelic",
+  gl: "Galician",
+  gn: "Guarani",
+  gu: "Gujarati",
+  gv: "Manx",
+  ha: "Hausa",
+  he: "Hebrew",
+  hi: "Hindi",
+  ho: "Hiri Motu",
+  hr: "Croatian",
+  ht: "Haitian; Haitian Creole",
+  hu: "Hungarian",
+  hy: "Armenian",
+  hz: "Herero",
+  ia: "Interlingua (International Auxiliary Language Association)",
+  id: "Indonesian",
+  ie: "Interlingue; Occidental",
+  ig: "Igbo",
+  ii: "Sichuan Yi; Nuosu",
+  ik: "Inupiaq",
+  io: "Ido",
+  is: "Icelandic",
+  it: "Italian",
+  iu: "Inuktitut",
+  ja: "Japanese",
+  jv: "Javanese",
+  ka: "Georgian",
+  kg: "Kongo",
+  ki: "Kikuyu; Gikuyu",
+  kj: "Kuanyama; Kwanyama",
+  kk: "Kazakh",
+  kl: "Kalaallisut; Greenlandic",
+  km: "Central Khmer",
+  kn: "Kannada",
+  ko: "Korean",
+  kr: "Kanuri",
+  ks: "Kashmiri",
+  ku: "Kurdish",
+  kv: "Komi",
+  kw: "Cornish",
+  ky: "Kirghiz; Kyrgyz",
+  la: "Latin",
+  lb: "Luxembourgish; Letzeburgesch",
+  lg: "Ganda",
+  li: "Limburgan; Limburger; Limburgish",
+  ln: "Lingala",
+  lo: "Lao",
+  lt: "Lithuanian",
+  lu: "Luba-Katanga",
+  lv: "Latvian",
+  mg: "Malagasy",
+  mh: "Marshallese",
+  mi: "Maori",
+  mk: "Macedonian",
+  ml: "Malayalam",
+  mn: "Mongolian",
+  mr: "Marathi",
+  ms: "Malay",
+  mt: "Maltese",
+  my: "Burmese",
+  na: "Nauru",
+  nb: "Bokmål, Norwegian; Norwegian Bokmål",
+  nd: "Ndebele, North; North Ndebele",
+  ne: "Nepali",
+  ng: "Ndonga",
+  nl: "Dutch; Flemish",
+  nn: "Norwegian Nynorsk; Nynorsk, Norwegian",
+  no: "Norwegian",
+  nr: "Ndebele, South; South Ndebele",
+  nv: "Navajo; Navaho",
+  ny: "Chichewa; Chewa; Nyanja",
+  oc: "Occitan (post 1500)",
+  oj: "Ojibwa",
+  om: "Oromo",
+  or: "Oriya",
+  os: "Ossetian; Ossetic",
+  pa: "Panjabi; Punjabi",
+  pi: "Pali",
+  pl: "Polish",
+  ps: "Pushto; Pashto",
+  pt: "Portuguese",
+  qu: "Quechua",
+  rm: "Romansh",
+  rn: "Rundi",
+  ro: "Romanian; Moldavian; Moldovan",
+  ru: "Russian",
+  rw: "Kinyarwanda",
+  sa: "Sanskrit",
+  sc: "Sardinian",
+  sd: "Sindhi",
+  se: "Northern Sami",
+  sg: "Sango",
+  si: "Sinhala; Sinhalese",
+  sk: "Slovak",
+  sl: "Slovenian",
+  sm: "Samoan",
+  sn: "Shona",
+  so: "Somali",
+  sq: "Albanian",
+  sr: "Serbian",
+  ss: "Swati",
+  st: "Sotho, Southern",
+  su: "Sundanese",
+  sv: "Swedish",
+  sw: "Swahili",
+  ta: "Tamil",
+  te: "Telugu",
+  tg: "Tajik",
+  th: "Thai",
+  ti: "Tigrinya",
+  tk: "Turkmen",
+  tl: "Tagalog",
+  tn: "Tswana",
+  to: "Tonga (Tonga Islands)",
+  tr: "Turkish",
+  ts: "Tsonga",
+  tt: "Tatar",
+  tw: "Twi",
+  ty: "Tahitian",
+  ug: "Uighur; Uyghur",
+  uk: "Ukrainian",
+  ur: "Urdu",
+  uz: "Uzbek",
+  ve: "Venda",
+  vi: "Vietnamese",
+  vo: "Volapük",
+  wa: "Walloon",
+  wo: "Wolof",
+  xh: "Xhosa",
+  yi: "Yiddish",
+  yo: "Yoruba",
+  za: "Zhuang; Chuang",
+  zh: "Chinese",
+  zu: "Zulu"
+};
+var ALL_LANG_CODES = (0, _toConsumableArray2["default"])(new Set(Object.keys(LANG_CODE_NAME_MAPPING)));
+var _default = ALL_LANG_CODES;
+exports["default"] = _default;
+module.exports = exports.default;

package/dist/request_json/event.json

@@ -11,6 +11,11 @@
       "maxLength": 64,
       "description": "unique id provided by client for request"
     },
+    "brand_id": {
+      "type": ["string", "null"],
+      "maxLength": 64,
+      "description": "brand id for workflow to be run in context of a brand"
+    },
     "$insert_id": {
       "type": "string",
       "minLength": 36,

package/dist/request_json/workflow.json

@@ -11,6 +11,11 @@
       "maxLength": 64,
       "description": "unique id provided by client for request"
     },
+    "brand_id": {
+      "type": ["string", "null"],
+      "maxLength": 64,
+      "description": "brand id for workflow to be run in context of a brand"
+    },
     "name": {
       "$ref": "#/definitions/non_empty_string",
       "description": "name of workflow"

package/dist/signature.js

@@ -15,14 +15,15 @@ function get_path(url) {
 }
 
 function get_request_signature(url, http_verb, content, headers, secret) {
-  if (http_verb === "GET") {
-    return "";
-  }
+  var content_md5 = "";
+  var content_type = headers["Content-Type"] || "";
 
-  var content_md5 = _crypto["default"].createHash("md5").update(content).digest("hex");
+  if (content) {
+    content_md5 = _crypto["default"].createHash("md5").update(content).digest("hex");
+  }
 
   var request_uri = get_path(url);
-  var sign_string = http_verb + "\n" + content_md5 + "\n" + headers["Content-Type"] + "\n" + headers["Date"] + "\n" + request_uri;
+  var sign_string = http_verb + "\n" + content_md5 + "\n" + content_type + "\n" + headers["Date"] + "\n" + request_uri;
 
   var hash = _crypto["default"].createHmac("sha256", secret).update(sign_string);
 

package/dist/subscriber.js

@@ -84,6 +84,7 @@ var Subscriber = /*#__PURE__*/function () {
     this.__info = [];
     this._append_count = 0;
     this._remove_count = 0;
+    this._set_count = 0;
     this._unset_count = 0;
     this._events = [];
     this._helper = new _subscriber_helper["default"](distinct_id, config.workspace_key);
@@ -139,7 +140,7 @@ var Subscriber = /*#__PURE__*/function () {
         _iterator.f();
       }
 
-      if (all_events.length === 0 || this._append_count > 0) {
+      if (all_events.length === 0 || this._append_count > 0 || this._set_count > 0) {
         var user_identify_event = {
           $insert_id: (0, _utils.uuid)(),
           $time: (0, _utils.epoch_milliseconds)(),
@@ -300,6 +301,7 @@ var Subscriber = /*#__PURE__*/function () {
       if (!(0, _utils.is_empty)(resp["event"])) {
         this._events.push(resp["event"]);
 
+        this._set_count += resp["set"];
         this._append_count += resp["append"];
         this._remove_count += resp["remove"];
         this._unset_count += resp["unset"];
@@ -397,6 +399,15 @@ var Subscriber = /*#__PURE__*/function () {
         this._collect_event();
       }
     }
+  }, {
+    key: "set_preferred_language",
+    value: function set_preferred_language(lang_code) {
+      var caller = "set_preferred_language";
+
+      this._helper._set_preferred_language(lang_code, caller);
+
+      this._collect_event();
+    }
   }, {
     key: "add_email",
     value: function add_email(email) {