@vibescope/mcp-server 0.2.9 → 0.3.1

package/src/handlers/organizations.ts

@@ -1,315 +1,315 @@
-/**
- * Organizations Handlers
- *
- * Handles organization management, membership, and project sharing:
- * - list_organizations
- * - create_organization
- * - update_organization
- * - delete_organization
- * - list_org_members
- * - invite_member
- * - update_member_role
- * - remove_member
- * - leave_organization
- * - share_project_with_org
- * - update_project_share
- * - unshare_project
- * - list_project_shares
- */
-
-import type { Handler, HandlerRegistry } from './types.js';
-import { parseArgs, uuidValidator, createEnumValidator, ValidationError } from '../validators.js';
-import { getApiClient } from '../api-client.js';
-
-// Valid roles in order of permission level
-const ROLE_ORDER = ['viewer', 'member', 'admin', 'owner'] as const;
-const ASSIGNABLE_ROLES = ['viewer', 'member', 'admin'] as const;
-type Role = (typeof ROLE_ORDER)[number];
-type AssignableRole = (typeof ASSIGNABLE_ROLES)[number];
-
-// Valid share permissions
-const PERMISSION_ORDER = ['read', 'write', 'admin'] as const;
-type Permission = (typeof PERMISSION_ORDER)[number];
-
-// ============================================================================
-// Argument Schemas
-// ============================================================================
-
-const createOrganizationSchema = {
-	name: { type: 'string' as const, required: true as const },
-	description: { type: 'string' as const },
-	slug: { type: 'string' as const },
-};
-
-const updateOrganizationSchema = {
-	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	name: { type: 'string' as const },
-	description: { type: 'string' as const },
-	logo_url: { type: 'string' as const },
-};
-
-const deleteOrganizationSchema = {
-	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-};
-
-const listOrgMembersSchema = {
-	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-};
-
-const inviteMemberSchema = {
-	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	email: { type: 'string' as const, required: true as const },
-	role: { type: 'string' as const, default: 'member', validate: createEnumValidator(ASSIGNABLE_ROLES) },
-};
-
-const updateMemberRoleSchema = {
-	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	user_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	role: { type: 'string' as const, required: true as const, validate: createEnumValidator(ROLE_ORDER) },
-};
-
-const removeMemberSchema = {
-	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	user_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-};
-
-const leaveOrganizationSchema = {
-	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-};
-
-const shareProjectWithOrgSchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	permission: { type: 'string' as const, default: 'read', validate: createEnumValidator(PERMISSION_ORDER) },
-};
-
-const updateProjectShareSchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	permission: { type: 'string' as const, required: true as const, validate: createEnumValidator(PERMISSION_ORDER) },
-};
-
-const unshareProjectSchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-};
-
-const listProjectSharesSchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-};
-
-// ============================================================================
-// Organization Management
-// ============================================================================
-
-export const listOrganizations: Handler = async (_args, _ctx) => {
-	const apiClient = getApiClient();
-	const response = await apiClient.listOrganizations();
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to list organizations' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const createOrganization: Handler = async (args, _ctx) => {
-	const { name, description, slug } = parseArgs(args, createOrganizationSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.createOrganization({
-		name,
-		description,
-		slug
-	});
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to create organization' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const updateOrganization: Handler = async (args, _ctx) => {
-	const { organization_id, name, description, logo_url } = parseArgs(args, updateOrganizationSchema);
-
-	// Check that at least one update is provided
-	if (name === undefined && description === undefined && logo_url === undefined) {
-		throw new ValidationError('No updates provided');
-	}
-
-	const updates: Record<string, unknown> = {};
-	if (name !== undefined) updates.name = name;
-	if (description !== undefined) updates.description = description;
-	if (logo_url !== undefined) updates.logo_url = logo_url;
-
-	const apiClient = getApiClient();
-	const response = await apiClient.updateOrganization(organization_id, updates);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to update organization' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const deleteOrganization: Handler = async (args, _ctx) => {
-	const { organization_id } = parseArgs(args, deleteOrganizationSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.deleteOrganization(organization_id);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to delete organization' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-// ============================================================================
-// Member Management
-// ============================================================================
-
-export const listOrgMembers: Handler = async (args, _ctx) => {
-	const { organization_id } = parseArgs(args, listOrgMembersSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.listOrgMembers(organization_id);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to list members' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const inviteMember: Handler = async (args, _ctx) => {
-	const { organization_id, email, role } = parseArgs(args, inviteMemberSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.inviteMember(organization_id, email, role as AssignableRole);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to create invite' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const updateMemberRole: Handler = async (args, _ctx) => {
-	const { organization_id, user_id, role } = parseArgs(args, updateMemberRoleSchema);
-
-	if (role === 'owner') {
-		throw new ValidationError('Cannot assign owner role. Use transfer ownership instead.');
-	}
-
-	const apiClient = getApiClient();
-	const response = await apiClient.updateMemberRole(organization_id, user_id, role as Role);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to update member role' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const removeMember: Handler = async (args, _ctx) => {
-	const { organization_id, user_id } = parseArgs(args, removeMemberSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.removeMember(organization_id, user_id);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to remove member' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const leaveOrganization: Handler = async (args, _ctx) => {
-	const { organization_id } = parseArgs(args, leaveOrganizationSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.leaveOrganization(organization_id);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to leave organization' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-// ============================================================================
-// Project Sharing
-// ============================================================================
-
-export const shareProjectWithOrg: Handler = async (args, _ctx) => {
-	const { project_id, organization_id, permission } = parseArgs(args, shareProjectWithOrgSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.shareProjectWithOrg(project_id, organization_id, permission as Permission);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to share project' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const updateProjectShare: Handler = async (args, _ctx) => {
-	const { project_id, organization_id, permission } = parseArgs(args, updateProjectShareSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.updateProjectShare(project_id, organization_id, permission as Permission);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to update share' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const unshareProject: Handler = async (args, _ctx) => {
-	const { project_id, organization_id } = parseArgs(args, unshareProjectSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.unshareProject(project_id, organization_id);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to unshare project' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const listProjectShares: Handler = async (args, _ctx) => {
-	const { project_id } = parseArgs(args, listProjectSharesSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.listProjectShares(project_id);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to list shares' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-/**
- * Organizations handlers registry
- */
-export const organizationHandlers: HandlerRegistry = {
-	list_organizations: listOrganizations,
-	create_organization: createOrganization,
-	update_organization: updateOrganization,
-	delete_organization: deleteOrganization,
-	list_org_members: listOrgMembers,
-	invite_member: inviteMember,
-	update_member_role: updateMemberRole,
-	remove_member: removeMember,
-	leave_organization: leaveOrganization,
-	share_project_with_org: shareProjectWithOrg,
-	update_project_share: updateProjectShare,
-	unshare_project: unshareProject,
-	list_project_shares: listProjectShares,
-};
+/**
+ * Organizations Handlers
+ *
+ * Handles organization management, membership, and project sharing:
+ * - list_organizations
+ * - create_organization
+ * - update_organization
+ * - delete_organization
+ * - list_org_members
+ * - invite_member
+ * - update_member_role
+ * - remove_member
+ * - leave_organization
+ * - share_project_with_org
+ * - update_project_share
+ * - unshare_project
+ * - list_project_shares
+ */
+
+import type { Handler, HandlerRegistry } from './types.js';
+import { parseArgs, uuidValidator, createEnumValidator, ValidationError } from '../validators.js';
+import { getApiClient } from '../api-client.js';
+
+// Valid roles in order of permission level
+const ROLE_ORDER = ['viewer', 'member', 'admin', 'owner'] as const;
+const ASSIGNABLE_ROLES = ['viewer', 'member', 'admin'] as const;
+type Role = (typeof ROLE_ORDER)[number];
+type AssignableRole = (typeof ASSIGNABLE_ROLES)[number];
+
+// Valid share permissions
+const PERMISSION_ORDER = ['read', 'write', 'admin'] as const;
+type Permission = (typeof PERMISSION_ORDER)[number];
+
+// ============================================================================
+// Argument Schemas
+// ============================================================================
+
+const createOrganizationSchema = {
+	name: { type: 'string' as const, required: true as const },
+	description: { type: 'string' as const },
+	slug: { type: 'string' as const },
+};
+
+const updateOrganizationSchema = {
+	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	name: { type: 'string' as const },
+	description: { type: 'string' as const },
+	logo_url: { type: 'string' as const },
+};
+
+const deleteOrganizationSchema = {
+	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+};
+
+const listOrgMembersSchema = {
+	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+};
+
+const inviteMemberSchema = {
+	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	email: { type: 'string' as const, required: true as const },
+	role: { type: 'string' as const, default: 'member', validate: createEnumValidator(ASSIGNABLE_ROLES) },
+};
+
+const updateMemberRoleSchema = {
+	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	user_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	role: { type: 'string' as const, required: true as const, validate: createEnumValidator(ROLE_ORDER) },
+};
+
+const removeMemberSchema = {
+	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	user_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+};
+
+const leaveOrganizationSchema = {
+	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+};
+
+const shareProjectWithOrgSchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	permission: { type: 'string' as const, default: 'read', validate: createEnumValidator(PERMISSION_ORDER) },
+};
+
+const updateProjectShareSchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	permission: { type: 'string' as const, required: true as const, validate: createEnumValidator(PERMISSION_ORDER) },
+};
+
+const unshareProjectSchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	organization_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+};
+
+const listProjectSharesSchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+};
+
+// ============================================================================
+// Organization Management
+// ============================================================================
+
+export const listOrganizations: Handler = async (_args, _ctx) => {
+	const apiClient = getApiClient();
+	const response = await apiClient.listOrganizations();
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to list organizations' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const createOrganization: Handler = async (args, _ctx) => {
+	const { name, description, slug } = parseArgs(args, createOrganizationSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.createOrganization({
+		name,
+		description,
+		slug
+	});
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to create organization' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const updateOrganization: Handler = async (args, _ctx) => {
+	const { organization_id, name, description, logo_url } = parseArgs(args, updateOrganizationSchema);
+
+	// Check that at least one update is provided
+	if (name === undefined && description === undefined && logo_url === undefined) {
+		throw new ValidationError('No updates provided');
+	}
+
+	const updates: Record<string, unknown> = {};
+	if (name !== undefined) updates.name = name;
+	if (description !== undefined) updates.description = description;
+	if (logo_url !== undefined) updates.logo_url = logo_url;
+
+	const apiClient = getApiClient();
+	const response = await apiClient.updateOrganization(organization_id, updates);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to update organization' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const deleteOrganization: Handler = async (args, _ctx) => {
+	const { organization_id } = parseArgs(args, deleteOrganizationSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.deleteOrganization(organization_id);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to delete organization' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+// ============================================================================
+// Member Management
+// ============================================================================
+
+export const listOrgMembers: Handler = async (args, _ctx) => {
+	const { organization_id } = parseArgs(args, listOrgMembersSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.listOrgMembers(organization_id);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to list members' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const inviteMember: Handler = async (args, _ctx) => {
+	const { organization_id, email, role } = parseArgs(args, inviteMemberSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.inviteMember(organization_id, email, role as AssignableRole);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to create invite' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const updateMemberRole: Handler = async (args, _ctx) => {
+	const { organization_id, user_id, role } = parseArgs(args, updateMemberRoleSchema);
+
+	if (role === 'owner') {
+		throw new ValidationError('Cannot assign owner role. Use transfer ownership instead.');
+	}
+
+	const apiClient = getApiClient();
+	const response = await apiClient.updateMemberRole(organization_id, user_id, role as Role);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to update member role' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const removeMember: Handler = async (args, _ctx) => {
+	const { organization_id, user_id } = parseArgs(args, removeMemberSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.removeMember(organization_id, user_id);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to remove member' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const leaveOrganization: Handler = async (args, _ctx) => {
+	const { organization_id } = parseArgs(args, leaveOrganizationSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.leaveOrganization(organization_id);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to leave organization' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+// ============================================================================
+// Project Sharing
+// ============================================================================
+
+export const shareProjectWithOrg: Handler = async (args, _ctx) => {
+	const { project_id, organization_id, permission } = parseArgs(args, shareProjectWithOrgSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.shareProjectWithOrg(project_id, organization_id, permission as Permission);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to share project' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const updateProjectShare: Handler = async (args, _ctx) => {
+	const { project_id, organization_id, permission } = parseArgs(args, updateProjectShareSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.updateProjectShare(project_id, organization_id, permission as Permission);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to update share' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const unshareProject: Handler = async (args, _ctx) => {
+	const { project_id, organization_id } = parseArgs(args, unshareProjectSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.unshareProject(project_id, organization_id);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to unshare project' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const listProjectShares: Handler = async (args, _ctx) => {
+	const { project_id } = parseArgs(args, listProjectSharesSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.listProjectShares(project_id);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to list shares' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+/**
+ * Organizations handlers registry
+ */
+export const organizationHandlers: HandlerRegistry = {
+	list_organizations: listOrganizations,
+	create_organization: createOrganization,
+	update_organization: updateOrganization,
+	delete_organization: deleteOrganization,
+	list_org_members: listOrgMembers,
+	invite_member: inviteMember,
+	update_member_role: updateMemberRole,
+	remove_member: removeMember,
+	leave_organization: leaveOrganization,
+	share_project_with_org: shareProjectWithOrg,
+	update_project_share: updateProjectShare,
+	unshare_project: unshareProject,
+	list_project_shares: listProjectShares,
+};