coss.comauthUpcoming
8.7k

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: '[email protected]',
  password: 'securePassword123',
});

// Log in a user
await coss.auth.users.login({
  email: '[email protected]',
  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: '[email protected]',
});

// 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',
});