Initialization

import { coss } from '@coss';
coss.auth.init({
apiKey: process.env.COSS_KEY,
environment: 'production', // or 'sandbox'
});

Users

// Register a new user
await coss.auth.users.register({
email: 'jane@example.com',
password: 'securePassword123',
});
// Log in a user
await coss.auth.users.login({
email: 'jane@example.com',
password: 'securePassword123',
});
// Retrieve user profile
await coss.auth.users.retrieve('user_abc123');
// Update user profile
await coss.auth.users.update('user_abc123', {
name: 'Jane Doe',
});
// Delete user
await coss.auth.users.delete('user_abc123');

Sessions

// Validate session token
const session = await coss.auth.sessions.validate('session_token_123');
// Log out
await coss.auth.sessions.logout('session_token_123');

Password Reset

// Request password reset email
await coss.auth.passwords.requestReset({
email: 'jane@example.com',
});
// Confirm password reset
await coss.auth.passwords.confirmReset({
token: 'reset_token_123',
newPassword: 'newSecurePassword456',
});

Webhooks

// Webhook events
coss.auth.webhooks.on('user.registered', (event) => {
console.log('New user registered:', event.data);
});
coss.auth.webhooks.on('user.deleted', (event) => {
console.log('User deleted:', event.data);
});

Utilities

// Validate webhook signature
const isValid = coss.auth.utils.verifySignature({
payload: req.body,
signature: req.headers['coss-auth-signature'],
secret: 'whsec_auth_123',
});
Join the waitlistJoin the company