Fix duplicate returns APIKeys

Author: SarahSoutoul

.typedoc/extract-methods.mjs

@@ -1295,7 +1295,7 @@ function buildMethodMdx(decl, ctx, options = {}) {
   /** Prefer the declaration comment (property-style methods document `addListener` on the property, not the signature). */
   const comment = decl.comment ?? sig.comment;
   let description = commentSummaryAndBody(comment);
-  const sigReturns = appendSignatureOnlyReturns(decl.comment, sig.comment);
+  const sigReturns = comment === sig.comment ? '' : appendSignatureOnlyReturns(decl.comment, sig.comment);
   if (sigReturns) {
     description = [description, sigReturns].filter(Boolean).join('\n\n');
   }

packages/shared/src/types/apiKeys.ts

@@ -83,13 +83,14 @@ export interface APIKeysNamespace {
   getAll(params?: GetAPIKeysParams): Promise<ClerkPaginatedResponse<APIKeyResource>>;
   /**
    * Creates a new API key. **The secret is only available in the response from `create()` and cannot be retrieved later.**
-   * @returns A [`APIKeyResource`](https://clerk.com/docs/reference/types/api-key-resource) object that includes the `secret` property.
+   * @returns An [`APIKeyResource`](https://clerk.com/docs/reference/types/api-key-resource) object that includes the `secret` property.
    * > [!WARNING]
    * > Make sure to store the API key secret immediately after creation, as it will not be available again.
    */
   create(params: CreateAPIKeyParams): Promise<APIKeyResource>;
   /**
    * Revokes a given API key by ID.
+   * @returns An [`APIKeyResource`](https://clerk.com/docs/reference/types/api-key-resource) object.
    */
   revoke(params: RevokeAPIKeyParams): Promise<APIKeyResource>;
 }