@suprsend/node-sdk 1.0.0 → 1.1.1

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/attachment.js

@@ -5,7 +5,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports["default"] = get_attachment_json_for_file;
+exports["default"] = get_attachment_json;
 
 var _path = _interopRequireDefault(require("path"));
 
@@ -13,14 +13,47 @@ var _mimeTypes = _interopRequireDefault(require("mime-types"));
 
 var _utils = require("./utils");
 
-function get_attachment_json_for_file(file_path) {
+function check_is_web_url() {
+  var file_path = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : "";
+  return file_path.startsWith("http://") || file_path.startsWith("https://");
+}
+
+function get_attachment_json_for_file(file_path, file_name, ignore_if_error) {
   var abs_path = _path["default"].resolve((0, _utils.resolveTilde)(file_path));
 
+  var final_file_name = _path["default"].basename(abs_path);
+
+  if (file_name && file_name.trim()) {
+    final_file_name = file_name.trim();
+  }
+
   return {
-    filename: _path["default"].basename(abs_path),
+    filename: final_file_name,
     contentType: _mimeTypes["default"].lookup(abs_path),
-    data: (0, _utils.base64Encode)(abs_path)
+    data: (0, _utils.base64Encode)(abs_path),
+    url: null,
+    ignore_if_error: ignore_if_error
   };
 }
 
+function get_attachment_json_for_url(file_url, file_name, ignore_if_error) {
+  return {
+    filename: file_name,
+    contentType: null,
+    data: null,
+    url: file_url,
+    ignore_if_error: ignore_if_error
+  };
+}
+
+function get_attachment_json(file_path, file_name) {
+  var ignore_if_error = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+
+  if (check_is_web_url(file_path)) {
+    return get_attachment_json_for_url(file_path, file_name, ignore_if_error);
+  } else {
+    return get_attachment_json_for_file(file_path, file_name, ignore_if_error);
+  }
+}
+
 module.exports = exports.default;

package/dist/constants.js

@@ -3,13 +3,19 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.WORKFLOW_RUNTIME_KEYS_POTENTIAL_SIZE_IN_BYTES = exports.MAX_WORKFLOWS_IN_BULK_API = exports.MAX_IDENTITY_EVENTS_IN_BULK_API = exports.MAX_EVENTS_IN_BULK_API = exports.IDENTITY_SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE = exports.IDENTITY_SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES = exports.DEFAULT_URL = exports.DEFAULT_UAT_URL = exports.BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE = exports.BODY_MAX_APPARENT_SIZE_IN_BYTES = exports.ATTACHMENT_URL_POTENTIAL_SIZE_IN_BYTES = exports.ATTACHMENT_UPLOAD_ENABLED = exports.ALLOW_ATTACHMENTS_IN_BULK_API = void 0;
+exports.WORKFLOW_RUNTIME_KEYS_POTENTIAL_SIZE_IN_BYTES = exports.SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE = exports.SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES = exports.MAX_WORKFLOWS_IN_BULK_API = exports.MAX_IDENTITY_EVENTS_IN_BULK_API = exports.MAX_EVENTS_IN_BULK_API = exports.IDENTITY_SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE = exports.IDENTITY_SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES = exports.DEFAULT_URL = exports.DEFAULT_UAT_URL = exports.BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE = exports.BODY_MAX_APPARENT_SIZE_IN_BYTES = exports.ATTACHMENT_URL_POTENTIAL_SIZE_IN_BYTES = exports.ATTACHMENT_UPLOAD_ENABLED = exports.ALLOW_ATTACHMENTS_IN_BULK_API = void 0;
 //  Default urls
 var DEFAULT_URL = "https://hub.suprsend.com/";
 exports.DEFAULT_URL = DEFAULT_URL;
-var DEFAULT_UAT_URL = "https://collector-staging.suprsend.workers.dev/"; // a API call should not have apparent body size of more than 800KB
+var DEFAULT_UAT_URL = "https://collector-staging.suprsend.workers.dev/"; //  an Event should not have apparent body size of more than 100KB
 
 exports.DEFAULT_UAT_URL = DEFAULT_UAT_URL;
+var SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES = 100 * 1024; // 100 * 1024
+
+exports.SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES = SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES;
+var SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE = "100KB"; // a API call should not have apparent body size of more than 800KB
+
+exports.SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE = SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE;
 var BODY_MAX_APPARENT_SIZE_IN_BYTES = 800 * 1024; // 800 * 1024
 
 exports.BODY_MAX_APPARENT_SIZE_IN_BYTES = BODY_MAX_APPARENT_SIZE_IN_BYTES;
@@ -27,7 +33,7 @@ var MAX_WORKFLOWS_IN_BULK_API = 100; // max event-records in one bulk api call
 exports.MAX_WORKFLOWS_IN_BULK_API = MAX_WORKFLOWS_IN_BULK_API;
 var MAX_EVENTS_IN_BULK_API = 100;
 exports.MAX_EVENTS_IN_BULK_API = MAX_EVENTS_IN_BULK_API;
-var ALLOW_ATTACHMENTS_IN_BULK_API = false;
+var ALLOW_ATTACHMENTS_IN_BULK_API = true;
 exports.ALLOW_ATTACHMENTS_IN_BULK_API = ALLOW_ATTACHMENTS_IN_BULK_API;
 var ATTACHMENT_UPLOAD_ENABLED = false; // -- single Identity event limit
 

package/dist/event.js

@@ -36,12 +36,13 @@ function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { va
 var RESERVED_EVENT_NAMES = ["$identify", "$notification_delivered", "$notification_dismiss", "$notification_clicked", "$app_launched", "$user_login", "$user_logout"];
 
 var Event = /*#__PURE__*/function () {
-  function Event(distinct_id, event_name, properties, idempotency_key) {
+  function Event(distinct_id, event_name, properties) {
+    var kwargs = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
     (0, _classCallCheck2["default"])(this, Event);
     this.distinct_id = distinct_id;
     this.event_name = event_name;
     this.properties = properties;
-    this.idempotency_key = idempotency_key; // --- validate
+    this.idempotency_key = kwargs === null || kwargs === void 0 ? void 0 : kwargs.idempotency_key; // --- validate
 
     this.__validate_distinct_id();
 
@@ -101,7 +102,12 @@ var Event = /*#__PURE__*/function () {
   }, {
     key: "add_attachment",
     value: function add_attachment(file_path) {
-      var attachment = (0, _attachment["default"])(file_path); // --- add the attachment to properties->$attachments
+      var _kwargs$ignore_if_err;
+
+      var kwargs = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+      var file_name = kwargs === null || kwargs === void 0 ? void 0 : kwargs.file_name;
+      var ignore_if_error = (_kwargs$ignore_if_err = kwargs === null || kwargs === void 0 ? void 0 : kwargs.ignore_if_error) !== null && _kwargs$ignore_if_err !== void 0 ? _kwargs$ignore_if_err : false;
+      var attachment = (0, _attachment["default"])(file_path, file_name, ignore_if_error); // --- add the attachment to properties->$attachments
 
       if (!this.properties["$attachments"]) {
         this.properties["$attachments"] = [];
@@ -132,8 +138,8 @@ var Event = /*#__PURE__*/function () {
       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);
 
-      if (apparent_size > _constants.BODY_MAX_APPARENT_SIZE_IN_BYTES) {
-        throw new _utils.SuprsendError("Event properties too big - ".concat(apparent_size, " Bytes,must not cross ").concat(_constants.BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE));
+      if (apparent_size > _constants.SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES) {
+        throw new _utils.SuprsendError("Event size too big - ".concat(apparent_size, " Bytes,must not cross ").concat(_constants.SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE));
       }
 
       return [event_dict, apparent_size];

package/dist/events_bulk.js

@@ -133,8 +133,8 @@ var _BulkEventsChunk = /*#__PURE__*/function () {
         return false;
       }
 
-      if (event_size > _constants.BODY_MAX_APPARENT_SIZE_IN_BYTES) {
-        throw new _utils.SuprsendError("workflow body (discounting attachment if any) too big - ".concat(event_size, " Bytes, must not cross ").concat(_constants.BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE));
+      if (event_size > _constants.SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES) {
+        throw new _utils.SuprsendError("Event properties too big - ".concat(event_size, " Bytes, must not cross ").concat(_constants.SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE));
       }
 
       if (this.__running_size + event_size > _constants.BODY_MAX_APPARENT_SIZE_IN_BYTES) {

package/dist/index.js

@@ -127,6 +127,12 @@ var Suprsend = /*#__PURE__*/function () {
   }, {
     key: "add_attachment",
     value: function add_attachment(body, file_path) {
+      var _kwargs$ignore_if_err;
+
+      var kwargs = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+      var file_name = kwargs === null || kwargs === void 0 ? void 0 : kwargs.file_name;
+      var ignore_if_error = (_kwargs$ignore_if_err = kwargs === null || kwargs === void 0 ? void 0 : kwargs.ignore_if_error) !== null && _kwargs$ignore_if_err !== void 0 ? _kwargs$ignore_if_err : false;
+
       if (!body.data) {
         body.data = {};
       }
@@ -135,7 +141,7 @@ var Suprsend = /*#__PURE__*/function () {
         throw new _utils.SuprsendError("data must be an object");
       }
 
-      var attachment = (0, _attachment["default"])(file_path);
+      var attachment = (0, _attachment["default"])(file_path, file_name, ignore_if_error);
 
       if (!body.data["$attachments"]) {
         body["data"]["$attachments"] = [];
@@ -161,8 +167,8 @@ var Suprsend = /*#__PURE__*/function () {
     key: "track",
     value: function track(distinct_id, event_name) {
       var properties = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
-      var idempotency_key = arguments.length > 3 ? arguments[3] : undefined;
-      var event = new _event["default"](distinct_id, event_name, properties, idempotency_key);
+      var kwargs = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
+      var event = new _event["default"](distinct_id, event_name, properties, kwargs);
       return this._eventcollector.collect(event);
     }
   }, {

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/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) {

package/dist/subscriber_helper.js

@@ -15,6 +15,8 @@ var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/creat
 
 var _utils = require("./utils");
 
+var _language_codes = _interopRequireDefault(require("./language_codes"));
+
 // ---------- Identity keys
 var IDENT_KEY_EMAIL = "$email";
 var IDENT_KEY_SMS = "$sms";
@@ -25,7 +27,8 @@ var IDENT_KEY_WEBPUSH = "$webpush";
 var IDENT_KEY_SLACK = "$slack";
 var IDENT_KEYS_ALL = [IDENT_KEY_EMAIL, IDENT_KEY_SMS, IDENT_KEY_ANDROIDPUSH, IDENT_KEY_IOSPUSH, IDENT_KEY_WHATSAPP, IDENT_KEY_WEBPUSH, IDENT_KEY_SLACK];
 var KEY_PUSHVENDOR = "$pushvendor";
-var OTHER_RESERVED_KEYS = ["$messenger", "$inbox", KEY_PUSHVENDOR, "$device_id", "$insert_id", "$time", "$set", "$set_once", "$add", "$append", "$remove", "$unset", "$identify", "$anon_id", "$identified_id", "$notification_delivered", "$notification_dismiss", "$notification_clicked"];
+var KEY_PREFERRED_LANGUAGE = "$preferred_language";
+var OTHER_RESERVED_KEYS = ["$messenger", "$inbox", KEY_PUSHVENDOR, "$device_id", "$insert_id", "$time", "$set", "$set_once", "$add", "$append", "$remove", "$unset", "$identify", "$anon_id", "$identified_id", KEY_PREFERRED_LANGUAGE, "$notification_delivered", "$notification_dismiss", "$notification_clicked"];
 var SUPER_PROPERTY_KEYS = ["$app_version_string", "$app_build_number", "$brand", "$carrier", "$manufacturer", "$model", "$os", "$ss_sdk_version", "$insert_id", "$time"];
 var ALL_RESERVED_KEYS = [].concat(SUPER_PROPERTY_KEYS, OTHER_RESERVED_KEYS, IDENT_KEYS_ALL);
 var EMAIL_REGEX = /\S+@\S+\.\S+/;
@@ -36,6 +39,8 @@ var _SubscriberInternalHelper = /*#__PURE__*/function () {
     (0, _classCallCheck2["default"])(this, _SubscriberInternalHelper);
     this.distinct_id = distinct_id;
     this.workspace_key = workspace_key;
+    this.__dict_set = {};
+    this.__set_count = 0;
     this.__dict_append = {};
     this.__append_count = 0;
     this.__dict_remove = {};
@@ -49,6 +54,8 @@ var _SubscriberInternalHelper = /*#__PURE__*/function () {
   (0, _createClass2["default"])(_SubscriberInternalHelper, [{
     key: "reset",
     value: function reset() {
+      this.__dict_set = {};
+      this.__set_count = 0;
       this.__dict_append = {};
       this.__append_count = 0;
       this.__dict_remove = {};
@@ -67,6 +74,7 @@ var _SubscriberInternalHelper = /*#__PURE__*/function () {
         errors: this.__errors,
         info: this.__info,
         event: evt,
+        set: this.__set_count,
         append: this.__append_count,
         remove: this.__remove_count,
         unset: this.__unset_count
@@ -77,7 +85,7 @@ var _SubscriberInternalHelper = /*#__PURE__*/function () {
   }, {
     key: "__form_event",
     value: function __form_event() {
-      if (!(0, _utils.is_empty)(this.__dict_append) || !(0, _utils.is_empty)(this.__dict_remove) || !(0, _utils.is_empty)(this.__list_unset)) {
+      if (!(0, _utils.is_empty)(this.__dict_set) || !(0, _utils.is_empty)(this.__dict_append) || !(0, _utils.is_empty)(this.__dict_remove) || !(0, _utils.is_empty)(this.__list_unset)) {
         var event = {
           $insert_id: (0, _utils.uuid)(),
           $time: (0, _utils.epoch_milliseconds)(),
@@ -85,6 +93,11 @@ var _SubscriberInternalHelper = /*#__PURE__*/function () {
           distinct_id: this.distinct_id
         };
 
+        if (!(0, _utils.is_empty)(this.__dict_set)) {
+          event["$set"] = this.__dict_set;
+          this.__set_count += 1;
+        }
+
         if (!(0, _utils.is_empty)(this.__dict_append)) {
           event["$append"] = this.__dict_append;
           this.__append_count += 1;
@@ -208,6 +221,17 @@ var _SubscriberInternalHelper = /*#__PURE__*/function () {
 
       this.__list_unset.push(validated_key);
     }
+  }, {
+    key: "_set_preferred_language",
+    value: function _set_preferred_language(lang_code, caller) {
+      if (!_language_codes["default"].includes(lang_code)) {
+        this.__info.push("[".concat(caller, "] invalid value ").concat(lang_code));
+
+        return;
+      }
+
+      this.__dict_set[KEY_PREFERRED_LANGUAGE] = lang_code;
+    }
   }, {
     key: "__add_identity",
     value: function __add_identity(key, value, args, caller) {

package/dist/subscribers_bulk.js

@@ -133,8 +133,8 @@ var _BulkSubscribersChunk = /*#__PURE__*/function () {
         return false;
       }
 
-      if (event_size > _constants.BODY_MAX_APPARENT_SIZE_IN_BYTES) {
-        throw new SuprsendError("workflow body (discounting attachment if any) too big - ".concat(event_size, " Bytes, must not cross ").concat(_constants.BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE));
+      if (event_size > _constants.IDENTITY_SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES) {
+        throw new SuprsendError("Event too big - ".concat(event_size, " Bytes, must not cross ").concat(_constants.IDENTITY_SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE));
       }
 
       if (this.__running_size + event_size > _constants.BODY_MAX_APPARENT_SIZE_IN_BYTES) {

package/dist/workflow.js

@@ -28,7 +28,8 @@ var _attachment = _interopRequireDefault(require("./attachment"));
 var _constants = require("./constants");
 
 var Workflow = /*#__PURE__*/function () {
-  function Workflow(body, idempotency_key) {
+  function Workflow(body) {
+    var kwargs = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
     (0, _classCallCheck2["default"])(this, Workflow);
 
     if (!(body instanceof Object)) {
@@ -36,13 +37,18 @@ var Workflow = /*#__PURE__*/function () {
     }
 
     this.body = body;
-    this.idempotency_key = idempotency_key;
+    this.idempotency_key = kwargs === null || kwargs === void 0 ? void 0 : kwargs.idempotency_key;
   }
 
   (0, _createClass2["default"])(Workflow, [{
     key: "add_attachment",
     value: function add_attachment() {
+      var _kwargs$ignore_if_err;
+
       var file_path = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : "";
+      var kwargs = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+      var file_name = kwargs === null || kwargs === void 0 ? void 0 : kwargs.file_name;
+      var ignore_if_error = (_kwargs$ignore_if_err = kwargs === null || kwargs === void 0 ? void 0 : kwargs.ignore_if_error) !== null && _kwargs$ignore_if_err !== void 0 ? _kwargs$ignore_if_err : false;
 
       if (!this.body.data) {
         this.body.data = {};
@@ -52,7 +58,7 @@ var Workflow = /*#__PURE__*/function () {
         throw new _utils.SuprsendError("data must be a dictionary");
       }
 
-      var attachment = (0, _attachment["default"])(file_path);
+      var attachment = (0, _attachment["default"])(file_path, file_name, ignore_if_error);
 
       if (!this.body.data["$attachments"]) {
         this.body["data"]["$attachments"] = [];
@@ -73,8 +79,8 @@ var Workflow = /*#__PURE__*/function () {
       this.body = (0, _utils.validate_workflow_body_schema)(this.body);
       var apparent_size = (0, _utils.get_apparent_workflow_body_size)(this.body, is_part_of_bulk); // review
 
-      if (apparent_size > _constants.BODY_MAX_APPARENT_SIZE_IN_BYTES) {
-        throw new _utils.SuprsendError("workflow body (discounting attachment if any) too big - ".concat(apparent_size, " Bytes, must not cross ").concat(_constants.BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE));
+      if (apparent_size > _constants.SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES) {
+        throw new _utils.SuprsendError("workflow body too big - ".concat(apparent_size, " Bytes, must not cross ").concat(_constants.SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE));
       }
 
       return [this.body, apparent_size];

package/dist/workflows_bulk.js

@@ -133,8 +133,8 @@ var _BulkWorkflowsChunk = /*#__PURE__*/function () {
         return false;
       }
 
-      if (body_size > _constants.BODY_MAX_APPARENT_SIZE_IN_BYTES) {
-        throw new _utils.SuprsendError("workflow body (discounting attachment if any) too big - ".concat(body_size, " Bytes, must not cross ").concat(_constants.BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE));
+      if (body_size > _constants.SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES) {
+        throw new _utils.SuprsendError("workflow body too big - ".concat(body_size, " Bytes, must not cross ").concat(_constants.SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE));
       }
 
       if (this.__running_size + body_size > _constants.BODY_MAX_APPARENT_SIZE_IN_BYTES) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suprsend/node-sdk",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Suprsend Node SDK to trigger workflow from backend",
   "main": "dist/index.js",
   "scripts": {

package/src/attachment.js

@@ -2,11 +2,43 @@ import path from "path";
 import mime from "mime-types";
 import { base64Encode, resolveTilde } from "./utils";
 
-export default function get_attachment_json_for_file(file_path) {
+function check_is_web_url(file_path = "") {
+  return file_path.startsWith("http://") || file_path.startsWith("https://");
+}
+
+function get_attachment_json_for_file(file_path, file_name, ignore_if_error) {
   const abs_path = path.resolve(resolveTilde(file_path));
+  let final_file_name = path.basename(abs_path);
+  if (file_name && file_name.trim()) {
+    final_file_name = file_name.trim();
+  }
   return {
-    filename: path.basename(abs_path),
+    filename: final_file_name,
     contentType: mime.lookup(abs_path),
     data: base64Encode(abs_path),
+    url: null,
+    ignore_if_error: ignore_if_error,
+  };
+}
+
+function get_attachment_json_for_url(file_url, file_name, ignore_if_error) {
+  return {
+    filename: file_name,
+    contentType: null,
+    data: null,
+    url: file_url,
+    ignore_if_error: ignore_if_error,
   };
 }
+
+export default function get_attachment_json(
+  file_path,
+  file_name,
+  ignore_if_error = false
+) {
+  if (check_is_web_url(file_path)) {
+    return get_attachment_json_for_url(file_path, file_name, ignore_if_error);
+  } else {
+    return get_attachment_json_for_file(file_path, file_name, ignore_if_error);
+  }
+}

package/src/constants.js

@@ -3,6 +3,10 @@ export const DEFAULT_URL = "https://hub.suprsend.com/";
 export const DEFAULT_UAT_URL =
   "https://collector-staging.suprsend.workers.dev/";
 
+//  an Event should not have apparent body size of more than 100KB
+export const SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES = 100 * 1024; // 100 * 1024
+export const SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE = "100KB";
+
 // a API call should not have apparent body size of more than 800KB
 export const BODY_MAX_APPARENT_SIZE_IN_BYTES = 800 * 1024; // 800 * 1024
 export const BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE = "800KB";
@@ -18,7 +22,7 @@ export const MAX_WORKFLOWS_IN_BULK_API = 100;
 // max event-records in one bulk api call
 export const MAX_EVENTS_IN_BULK_API = 100;
 
-export const ALLOW_ATTACHMENTS_IN_BULK_API = false;
+export const ALLOW_ATTACHMENTS_IN_BULK_API = true;
 export const ATTACHMENT_UPLOAD_ENABLED = false;
 
 // -- single Identity event limit

package/src/event.js

@@ -10,10 +10,10 @@ import {
 } from "./utils";
 import get_request_signature from "./signature";
 import axios from "axios";
-import get_attachment_json_for_file from "./attachment";
+import get_attachment_json from "./attachment";
 import {
-  BODY_MAX_APPARENT_SIZE_IN_BYTES,
-  BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE,
+  SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES,
+  SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE,
 } from "./constants";
 
 const RESERVED_EVENT_NAMES = [
@@ -27,11 +27,11 @@ const RESERVED_EVENT_NAMES = [
 ];
 
 export default class Event {
-  constructor(distinct_id, event_name, properties, idempotency_key) {
+  constructor(distinct_id, event_name, properties, kwargs = {}) {
     this.distinct_id = distinct_id;
     this.event_name = event_name;
     this.properties = properties;
-    this.idempotency_key = idempotency_key;
+    this.idempotency_key = kwargs?.idempotency_key;
     // --- validate
     this.__validate_distinct_id();
     this.__validate_event_name();
@@ -79,8 +79,14 @@ export default class Event {
     this.event_name = event_name;
   }
 
-  add_attachment(file_path) {
-    const attachment = get_attachment_json_for_file(file_path);
+  add_attachment(file_path, kwargs = {}) {
+    const file_name = kwargs?.file_name;
+    const ignore_if_error = kwargs?.ignore_if_error ?? false;
+    const attachment = get_attachment_json(
+      file_path,
+      file_name,
+      ignore_if_error
+    );
     // --- add the attachment to properties->$attachments
     if (!this.properties["$attachments"]) {
       this.properties["$attachments"] = [];
@@ -103,9 +109,9 @@ export default class Event {
     }
     event_dict = validate_track_event_schema(event_dict);
     const apparent_size = get_apparent_event_size(event_dict, is_part_of_bulk);
-    if (apparent_size > BODY_MAX_APPARENT_SIZE_IN_BYTES) {
+    if (apparent_size > SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES) {
       throw new SuprsendError(
-        `Event properties too big - ${apparent_size} Bytes,must not cross ${BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE}`
+        `Event size too big - ${apparent_size} Bytes,must not cross ${SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE}`
       );
     }
     return [event_dict, apparent_size];

package/src/events_bulk.js

@@ -1,4 +1,6 @@
 import {
+  SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES,
+  SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE,
   ALLOW_ATTACHMENTS_IN_BULK_API,
   BODY_MAX_APPARENT_SIZE_IN_BYTES,
   BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE,
@@ -84,9 +86,9 @@ class _BulkEventsChunk {
     if (this.__check_limit_reached()) {
       return false;
     }
-    if (event_size > BODY_MAX_APPARENT_SIZE_IN_BYTES) {
+    if (event_size > SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES) {
       throw new SuprsendError(
-        `workflow body (discounting attachment if any) too big - ${event_size} Bytes, must not cross ${BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE}`
+        `Event properties too big - ${event_size} Bytes, must not cross ${SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE}`
       );
     }
     if (this.__running_size + event_size > BODY_MAX_APPARENT_SIZE_IN_BYTES) {

package/src/index.js

@@ -1,5 +1,5 @@
 import { SuprsendError, SuprsendConfigError } from "./utils";
-import get_attachment_json_for_file from "./attachment";
+import get_attachment_json from "./attachment";
 import Workflow, { _WorkflowTrigger } from "./workflow";
 import { BulkWorkflowsFactory } from "./workflows_bulk";
 import Event, { EventCollector } from "./event";
@@ -78,14 +78,20 @@ class Suprsend {
     return base_url;
   }
 
-  add_attachment(body, file_path) {
+  add_attachment(body, file_path, kwargs = {}) {
+    const file_name = kwargs?.file_name;
+    const ignore_if_error = kwargs?.ignore_if_error ?? false;
     if (!body.data) {
       body.data = {};
     }
     if (!body.data instanceof Object) {
       throw new SuprsendError("data must be an object");
     }
-    const attachment = get_attachment_json_for_file(file_path);
+    const attachment = get_attachment_json(
+      file_path,
+      file_name,
+      ignore_if_error
+    );
     if (!body.data["$attachments"]) {
       body["data"]["$attachments"] = [];
     }
@@ -103,13 +109,8 @@ class Suprsend {
     return this._workflow_trigger.trigger(wf_ins);
   }
 
-  track(distinct_id, event_name, properties = {}, idempotency_key) {
-    const event = new Event(
-      distinct_id,
-      event_name,
-      properties,
-      idempotency_key
-    );
+  track(distinct_id, event_name, properties = {}, kwargs = {}) {
+    const event = new Event(distinct_id, event_name, properties, kwargs);
     return this._eventcollector.collect(event);
   }
 

package/src/language_codes.js

@@ -0,0 +1,188 @@
+const 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",
+};
+
+const ALL_LANG_CODES = [...new Set(Object.keys(LANG_CODE_NAME_MAPPING))];
+export default ALL_LANG_CODES;

package/src/subscriber.js

@@ -50,6 +50,7 @@ export class Subscriber {
     this.__info = [];
     this._append_count = 0;
     this._remove_count = 0;
+    this._set_count = 0;
     this._unset_count = 0;
     this._events = [];
     this._helper = new _SubscriberInternalHelper(
@@ -90,7 +91,11 @@ export class Subscriber {
       e["properties"] = this.__supr_props;
     }
 
-    if (all_events.length === 0 || this._append_count > 0) {
+    if (
+      all_events.length === 0 ||
+      this._append_count > 0 ||
+      this._set_count > 0
+    ) {
       const user_identify_event = {
         $insert_id: uuid(),
         $time: epoch_milliseconds(),
@@ -196,6 +201,7 @@ export class Subscriber {
     }
     if (!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"];
@@ -267,6 +273,12 @@ export class Subscriber {
     }
   }
 
+  set_preferred_language(lang_code) {
+    const caller = "set_preferred_language";
+    this._helper._set_preferred_language(lang_code, caller);
+    this._collect_event();
+  }
+
   add_email(email) {
     const caller = "add_email";
     this._helper._add_email(email, caller);

package/src/subscriber_helper.js

@@ -6,6 +6,7 @@ import {
   is_empty,
   is_string,
 } from "./utils";
+import ALL_LANG_CODES from "./language_codes";
 
 // ---------- Identity keys
 const IDENT_KEY_EMAIL = "$email";
@@ -27,6 +28,7 @@ const IDENT_KEYS_ALL = [
 ];
 
 const KEY_PUSHVENDOR = "$pushvendor";
+const KEY_PREFERRED_LANGUAGE = "$preferred_language";
 
 const OTHER_RESERVED_KEYS = [
   "$messenger",
@@ -44,6 +46,7 @@ const OTHER_RESERVED_KEYS = [
   "$identify",
   "$anon_id",
   "$identified_id",
+  KEY_PREFERRED_LANGUAGE,
   "$notification_delivered",
   "$notification_dismiss",
   "$notification_clicked",
@@ -76,6 +79,9 @@ export default class _SubscriberInternalHelper {
     this.distinct_id = distinct_id;
     this.workspace_key = workspace_key;
 
+    this.__dict_set = {};
+    this.__set_count = 0;
+
     this.__dict_append = {};
     this.__append_count = 0;
 
@@ -90,6 +96,9 @@ export default class _SubscriberInternalHelper {
   }
 
   reset() {
+    this.__dict_set = {};
+    this.__set_count = 0;
+
     this.__dict_append = {};
     this.__append_count = 0;
 
@@ -109,6 +118,7 @@ export default class _SubscriberInternalHelper {
       errors: this.__errors,
       info: this.__info,
       event: evt,
+      set: this.__set_count,
       append: this.__append_count,
       remove: this.__remove_count,
       unset: this.__unset_count,
@@ -119,6 +129,7 @@ export default class _SubscriberInternalHelper {
 
   __form_event() {
     if (
+      !is_empty(this.__dict_set) ||
       !is_empty(this.__dict_append) ||
       !is_empty(this.__dict_remove) ||
       !is_empty(this.__list_unset)
@@ -129,6 +140,10 @@ export default class _SubscriberInternalHelper {
         env: this.workspace_key,
         distinct_id: this.distinct_id,
       };
+      if (!is_empty(this.__dict_set)) {
+        event["$set"] = this.__dict_set;
+        this.__set_count += 1;
+      }
       if (!is_empty(this.__dict_append)) {
         event["$append"] = this.__dict_append;
         this.__append_count += 1;
@@ -216,6 +231,14 @@ export default class _SubscriberInternalHelper {
     this.__list_unset.push(validated_key);
   }
 
+  _set_preferred_language(lang_code, caller) {
+    if (!ALL_LANG_CODES.includes(lang_code)) {
+      this.__info.push(`[${caller}] invalid value ${lang_code}`);
+      return;
+    }
+    this.__dict_set[KEY_PREFERRED_LANGUAGE] = lang_code;
+  }
+
   __add_identity(key, value, args, caller) {
     switch (key) {
       case IDENT_KEY_EMAIL:

package/src/subscribers_bulk.js

@@ -1,4 +1,6 @@
 import {
+  IDENTITY_SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES,
+  IDENTITY_SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE,
   BODY_MAX_APPARENT_SIZE_IN_BYTES,
   BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE,
   MAX_IDENTITY_EVENTS_IN_BULK_API,
@@ -82,9 +84,9 @@ class _BulkSubscribersChunk {
     if (this.__check_limit_reached()) {
       return false;
     }
-    if (event_size > BODY_MAX_APPARENT_SIZE_IN_BYTES) {
+    if (event_size > IDENTITY_SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES) {
       throw new SuprsendError(
-        `workflow body (discounting attachment if any) too big - ${event_size} Bytes, must not cross ${BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE}`
+        `Event too big - ${event_size} Bytes, must not cross ${IDENTITY_SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE}`
       );
     }
     if (this.__running_size + event_size > BODY_MAX_APPARENT_SIZE_IN_BYTES) {

package/src/workflow.js

@@ -5,29 +5,35 @@ import {
   validate_workflow_body_schema,
   get_apparent_workflow_body_size,
 } from "./utils";
-import get_attachment_json_for_file from "./attachment";
+import get_attachment_json from "./attachment";
 import {
-  BODY_MAX_APPARENT_SIZE_IN_BYTES,
-  BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE,
+  SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES,
+  SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE,
 } from "./constants";
 
 export default class Workflow {
-  constructor(body, idempotency_key) {
+  constructor(body, kwargs = {}) {
     if (!(body instanceof Object)) {
       throw new SuprsendError("workflow body must be a json/dictionary");
     }
     this.body = body;
-    this.idempotency_key = idempotency_key;
+    this.idempotency_key = kwargs?.idempotency_key;
   }
 
-  add_attachment(file_path = "") {
+  add_attachment(file_path = "", kwargs = {}) {
+    const file_name = kwargs?.file_name;
+    const ignore_if_error = kwargs?.ignore_if_error ?? false;
     if (!this.body.data) {
       this.body.data = {};
     }
     if (!(this.body instanceof Object)) {
       throw new SuprsendError("data must be a dictionary");
     }
-    const attachment = get_attachment_json_for_file(file_path);
+    const attachment = get_attachment_json(
+      file_path,
+      file_name,
+      ignore_if_error
+    );
 
     if (!this.body.data["$attachments"]) {
       this.body["data"]["$attachments"] = [];
@@ -45,9 +51,9 @@ export default class Workflow {
       this.body,
       is_part_of_bulk
     ); // review
-    if (apparent_size > BODY_MAX_APPARENT_SIZE_IN_BYTES) {
+    if (apparent_size > SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES) {
       throw new SuprsendError(
-        `workflow body (discounting attachment if any) too big - ${apparent_size} Bytes, must not cross ${BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE}`
+        `workflow body too big - ${apparent_size} Bytes, must not cross ${SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE}`
       );
     }
     return [this.body, apparent_size];

package/src/workflows_bulk.js

@@ -1,4 +1,6 @@
 import {
+  SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES,
+  SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE,
   BODY_MAX_APPARENT_SIZE_IN_BYTES,
   BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE,
   MAX_WORKFLOWS_IN_BULK_API,
@@ -84,9 +86,9 @@ class _BulkWorkflowsChunk {
     if (this.__check_limit_reached()) {
       return false;
     }
-    if (body_size > BODY_MAX_APPARENT_SIZE_IN_BYTES) {
+    if (body_size > SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES) {
       throw new SuprsendError(
-        `workflow body (discounting attachment if any) too big - ${body_size} Bytes, must not cross ${BODY_MAX_APPARENT_SIZE_IN_BYTES_READABLE}`
+        `workflow body too big - ${body_size} Bytes, must not cross ${SINGLE_EVENT_MAX_APPARENT_SIZE_IN_BYTES_READABLE}`
       );
     }
     if (this.__running_size + body_size > BODY_MAX_APPARENT_SIZE_IN_BYTES) {