Commet is an all-in-one billing and payments platform for SaaS and AI products. @commet/node is the core SDK — use it to manage customers, track usage, handle subscriptions, and more from your server.

Installation

npm install @commet/node

Getting Started

1. Create a Commet account

Sign up at commet.co and create an organization. Go to Settings → API Keys to get your key.

# .env
COMMET_API_KEY=ck_...

2. Initialize the SDK

import { Commet } from '@commet/node';

const commet = new Commet({
  apiKey: process.env.COMMET_API_KEY,
});

3. Start using it

// Create a customer
const customer = await commet.customers.create({
  fullName: 'Acme Corp',
  billingEmail: '[email protected]'
});

// Subscribe them to a plan
await commet.subscriptions.create({
  externalId: 'user_123',
  planCode: 'pro', // autocomplete works after `commet pull`
  billingInterval: 'yearly',
});

// Track usage events
await commet.usage.create({
  feature: 'api_call',
  value: 1,
  customerId: 'cus_123'
});

// Manage seats
await commet.seats.add({
  customerId: 'cus_123',
  seatType: 'admin',
  count: 5
});

// Check feature access
const feature = await commet.features.check({
  externalId: 'user_123',
  code: 'api_calls'
});

// Generate customer portal link
const portal = await commet.portal.getUrl({
  externalId: 'user_123'
});

Type Safety

Use the Commet CLI to generate TypeScript types from your organization:

npm install -g commet
commet login
commet link
commet pull

This generates type-safe autocomplete for your plan codes, feature codes, and seat types.

Documentation

Visit commet.co/docs for:

• Complete API reference
• Advanced usage examples
• Error handling
• Best practices

Resources

• CLI Documentation
• SDK Reference
• GitHub
• Issues

License

MIT