Organizations

import { createKavach } from 'kavachos';
import { organization } from 'kavachos/auth'; 

const kavach = await createKavach({
  database: { provider: 'sqlite', url: 'kavach.db' },
  plugins: [
    organization({ 
      maxMembers: 100, 
      maxOrgsPerUser: 5, 
      allowCustomRoles: true, 
    }), 
  ],
});

const org = await kavach.org.create({
  name: 'Acme Corp',
  slug: 'acme-corp',   // lowercase letters, numbers, hyphens only
  ownerId: 'user_abc',
  metadata: { plan: 'pro' },
});
// org.id = 'org_...'

const invitation = await kavach.org.invite({
  orgId: org.id,
  email: 'alice@acme.com',
  role: 'admin',
  invitedBy: 'user_abc',
});
// invitation.id, invitation.expiresAt (7 days)

const member = await kavach.org.acceptInvitation(invitation.id, 'user_xyz');

// List all members
const members = await kavach.org.getMembers(org.id);

// Change a member's role
await kavach.org.updateMemberRole(org.id, 'user_xyz', 'member');

// Remove a member
await kavach.org.removeMember(org.id, 'user_xyz');

const allowed = await kavach.org.hasPermission(org.id, userId, 'agents:create'); 

await kavach.org.createRole(org.id, {
  name: 'billing',
  permissions: ['invoices:read', 'invoices:pay'],
});