varsnap/README.md

varsnap.js
==========

[![Codeship Status for albertyw/varsnap.js](https://app.codeship.com/projects/772d6dd0-7616-0137-b181-4a74f06c083c/status?branch=master)](https://app.codeship.com/projects/349777)

[Javascript Varsnap Client](https://www.varsnap.com/).  For use in both browser and node.js

Installation
------------

Install from NPM - `npm install --save varsnap`

Configuration
-------------

The varsnap decorator needs to be configured with a `config` object with these variables:

 - `varsnap` - Should be either `true` or `false`.  Varsnap will be disabled if the variable is anything other than `true`.
 - `env` - If set to `development`, the client will receive events from production.  If set to `production`, the client will emit events.
 - `producerToken` - Only clients with this token may emit production snapshots.  Copied from https://www.varsnap.com/user/
 - `consumerToken` - Only clients with this token may emit development snapshots.  Copied from https://www.varsnap.com/user/

If you're deploying varsnap to a browser, note that Varsnap needs unmangled code in production to work correctly.

Usage
-----

Wrap your functions with the varsnap decorator for any function you'd like to make better:

```javascript
// Node.js
var varsnap = require('varsnap');

// Browser
var varsnap = window.varsnap;

// Configuration
varsnap.updateConfig({
  varsnap: true,
  env: 'production',
  producerToken: 'producer-abcd'
});

// Integration
function example(x, y, z) {
  // ...
}
example = varsnap(example);

example(1, 2, 3);
```

See `example/example.js` for example usage.

Typescript
----------
If you are using typescript, make sure your `tsconfig.json` has a `"target"` to `"es2015"`, `"es6"`, or later.
This is needed to persist function names after compiling to javascript.
See https://github.com/microsoft/TypeScript/issues/5611 for details.

Testing
-------

Use the `varsnap.runTests()` function.

```javascript
function test() {
  const status = varsnap.runTests().then(function(status) => {
    console.assert(status);
  });;
}
```

If you are using [mocha](https://mochajs.org/) and [chai](https://www.chaijs.com/),
you can include this test script:

```javascript
const expect = require('chai').expect;
const varsnap = require('varsnap');

// Load the modules where varsnap is being used
require('./example');

context('Varsnap', function() {
  this.timeout(30 * 1000);
  it('runs with production', function() {
    return varsnap.runTests().then(status => {
      expect(status).to.be.true;
    });
  });
});
```

See `example/test.js` for example usage.

Release
-------

1.  Update Changelog with new version
2.  Update `const version` in `varsnap/core.ts`
3.  Update package.json version and run `npm install`
4.  Update `.uglify.json` and `.uglify.min.json`
5.  Run `npm run package`
6.  Git commit and tag
7.  `npm publish`
8.  Upload `dist/*` to https://github.com/albertyw/varsnap.js/releases