Skip to content

snowplow-incubator/snowplow-js-analytics-sdk

Repository files navigation

Snowplow JavaScript and TypeScript Analytics SDK

NPM Tests Code Coverage License

This JavaScript SDK provides an ability to work with Snowplow enriched events in your JavaScript or TypeScript event processing, data modeling, and machine-learning jobs. You can also use this SDK with AWS Lambda.

Currently, the JavaScript Analytics SDK provides the JSON Event Transformer only.

You can find more information about Snowplow Analytics SDKs in general on Snowplow Wiki.

Install

npm install --save snowplow-analytics-sdk

Usage

In your app.js:

const { transform } = require('snowplow-analytics-sdk');

module.exports.handler = (input) => {
  let event = transform(
    new Buffer(input.Records[0].kinesis.data, 'base64').toString('utf8'),
  );

  // ...
};

Or in app.ts:

import { transform } from 'snowplow-analytics-sdk';

export function handler(input: any) {
  let event = transform(
    new Buffer(input.Records[0].kinesis.data, 'base64').toString('utf8'),
  );

  // ...
}

API

transform(event: string): Event

  • event: string - TSV string containing event data.

Returns decoded Snowplow enriched event.

Links

Copyright and license

The Snowplow Scala Analytics SDK is copyright 2018-2021 dokmic, Snowplow Analytics Ltd.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.