Allow searching users by custom attributes (#195)

* Allow searching users by custom attributes

This will allow searching users by custom attributes. The attributes will be set as query parameters.

This depends on keycloak/keycloak#8329

* Allow numbers in custom attributes

This is required for typescript to accept paging parameters

src/resources/users.ts

@@ -23,7 +23,7 @@ export interface UserQuery {
 }
 
 export class Users extends Resource<{realm?: string}> {
-  public find = this.makeRequest<UserQuery, UserRepresentation[]>({
+  public find = this.makeRequest<UserQuery & {[key: string]: string | number}, UserRepresentation[]>({
     method: 'GET',
   });
 

test/users.spec.ts

@@ -33,6 +33,9 @@ describe('Users', function () {
       // enabled required to be true in order to send actions email
       emailVerified: true,
       enabled: true,
+      attributes: {
+        key: 'value',
+      },
     });
 
     expect(user.id).to.be.ok;
@@ -91,6 +94,17 @@ describe('Users', function () {
     }
   });
 
+  it('find users by custom attributes', async function() {
+    // Searching by attributes is only available from Keycloak > 15
+    if (process.env.KEYCLOAK_VERSION && process.env.KEYCLOAK_VERSION.startsWith('15.')) {
+      const users = await kcAdminClient.users.find({key: 'value'});
+      expect(users.length).to.be.equal(1);
+      expect(users[0]).to.be.deep.include(currentUser);
+    } else {
+      this.skip();
+    }
+  });
+
   it('get single users', async () => {
     const userId = currentUser.id;
     const user = await kcAdminClient.users.findOne({