emarsys-integration-client-js

Emarsys Integration Client JS is a library providing methods of communication between Emarsys and integrated services running in an iframe.

Requirements

• Node.js >= 16.14.2

Install

npm install emarsys-integration-client --save

Usage

const { integrationClient } = require('emarsys-integration-client');

const result = await itegrationClient.getUrl({ target: 'email_analysis/list' });
const href = result.data.url;

Legacy usage

Earlier versions of this package required you to create an instance with custom config. Most methods now work without this, but if you are using messageToService explicitly, you might still need to instantiate like this:

var IntegrationClient = require('emarsys-integration-client');
var integrationClient = IntegrationClient.init({
  global: window,
  integrationId: 'my-integration',
  integrationInstanceId: 1234567
});

In the code above, integrationId and integrationInstanceId should have the values passed in the iframe URL.

Library methods

alert.error(text: String)

alert.info(text: String)

alert.log(text: String)

alert.success(text: String)

alert.warn(text: String)

Calling the methods above will render different types of Emarsys UI alerts with the text given.

alert.send(options: Object)

It's a lower level method for displaying custom alerts.

Options

Field	Role	Mandatory	Default
text: String	Alert message.	YES
icon: String	Icon class of the icon to be rendered on the left side of the alert. Eg. 'check' for a check mark or 'exclamation-circle' for an exclamation mark in a circle.	NO
className: String	Alert sub-class to use when rendering the alert. Eg. 'e-alert-success' for a green bar, 'e-alert-danger' for a red one.	NO
timeout: Int	Amount of time after the alert will fade out and get removed from the DOM, in milliseconds.	NO	1500

enableButton(selector: String)

This will enable a button selected.

dialog.close()

Closing the dialog and removing it from DOM.

dialog.confirm(options: Object)

Rendering a confirm dialog.

Options

Field	Role	Mandatory	Default
title: String	Title of the confirm dialog.	YES
body: String	Body text of the confirm dialog.	NO
cancel: String	Text of Cancel button.	YES
ok: String	Text of OK button.	YES

dialog.modal(options: Object)

Rendering a modal dialog with it's content in an iframe.

Options

Field	Role	Mandatory	Default
src: String	URL for the iframe providing the modal content.	YES
width: Int	Width of the modal.	NO	650
height: Int	Height of the modal.	NO	500

dialog.submit(success: Boolean, data: Object)

Submitting a dialog.

Options

Field	Role	Mandatory	Default
success: Boolean	True if the result of the dialog is truthy.	YES
data: Object	Arbitrary object to send to the originating service.	NO	{}

getUrl(options: Object)

Returns the url of a preset page. Available targets

Options

Field	Role	Mandatory
target: String	The prespecified target you would like a link to.	YES
params.foo: Object	The general param the actual target needs.	MIXED

navigate(options: Object)

Navigating the browser to a preset page. Available targets

Options

Field	Role	Mandatory
target: String	The prespecified target you would like to head to.	YES
params.foo: Object	The general param the actual target needs.	MIXED

refresh()

Reloading the whole page.

resize(height: Int)

Resizing the iframe.

track(options: Object)

Sending a track message.

unload:init(options: Object)

Setting up click handler for <a> elements, popping a navigation confirm dialog when clicked. It makes sense to call this method right after your content gets dirty.

Options

Field	Role	Mandatory	Default
selector: String	Selector for ancestor elements of <a> elements.	YES
confirm: Object	Options for confirm dialog. See dialog.confirm().	NO	Options for a general unload confirm dialog.

unload:reset(selector: String)

Stopping to watch click events of elements selected by selector. It makes sense to call this method right after your content gets clean (ie. saved).

Contributing

See Contribution guideline.

Code of Conduct

See Code of Conduct here.

Licensing

MIT