@suprsend/node-sdk 1.0.0 → 1.1.0

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/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.0",
   "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/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) {