cpim.js

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:inaki.baz@eface2face.com>
To: Alice <sip:alice@atlanta.com>
Subject: Wines tonight!
DateTime: 2015-06-25T11:30:00-08:00

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

Hi Alice, tonight wines at home

Installation

npm:

$ npm install cpim --save

And then:

var cpim = require('cpim');

Browserified library

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>

Usage Example

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:ibc@aliax.net>',
    to: 'Alice <im:alice@atlanta.com>',
    subject: 'Hi!',
    mime: mime
});

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

From: Iñaki Baz Castillo <im:ibc@aliax.net>
To: Alice <im:alice@atlanta.com>
DateTime: 2015-08-11T12:05:43.569Z

Content-Type: text/html

<h1>Party tonight?</h1>

Documentation

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

Debugging

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*');.

Author

Iñaki Baz Castillo at eFace2Face, inc.

License

MIT :)