Remove deprecated properties for v8 (#1365)

## Description

This pull request removes several deprecated fields and enum values from
user management and directory sync interfaces, as well as from
organization domain state definitions. These changes help clean up the
codebase and ensure that only current, supported attributes are exposed
in the interfaces.

### Deprecated field removals

**User management authorization options:**
* Removed the deprecated `context` field from both
`AuthorizationURLOptions` and `UserManagementAuthorizationURLOptions`
interfaces, as it is no longer required for getting authorization URLs.
[[1]](diffhunk://#diff-b5a04503adce4aaadee02b4511ee9bd11ec26a46927bde7c07d85ad31786e4bbL9-L13)
[[2]](diffhunk://#diff-22f5a89986b17dd45c06dbbba9f624690b22d5ede6e7455dade9d3fb7924f131L6-L10)

**Directory user interfaces:**
* Removed deprecated fields (`emails`, `username`, and `jobTitle`) from
both `DirectoryUser` and `DirectoryUserResponse` interfaces, as these
should now be accessed through custom attributes.
[[1]](diffhunk://#diff-2151436e8d7d3a67c1165760fdfa80802fd72276034e54114c3ddfcdfe03e7fcL22-L41)
[[2]](diffhunk://#diff-2151436e8d7d3a67c1165760fdfa80802fd72276034e54114c3ddfcdfe03e7fcL61-L80)

### Enum cleanup

**Organization domain state:**
* Removed the deprecated `LegacyVerified` value from the
`OrganizationDomainState` enum.

## Documentation

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

```
[ ] Yes
```

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

Author: nicknisi

package.json

@@ -36,7 +36,8 @@
     "check:runtimes": "tsx scripts/ecosystem-check.ts",
     "prettier": "prettier \"src/**/*.{js,ts,tsx}\" --check",
     "format": "prettier \"src/**/*.{js,ts,tsx}\" --write",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "iron-session": "^8.0.4",

src/client/user-management.ts

@@ -6,11 +6,6 @@ export interface AuthorizationURLOptions {
   codeChallenge?: string;
   codeChallengeMethod?: 'S256';
   connectionId?: string;
-  /**
-   *  @deprecated We previously required initiate login endpoints to return the `context`
-   *  query parameter when getting the authorization URL. This is no longer necessary.
-   */
-  context?: string;
   organizationId?: string;
   domainHint?: string;
   loginHint?: string;
@@ -43,7 +38,6 @@ export function getAuthorizationUrl(
     connectionId,
     codeChallenge,
     codeChallengeMethod,
-    context,
     clientId,
     domainHint,
     loginHint,
@@ -70,18 +64,10 @@ export function getAuthorizationUrl(
     );
   }
 
-  if (context) {
-    console.warn(
-      `WorkOS: \`context\` is deprecated. We previously required initiate login endpoints to return the
-\`context\` query parameter when getting the authorization URL. This is no longer necessary.`,
-    );
-  }
-
   const query = toQueryString({
     connection_id: connectionId,
     code_challenge: codeChallenge,
     code_challenge_method: codeChallengeMethod,
-    context,
     organization_id: organizationId,
     domain_hint: domainHint,
     login_hint: loginHint,

src/common/net/fetch-client.ts

@@ -175,14 +175,10 @@ export class FetchHttpClient extends HttpClient implements HttpClientInterface {
     const { 'User-Agent': userAgent } = (this.options?.headers ||
       {}) as RequestHeaders;
 
-    // Create AbortController for timeout if configured
-    let abortController: AbortController | undefined;
-    let timeoutId: ReturnType<typeof setTimeout> | undefined;
-
     // Access timeout from the options with default of 60 seconds
     const timeout = this.options?.timeout ?? DEFAULT_FETCH_TIMEOUT; // Default 60 seconds
-    abortController = new AbortController();
-    timeoutId = setTimeout(() => {
+    const abortController = new AbortController();
+    const timeoutId = setTimeout(() => {
       abortController?.abort();
     }, timeout);
 

src/directory-sync/directory-sync.spec.ts

@@ -81,21 +81,12 @@ describe('DirectorySync', () => {
     directoryId: 'dir_123',
     organizationId: 'org_123',
     email: '[email protected]',
-    emails: [
-      {
-        primary: true,
-        type: 'type',
-        value: '[email protected]',
-      },
-    ],
     firstName: 'Jon',
     groups: [group],
     idpId: 'idp_foo',
     lastName: 'Snow',
-    jobTitle: 'Knight of the Watch',
     rawAttributes: {},
     state: 'active',
-    username: 'jonsnow',
     createdAt: '2021-10-27 15:21:50.640959',
     updatedAt: '2021-12-13 12:15:45.531847',
   };
@@ -109,21 +100,12 @@ describe('DirectorySync', () => {
     directory_id: 'dir_123',
     organization_id: 'org_123',
     email: '[email protected]',
-    emails: [
-      {
-        primary: true,
-        type: 'type',
-        value: '[email protected]',
-      },
-    ],
     first_name: 'Jon',
     groups: [groupResponse],
     idp_id: 'idp_foo',
     last_name: 'Snow',
-    job_title: 'Knight of the Watch',
     raw_attributes: {},
     state: 'active',
-    username: 'jonsnow',
     created_at: '2021-10-27 15:21:50.640959',
     updated_at: '2021-12-13 12:15:45.531847',
   };
@@ -137,21 +119,12 @@ describe('DirectorySync', () => {
     directoryId: 'dir_123',
     organizationId: 'org_123',
     email: '[email protected]',
-    emails: [
-      {
-        primary: true,
-        type: 'type',
-        value: '[email protected]',
-      },
-    ],
     firstName: 'Jon',
     groups: [group],
     idpId: 'idp_foo',
     lastName: 'Snow',
-    jobTitle: 'Knight of the Watch',
     rawAttributes: {},
     state: 'active',
-    username: 'jonsnow',
     role: { slug: 'super_admin' },
     createdAt: '2021-10-27 15:21:50.640959',
     updatedAt: '2021-12-13 12:15:45.531847',
@@ -166,21 +139,12 @@ describe('DirectorySync', () => {
     directory_id: 'dir_123',
     organization_id: 'org_123',
     email: '[email protected]',
-    emails: [
-      {
-        primary: true,
-        type: 'type',
-        value: '[email protected]',
-      },
-    ],
     first_name: 'Jon',
     groups: [groupResponse],
     idp_id: 'idp_foo',
     last_name: 'Snow',
-    job_title: 'Knight of the Watch',
     raw_attributes: {},
     state: 'active',
-    username: 'jonsnow',
     role: { slug: 'super_admin' },
     created_at: '2021-10-27 15:21:50.640959',
     updated_at: '2021-12-13 12:15:45.531847',

src/directory-sync/interfaces/directory-user.interface.ts

@@ -19,26 +19,7 @@ export interface DirectoryUser<
   idpId: string;
   firstName: string | null;
   email: string | null;
-  /** @deprecated Will be removed in a future major version.
-   * Enable the `emails` custom attribute in dashboard and pull from customAttributes instead.
-   * See https://workos.com/docs/directory-sync/attributes/custom-attributes/auto-mapped-attributes for details.
-   */
-  emails: {
-    type?: string;
-    value?: string;
-    primary?: boolean;
-  }[];
-  /** @deprecated Will be removed in a future major version.
-   * Enable the `username` custom attribute in dashboard and pull from customAttributes instead.
-   * See https://workos.com/docs/directory-sync/attributes/custom-attributes/auto-mapped-attributes for details.
-   */
-  username: string | null;
   lastName: string | null;
-  /** @deprecated Will be removed in a future major version.
-   * Enable the `job_title` custom attribute in dashboard and pull from customAttributes instead.
-   * See https://workos.com/docs/directory-sync/attributes/custom-attributes/auto-mapped-attributes for details.
-   */
-  jobTitle: string | null;
   state: 'active' | 'inactive';
   role?: RoleResponse;
   createdAt: string;
@@ -58,26 +39,7 @@ export interface DirectoryUserResponse<
   idp_id: string;
   first_name: string | null;
   email: string | null;
-  /** @deprecated Will be removed in a future major version.
-   * Enable the `emails` custom attribute in dashboard and pull from customAttributes instead.
-   * See https://workos.com/docs/directory-sync/attributes/custom-attributes/auto-mapped-attributes for details.
-   */
-  emails: {
-    type?: string;
-    value?: string;
-    primary?: boolean;
-  }[];
-  /** @deprecated Will be removed in a future major version.
-   * Enable the `username` custom attribute in dashboard and pull from customAttributes instead.
-   * See https://workos.com/docs/directory-sync/attributes/custom-attributes/auto-mapped-attributes for details.
-   */
-  username: string | null;
   last_name: string | null;
-  /** @deprecated Will be removed in a future major version.
-   * Enable the `job_title` custom attribute in dashboard and pull from customAttributes instead.
-   * See https://workos.com/docs/directory-sync/attributes/custom-attributes/auto-mapped-attributes for details.
-   */
-  job_title: string | null;
   state: 'active' | 'inactive';
   role?: RoleResponse;
   created_at: string;

src/directory-sync/serializers/directory-user.serializer.ts

@@ -23,10 +23,7 @@ export const deserializeDirectoryUser = <
   idpId: directoryUser.idp_id,
   firstName: directoryUser.first_name,
   email: directoryUser.email,
-  emails: directoryUser.emails,
-  username: directoryUser.username,
   lastName: directoryUser.last_name,
-  jobTitle: directoryUser.job_title,
   state: directoryUser.state,
   role: directoryUser.role,
   createdAt: directoryUser.created_at,
@@ -54,10 +51,7 @@ export const deserializeUpdatedEventDirectoryUser = (
   idpId: directoryUser.idp_id,
   firstName: directoryUser.first_name,
   email: directoryUser.email,
-  emails: directoryUser.emails,
-  username: directoryUser.username,
   lastName: directoryUser.last_name,
-  jobTitle: directoryUser.job_title,
   state: directoryUser.state,
   role: directoryUser.role,
   createdAt: directoryUser.created_at,

src/directory-sync/utils/get-primary-email.spec.ts

@@ -129,20 +129,11 @@ describe('Event', () => {
             directoryId: 'dir_123',
             organizationId: 'org_123',
             email: '[email protected]',
-            emails: [
-              {
-                primary: true,
-                type: 'type',
-                value: '[email protected]',
-              },
-            ],
             firstName: 'Jon',
             idpId: 'idp_foo',
             lastName: 'Snow',
-            jobTitle: 'Knight of the Watch',
             rawAttributes: {},
             state: 'active',
-            username: 'jonsnow',
             role: { slug: 'super_admin' },
             previousAttributes: {
               role: { slug: 'member' },
@@ -165,20 +156,11 @@ describe('Event', () => {
             directory_id: 'dir_123',
             organization_id: 'org_123',
             email: '[email protected]',
-            emails: [
-              {
-                primary: true,
-                type: 'type',
-                value: '[email protected]',
-              },
-            ],
             first_name: 'Jon',
             idp_id: 'idp_foo',
             last_name: 'Snow',
-            job_title: 'Knight of the Watch',
             raw_attributes: {},
             state: 'active',
-            username: 'jonsnow',
             role: { slug: 'super_admin' },
             previous_attributes: {
               role: { slug: 'member' },

src/directory-sync/utils/get-primary-email.ts

@@ -15,7 +15,6 @@ export * from './common/exceptions';
 export * from './common/interfaces';
 export * from './common/utils/pagination';
 export * from './directory-sync/interfaces';
-export * from './directory-sync/utils/get-primary-email';
 export * from './events/interfaces';
 export * from './fga/interfaces';
 export * from './organizations/interfaces';