@slnka/compat-mixpanel

Drop-in replacement for the Mixpanel JS SDK that routes all analytics data to the SLNK sovereign platform.

Quick Start

// Before (Mixpanel)
import mixpanel from 'mixpanel-browser';
mixpanel.init('YOUR_MIXPANEL_TOKEN');

// After (SLNK) - just change the import and token
import mixpanel from '@slnka/compat-mixpanel';
mixpanel.init('lsk_live_YOUR_KEY', { api_host: 'https://your-instance.slnk.ma' });  // api_host is required

Supported API

• mixpanel.init(token, config) - Initialize the SDK
• mixpanel.track(event, properties) - Track events
• mixpanel.identify(userId) - Identify users
• mixpanel.alias(alias, originalId) - Create aliases
• mixpanel.register(superProps) - Register super properties
• mixpanel.register_once(superProps) - Register super properties (once only)
• mixpanel.unregister(key) - Remove a super property
• mixpanel.time_event(eventName) - Start timing an event
• mixpanel.reset() - Reset identity
• mixpanel.get_distinct_id() - Get current distinct ID
• mixpanel.get_property(key) - Get a super property value
• mixpanel.people.set(properties) - Set user profile properties
• mixpanel.people.set_once(properties) - Set user profile properties (once only)
• mixpanel.people.increment(property, by) - Increment a numeric property
• mixpanel.people.append(property, value) - Append to a list property
• mixpanel.people.union(property, values) - Union values to a list property
• mixpanel.people.unset(properties) - Remove profile properties
• mixpanel.people.delete_user() - Delete user profile
• mixpanel.group.set(groupKey, groupId, properties) - Set group properties
• mixpanel.group.set_once(groupKey, groupId, properties) - Set group properties (once)
• mixpanel.group.union(groupKey, groupId, property, values) - Union to group list
• mixpanel.group.unset(groupKey, groupId, properties) - Remove group properties
• mixpanel.group.delete_group(groupKey, groupId) - Delete group
• mixpanel.opt_in_tracking() - Grant consent (CNDP)
• mixpanel.opt_out_tracking() - Revoke consent (CNDP)

Dual-Write Mode

During migration, send events to both SLNK and Mixpanel simultaneously:

mixpanel.init('lsk_live_YOUR_KEY', {
  dual_write: true,
  mixpanel_token: 'YOUR_MIXPANEL_TOKEN',
});

CNDP Compliance

By default, the SDK operates in CNDP-compliant mode (Law 09-08). No events are sent until consent is granted:

// User grants consent
mixpanel.opt_in_tracking();

// User revokes consent
mixpanel.opt_out_tracking();