JavaScript implementation of CPIM "Common Presence and Instant Messaging" (RFC 3862).

Suitable for parsing and generating CPIM messages, allowing access to CPIM headers and the MIME component (via the mimemessage library) of messages such as:

From: Iñaki Baz Castillo <im:[email protected]>
To: Alice <sip:[email protected]>
Subject: Wines tonight!
DateTime: 2015-06-25T11:30:00-08:00

Content-type: text/plain; charset=utf-8

Hi Alice, tonight wines at home

$ npm install cpim --save

And then:

var cpim = require('cpim');

The browserified version of the library at dist/cpim.js exposes the global window.cpim module.

<script type='text/javascript' src='js/cpim.js'></script>

Let's build a CPIM message to invite Alice to our party.

var cpim = require('cpim');
var message, mime;

mime = cpim.mimemessage.factory({
    contentType: 'text/html',
    body: '<h1>Party tonight?</h1>'
});

message = cpim.factory({
    from: 'Iñaki Baz Castillo <im:[email protected]>',
    to: 'Alice <im:[email protected]>',
    subject: 'Hi!',
    mime: mime
});

By calling message.toString() it produces the following CPIM formatted string:

From: Iñaki Baz Castillo <im:[email protected]>
To: Alice <im:[email protected]>
DateTime: 2015-08-11T12:05:43.569Z

Content-Type: text/html

<h1>Party tonight?</h1>

You can read the full API documentation in the docs folder.

The library includes the Node debug module. In order to enable debugging:

In Node set the DEBUG=cpim* environment variable before running the application, or set it at the top of the script:

process.env.DEBUG = 'cpim*';

You may prefer to also enable MIME debug:

process.env.DEBUG = 'cpim* mimemessage*';

In the browser run cpim.debug.enable('cpim*'); and reload the page. Note that the debugging settings are stored into the browser LocalStorage. To disable it run cpim.debug.disable('cpim*');.

Iñaki Baz Castillo at eFace2Face, inc.

MIT :)