Organization Best Practices

organization({
	teams: {
		maximumTeams: 20, // Max teams per org
		maximumMembersPerTeam: 50, // Max members per team
		allowRemovingAllTeams: false // Prevent removing last team
	}
});

import { organization } from 'better-auth/plugins';
import { dynamicAccessControl } from '@better-auth/organization/addons';

export const auth = betterAuth({
	plugins: [
		organization({
			dynamicAccessControl: {
				enabled: true
			}
		})
	]
});

await authClient.organization.createRole({
	role: 'moderator',
	permission: {
		member: ['read'],
		invitation: ['read']
	}
});

organization({
	hooks: {
		organization: {
			beforeCreate: async ({ data, user }) => {
				// Validate or modify data before creation
				return {
					data: {
						...data,
						metadata: { ...data.metadata, createdBy: user.id }
					}
				};
			},
			afterCreate: async ({ organization, member }) => {
				// Post-creation logic (e.g., send welcome email, create default resources)
				await createDefaultResources(organization.id);
			},
			beforeDelete: async ({ organization }) => {
				// Cleanup before deletion
				await archiveOrganizationData(organization.id);
			}
		},
		member: {
			afterCreate: async ({ member, organization }) => {
				await notifyAdmins(organization.id, `New member joined`);
			}
		},
		invitation: {
			afterCreate: async ({ invitation, organization, inviter }) => {
				await logInvitation(invitation);
			}
		}
	}
});

organization({
	schema: {
		organization: {
			modelName: 'workspace', // Rename table
			fields: {
				name: 'workspaceName' // Rename fields
			},
			additionalFields: {
				billingId: {
					type: 'string',
					required: false
				}
			}
		},
		member: {
			additionalFields: {
				department: {
					type: 'string',
					required: false
				},
				title: {
					type: 'string',
					required: false
				}
			}
		}
	}
});

// Transfer ownership first
await authClient.organization.updateMemberRole({
	memberId: 'new-owner-member-id',
	role: 'owner'
});

// Then the previous owner can be demoted or removed

organization({
	disableOrganizationDeletion: true // Disable via config
});

organization({
	hooks: {
		organization: {
			beforeDelete: async ({ organization }) => {
				// Archive instead of delete
				await archiveOrganization(organization.id);
				throw new Error('Organization archived, not deleted');
			}
		}
	}
});

import { betterAuth } from 'better-auth';
import { organization } from 'better-auth/plugins';
import { sendEmail } from './email';

export const auth = betterAuth({
	plugins: [
		organization({
			// Organization limits
			allowUserToCreateOrganization: true,
			organizationLimit: 10,
			membershipLimit: 100,
			creatorRole: 'owner',

			// Slugs
			defaultOrganizationIdField: 'slug',

			// Invitations
			invitationExpiresIn: 60 * 60 * 24 * 7, // 7 days
			invitationLimit: 50,
			sendInvitationEmail: async (data) => {
				await sendEmail({
					to: data.email,
					subject: `Join ${data.organization.name}`,
					html: `<a href="https://app.com/invite/${data.invitation.id}">Accept</a>`
				});
			},

			// Hooks
			hooks: {
				organization: {
					afterCreate: async ({ organization }) => {
						console.log(`Organization ${organization.name} created`);
					}
				}
			}
		})
	]
});