posthog-node

What is posthog-node?

The posthog-node package is a Node.js library for interacting with PostHog, an open-source product analytics platform. It allows you to track events, identify users, and manage feature flags programmatically from your Node.js applications.

What are posthog-node's main functionalities?

Track Events

This feature allows you to track events that occur in your application. The `capture` method is used to log an event with a distinct user ID and any relevant properties.

const { PostHog } = require('posthog-node');
const client = new PostHog('YOUR_API_KEY');

client.capture({
  distinctId: 'user123',
  event: 'user_signed_up',
  properties: {
    plan: 'premium'
  }
});

Identify Users

This feature allows you to identify users and associate them with specific properties. The `identify` method is used to set or update user properties.

const { PostHog } = require('posthog-node');
const client = new PostHog('YOUR_API_KEY');

client.identify({
  distinctId: 'user123',
  properties: {
    email: '[e-mail]',
    name: 'John Doe'
  }
});

Feature Flags

This feature allows you to manage feature flags, enabling or disabling features for specific users. The `isFeatureEnabled` method checks if a feature flag is enabled for a given user.

const { PostHog } = require('posthog-node');
const client = new PostHog('YOUR_API_KEY');

client.isFeatureEnabled('new-feature', 'user123').then(isEnabled => {
  if (isEnabled) {
    console.log('Feature is enabled for this user');
  } else {
    console.log('Feature is not enabled for this user');
  }
});

Other packages similar to posthog-node

segment

Segment is a customer data platform that helps you collect, clean, and control your customer data. It offers similar event tracking and user identification features but also integrates with a wide range of other analytics and marketing tools.

amplitude

Amplitude is a product analytics service that provides in-depth analysis of user behavior. It offers event tracking and user identification, similar to posthog-node, but with more advanced analytics and reporting capabilities.

mixpanel

Mixpanel is an advanced analytics platform that focuses on tracking user interactions with web and mobile applications. It offers similar functionalities to posthog-node, such as event tracking and user identification, but also includes advanced features like A/B testing and user retention analysis.

README

PostHog Node.js Library

Please see PostHog Docs. Specifically, Node.js library details.

Releasing a new version

Just bump up version in package.json on the main branch and the new version will be published automatically.

It's advised to use bump patch/minor/major label on PRs - that way the above will be done automatically when the PR is merged.

Courtesy of GitHub Actions.

Thanks

This library is largely based on the analytics-node package.

Questions?

Join our Slack community.