Add GET /user_management/users/:id/feature-flags support (#1364)

## Description

- Add GET /user_management/users/:id/feature-flags support with a
`listFeatureFlags` method on the users module

## Documentation

Does this require changes to the WorkOS Docs? E.g. the [API
Reference](https://workos.com/docs/reference) or code snippets need
updates.

```
[x] Yes
```

If yes, link a related docs PR and add a docs maintainer as a reviewer.
Their approval is required.

Author: stanleyphu

src/organizations/interfaces/feature-flag.interface.ts renamed to src/feature-flags/interfaces/feature-flag.interface.ts

@@ -1,6 +1,5 @@
 export * from './create-organization-options.interface';
 export * from './domain-data.interface';
-export * from './feature-flag.interface';
 export * from './list-organization-feature-flags-options.interface';
 export * from './list-organizations-options.interface';
 export * from './organization.interface';

src/organizations/serializers/feature-flag.serializer.ts renamed to src/feature-flags/serializers/feature-flag.serializer.ts

@@ -11,7 +11,7 @@ import {
 import {
   FeatureFlag,
   FeatureFlagResponse,
-} from './interfaces/feature-flag.interface';
+} from '../feature-flags/interfaces/feature-flag.interface';
 import {
   deserializeOrganization,
   serializeCreateOrganizationOptions,
@@ -23,7 +23,7 @@ import { ListOrganizationRolesResponse, RoleList } from '../roles/interfaces';
 import { deserializeRole } from '../roles/serializers/role.serializer';
 import { ListOrganizationRolesOptions } from './interfaces/list-organization-roles-options.interface';
 import { ListOrganizationFeatureFlagsOptions } from './interfaces/list-organization-feature-flags-options.interface';
-import { deserializeFeatureFlag } from './serializers/feature-flag.serializer';
+import { deserializeFeatureFlag } from '../feature-flags/serializers/feature-flag.serializer';
 
 export class Organizations {
   constructor(private readonly workos: WorkOS) {}

src/organizations/interfaces/index.ts

@@ -0,0 +1,33 @@
+{
+  "object": "list",
+  "data": [
+    {
+      "object": "feature_flag",
+      "id": "flag_01EHQMYV6MBK39QC5PZXHY59C5",
+      "name": "Advanced Dashboard",
+      "slug": "advanced-dashboard",
+      "description": "Enable advanced dashboard features",
+      "created_at": "2024-01-01T00:00:00.000Z",
+      "updated_at": "2024-01-01T00:00:00.000Z"
+    },
+    {
+      "object": "feature_flag",
+      "id": "flag_01EHQMYV6MBK39QC5PZXHY59C6",
+      "name": "Beta Features",
+      "slug": "beta-features",
+      "description": null,
+      "created_at": "2024-01-01T00:00:00.000Z",
+      "updated_at": "2024-01-01T00:00:00.000Z"
+    },
+    {
+      "object": "feature_flag",
+      "id": "flag_01EHQMYV6MBK39QC5PZXHY59C7",
+      "name": "Premium Support",
+      "slug": "premium-support",
+      "description": "Access to premium support features",
+      "created_at": "2024-01-01T00:00:00.000Z",
+      "updated_at": "2024-01-01T00:00:00.000Z"
+    }
+  ],
+  "list_metadata": {}
+}

src/organizations/organizations.ts

@@ -26,6 +26,7 @@ export * from './list-auth-factors-options.interface';
 export * from './list-invitations-options.interface';
 export * from './list-organization-memberships-options.interface';
 export * from './list-sessions-options.interface';
+export * from './list-user-feature-flags-options.interface';
 export * from './list-users-options.interface';
 export * from './magic-auth.interface';
 export * from './oauth-tokens.interface';

src/user-management/fixtures/list-user-feature-flags.json

@@ -0,0 +1,5 @@
+import { PaginationOptions } from '../../common/interfaces';
+
+export interface ListUserFeatureFlagsOptions extends PaginationOptions {
+  userId: string;
+}

src/user-management/interfaces/index.ts

@@ -13,6 +13,7 @@ import listFactorFixture from './fixtures/list-factors.json';
 import listInvitationsFixture from './fixtures/list-invitations.json';
 import listOrganizationMembershipsFixture from './fixtures/list-organization-memberships.json';
 import listSessionsFixture from './fixtures/list-sessions.json';
+import listUserFeatureFlagsFixture from './fixtures/list-user-feature-flags.json';
 import listUsersFixture from './fixtures/list-users.json';
 import magicAuthFixture from './fixtures/magic_auth.json';
 import organizationMembershipFixture from './fixtures/organization-membership.json';
@@ -1602,6 +1603,118 @@ describe('UserManagement', () => {
     });
   });
 
+  describe('listUserFeatureFlags', () => {
+    it('returns feature flags for the user', async () => {
+      fetchOnce(listUserFeatureFlagsFixture);
+
+      const { data, object, listMetadata } =
+        await workos.userManagement.listUserFeatureFlags({ userId });
+
+      expect(fetchURL()).toContain(
+        `/user_management/users/${userId}/feature-flags`,
+      );
+
+      expect(object).toEqual('list');
+      expect(listMetadata).toEqual({});
+      expect(data).toHaveLength(3);
+      expect(data).toEqual([
+        {
+          object: 'feature_flag',
+          id: 'flag_01EHQMYV6MBK39QC5PZXHY59C5',
+          name: 'Advanced Dashboard',
+          slug: 'advanced-dashboard',
+          description: 'Enable advanced dashboard features',
+          createdAt: '2024-01-01T00:00:00.000Z',
+          updatedAt: '2024-01-01T00:00:00.000Z',
+        },
+        {
+          object: 'feature_flag',
+          id: 'flag_01EHQMYV6MBK39QC5PZXHY59C6',
+          name: 'Beta Features',
+          slug: 'beta-features',
+          description: null,
+          createdAt: '2024-01-01T00:00:00.000Z',
+          updatedAt: '2024-01-01T00:00:00.000Z',
+        },
+        {
+          object: 'feature_flag',
+          id: 'flag_01EHQMYV6MBK39QC5PZXHY59C7',
+          name: 'Premium Support',
+          slug: 'premium-support',
+          description: 'Access to premium support features',
+          createdAt: '2024-01-01T00:00:00.000Z',
+          updatedAt: '2024-01-01T00:00:00.000Z',
+        },
+      ]);
+    });
+
+    describe('with the before option', () => {
+      it('forms the proper request to the API', async () => {
+        fetchOnce(listUserFeatureFlagsFixture);
+
+        const { data } = await workos.userManagement.listUserFeatureFlags({
+          userId,
+          before: 'flag_before_id',
+        });
+
+        expect(fetchSearchParams()).toEqual({
+          before: 'flag_before_id',
+          order: 'desc',
+        });
+
+        expect(fetchURL()).toContain(
+          `/user_management/users/${userId}/feature-flags`,
+        );
+
+        expect(data).toHaveLength(3);
+      });
+    });
+
+    describe('with the after option', () => {
+      it('forms the proper request to the API', async () => {
+        fetchOnce(listUserFeatureFlagsFixture);
+
+        const { data } = await workos.userManagement.listUserFeatureFlags({
+          userId,
+          after: 'flag_after_id',
+        });
+
+        expect(fetchSearchParams()).toEqual({
+          after: 'flag_after_id',
+          order: 'desc',
+        });
+
+        expect(fetchURL()).toContain(
+          `/user_management/users/${userId}/feature-flags`,
+        );
+
+        expect(data).toHaveLength(3);
+      });
+    });
+
+    describe('with the limit option', () => {
+      it('forms the proper request to the API', async () => {
+        fetchOnce(listUserFeatureFlagsFixture);
+
+        const { data } = await workos.userManagement.listUserFeatureFlags({
+          userId,
+          limit: 3,
+        });
+
+        expect(fetchSearchParams()).toEqual({
+          limit: '3',
+          order: 'desc',
+        });
+
+        expect(fetchURL()).toContain(
+          `/user_management/users/${userId}/feature-flags`,
+        );
+
+        expect(data).toHaveLength(3);
+      });
+    });
+  });
+
   describe('listSessions', () => {
     it('sends a listSessions request', async () => {
       fetchOnce(listSessionsFixture);

src/user-management/interfaces/list-user-feature-flags-options.interface.ts

@@ -6,6 +6,11 @@ import { fetchAndDeserialize } from '../common/utils/fetch-and-deserialize';
 import { AutoPaginatable } from '../common/utils/pagination';
 import { Challenge, ChallengeResponse } from '../mfa/interfaces';
 import { deserializeChallenge } from '../mfa/serializers';
+import {
+  FeatureFlag,
+  FeatureFlagResponse,
+} from '../feature-flags/interfaces/feature-flag.interface';
+import { deserializeFeatureFlag } from '../feature-flags/serializers/feature-flag.serializer';
 import { WorkOS } from '../workos';
 import {
   AuthenticateWithCodeOptions,
@@ -26,6 +31,7 @@ import {
   ListAuthFactorsOptions,
   ListSessionsOptions,
   ListUsersOptions,
+  ListUserFeatureFlagsOptions,
   MagicAuth,
   MagicAuthResponse,
   PasswordReset,
@@ -821,6 +827,29 @@ export class UserManagement {
     );
   }
 
+  async listUserFeatureFlags(
+    options: ListUserFeatureFlagsOptions,
+  ): Promise<AutoPaginatable<FeatureFlag>> {
+    const { userId, ...paginationOptions } = options;
+
+    return new AutoPaginatable(
+      await fetchAndDeserialize<FeatureFlagResponse, FeatureFlag>(
+        this.workos,
+        `/user_management/users/${userId}/feature-flags`,
+        deserializeFeatureFlag,
+        paginationOptions,
+      ),
+      (params) =>
+        fetchAndDeserialize<FeatureFlagResponse, FeatureFlag>(
+          this.workos,
+          `/user_management/users/${userId}/feature-flags`,
+          deserializeFeatureFlag,
+          params,
+        ),
+      paginationOptions,
+    );
+  }
+
   async listSessions(
     userId: string,
     options?: ListSessionsOptions,