feat(backend): Add invite, reject, and delete to WaitlistEntryApi resource (#6799)

Author: tmilewski

.changeset/icy-mangos-care.md

@@ -0,0 +1,5 @@
+---
+'@clerk/backend': minor
+---
+
+Add invite, reject, and delete to Waitlist Entry API resources

packages/backend/src/api/endpoints/WaitlistEntryApi.ts

@@ -1,5 +1,7 @@
 import type { ClerkPaginationRequest } from '@clerk/types';
+import { joinPaths } from 'src/util/path';
 
+import type { DeletedObject } from '../resources/DeletedObject';
 import type { PaginatedResourceResponse } from '../resources/Deserializer';
 import type { WaitlistEntryStatus } from '../resources/Enums';
 import type { WaitlistEntry } from '../resources/WaitlistEntry';
@@ -22,7 +24,18 @@ type WaitlistEntryCreateParams = {
   notify?: boolean;
 };
 
+type WaitlistEntryInviteParams = {
+  /**
+   * When true, do not error if an invitation already exists. Default: false.
+   */
+  ignoreExisting?: boolean;
+};
+
 export class WaitlistEntryAPI extends AbstractAPI {
+  /**
+   * List waitlist entries.
+   * @param params Optional parameters (e.g., `query`, `status`, `orderBy`).
+   */
   public async list(params: WaitlistEntryListParams = {}) {
     return this.request<PaginatedResourceResponse<WaitlistEntry>>({
       method: 'GET',
@@ -31,11 +44,56 @@ export class WaitlistEntryAPI extends AbstractAPI {
     });
   }
 
+  /**
+   * Create a waitlist entry.
+   * @param params The parameters for creating a waitlist entry.
+   */
   public async create(params: WaitlistEntryCreateParams) {
     return this.request<WaitlistEntry>({
       method: 'POST',
       path: basePath,
       bodyParams: params,
     });
   }
+
+  /**
+   * Invite a waitlist entry.
+   * @param id The waitlist entry ID.
+   * @param params Optional parameters (e.g., `ignoreExisting`).
+   */
+  public async invite(id: string, params: WaitlistEntryInviteParams = {}) {
+    this.requireId(id);
+
+    return this.request<WaitlistEntry>({
+      method: 'POST',
+      path: joinPaths(basePath, id, 'invite'),
+      bodyParams: params,
+    });
+  }
+
+  /**
+   * Reject a waitlist entry.
+   * @param id The waitlist entry ID.
+   */
+  public async reject(id: string) {
+    this.requireId(id);
+
+    return this.request<WaitlistEntry>({
+      method: 'POST',
+      path: joinPaths(basePath, id, 'reject'),
+    });
+  }
+
+  /**
+   * Delete a waitlist entry.
+   * @param id The waitlist entry ID.
+   */
+  public async delete(id: string) {
+    this.requireId(id);
+
+    return this.request<DeletedObject>({
+      method: 'DELETE',
+      path: joinPaths(basePath, id),
+    });
+  }
 }