Package Exports
- @commet/node
Readme
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/nodeGetting 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: 'billing@acme.com'
});
// 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 pullThis 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
License
MIT