@profilex/sdk-js

JavaScript SDK for ProfileX API - Generate banners, badges, analytics, and more.

Installation

npm install @profilex/sdk-js

Usage

const { ProfileXClient } = require('@profilex/sdk-js');
// or
import { ProfileXClient } from '@profilex/sdk-js';

const client = new ProfileXClient({
  token: 'your-profilex-token',
  baseURL: 'https://api.profilex.com'
});

// Get a profile banner
client.getBanner('johndoe', {
  theme: 'dark',
  size: 'large'
}).then(bannerUrl => {
  console.log('Banner URL:', bannerUrl);
});

// Get analytics data
client.getAnalytics('johndoe', {
  period: '30d'
}).then(analytics => {
  console.log('Analytics:', analytics);
});

// Record events
client.recordEvent({
  type: 'banner.render',
  profileId: 'johndoe',
  metadata: { format: 'svg' }
}).then(result => {
  console.log('Event recorded:', result);
});

API Methods

• getBanner() - Generate profile banners
• getCommitGraph() - Get commit graph SVGs
• getBadge() - Generate Shields-like badges
• getEmbed() - Get embed codes
• getAnalytics() - Fetch analytics data
• getAnalyticsSummary() - Get analytics summary
• recordEvent() - Record telemetry events
• getProfile() - Get profile data
• updateProfile() - Update profile data

Authentication

Use ProfileX-Token v2 for authentication:

const client = new ProfileXClient({
  token: 'PXTK_...'
});

License

MIT