Add api keys management api methods (#1434)

## Description

This PR adds methods for new API key management API endpoints that we
recently added.
- `organizations.listOrganizationApiKeys` (`GET
/organizations/:id/api_keys`)
- `organizations.createOrganizationApiKey` (`POST
/organizations/:id/api_keys`)
  - `apiKeys.deleteApiKey` (`DELETE /api_keys/:id`)

## 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/api-keys/api-keys.spec.ts

@@ -51,4 +51,16 @@ describe('ApiKeys', () => {
       expect(response).toEqual({ apiKey: null });
     });
   });
+
+  describe('deleteApiKey', () => {
+    it('sends a delete request', async () => {
+      fetchOnce({}, { status: 204 });
+
+      await workos.apiKeys.deleteApiKey('api_key_01H5JQDV7R7ATEYZDEG0W5PRYS');
+
+      expect(fetchURL()).toContain(
+        '/api_keys/api_key_01H5JQDV7R7ATEYZDEG0W5PRYS',
+      );
+    });
+  });
 });

src/api-keys/api-keys.ts

@@ -19,4 +19,8 @@ export class ApiKeys {
 
     return deserializeValidateApiKeyResponse(data);
   }
+
+  async deleteApiKey(id: string): Promise<void> {
+    await this.workos.delete(`/api_keys/${id}`);
+  }
 }

src/api-keys/interfaces/create-organization-api-key-options.interface.ts

@@ -0,0 +1,15 @@
+import { PostOptions } from '../../common/interfaces';
+
+export interface CreateOrganizationApiKeyOptions {
+  organizationId: string;
+  name: string;
+  permissions?: string[];
+}
+
+export interface SerializedCreateOrganizationApiKeyOptions {
+  name: string;
+  permissions?: string[];
+}
+
+export interface CreateOrganizationApiKeyRequestOptions
+  extends Pick<PostOptions, 'idempotencyKey'> {}

src/api-keys/interfaces/created-api-key.interface.ts

@@ -0,0 +1,31 @@
+export interface CreatedApiKey {
+  object: 'api_key';
+  id: string;
+  owner: {
+    type: 'organization';
+    id: string;
+  };
+  name: string;
+  obfuscatedValue: string;
+  value: string;
+  lastUsedAt: string | null;
+  permissions: string[];
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface SerializedCreatedApiKey {
+  object: 'api_key';
+  id: string;
+  owner: {
+    type: 'organization';
+    id: string;
+  };
+  name: string;
+  obfuscated_value: string;
+  value: string;
+  last_used_at: string | null;
+  permissions: string[];
+  created_at: string;
+  updated_at: string;
+}

src/api-keys/interfaces/index.ts

@@ -0,0 +1,5 @@
+export * from './api-key.interface';
+export * from './create-organization-api-key-options.interface';
+export * from './created-api-key.interface';
+export * from './list-organization-api-keys-options.interface';
+export * from './validate-api-key.interface';

src/api-keys/interfaces/list-organization-api-keys-options.interface.ts

@@ -0,0 +1,5 @@
+import { PaginationOptions } from '../../common/interfaces/pagination-options.interface';
+
+export interface ListOrganizationApiKeysOptions extends PaginationOptions {
+  organizationId: string;
+}

src/api-keys/serializers/create-organization-api-key-options.serializer.ts

@@ -0,0 +1,13 @@
+import {
+  CreateOrganizationApiKeyOptions,
+  SerializedCreateOrganizationApiKeyOptions,
+} from '../interfaces/create-organization-api-key-options.interface';
+
+export function serializeCreateOrganizationApiKeyOptions(
+  options: CreateOrganizationApiKeyOptions,
+): SerializedCreateOrganizationApiKeyOptions {
+  return {
+    name: options.name,
+    permissions: options.permissions,
+  };
+}

src/api-keys/serializers/created-api-key.serializer.ts

@@ -0,0 +1,21 @@
+import {
+  CreatedApiKey,
+  SerializedCreatedApiKey,
+} from '../interfaces/created-api-key.interface';
+
+export function deserializeCreatedApiKey(
+  apiKey: SerializedCreatedApiKey,
+): CreatedApiKey {
+  return {
+    object: apiKey.object,
+    id: apiKey.id,
+    owner: apiKey.owner,
+    name: apiKey.name,
+    obfuscatedValue: apiKey.obfuscated_value,
+    value: apiKey.value,
+    lastUsedAt: apiKey.last_used_at,
+    permissions: apiKey.permissions,
+    createdAt: apiKey.created_at,
+    updatedAt: apiKey.updated_at,
+  };
+}

src/api-keys/serializers/index.ts

@@ -0,0 +1,4 @@
+export * from './api-key.serializer';
+export * from './create-organization-api-key-options.serializer';
+export * from './created-api-key.serializer';
+export * from './validate-api-key.serializer';

src/index.ts

@@ -14,6 +14,7 @@ import { WebIronSessionProvider } from './common/iron-session/web-iron-session-p
 import { IronSessionProvider } from './common/iron-session/iron-session-provider';
 
 export * from './actions/interfaces';
+export * from './api-keys/interfaces';
 export * from './audit-logs/interfaces';
 export * from './common/exceptions';
 export * from './common/interfaces';