docs(repo): Add JSdocs to APIKey backend type

.changeset/pretty-ends-deny.md

@@ -0,0 +1,2 @@
+---
+---

packages/backend/src/api/resources/APIKey.ts

@@ -1,22 +1,73 @@
 import type { APIKeyJSON } from './JSON';
 
+/**
+ * The Backend `APIKey` object holds information about an API key.
+ */
 export class APIKey {
   constructor(
+    /**
+     * A unique ID for the API key.
+     */
     readonly id: string,
+    /**
+     * The type of the API key. Currently always `'api_key'`.
+     */
     readonly type: string,
+    /**
+     * The API key's name.
+     */
     readonly name: string,
+    /**
+     * The user or organization ID that the API key is associated with.
+     */
     readonly subject: string,
+    /**
+     * An array of scopes that define what the API key can access.
+     */
     readonly scopes: string[],
+    /**
+     * Custom claims associated with the API key.
+     */
     readonly claims: Record<string, any> | null,
+    /**
+     * A boolean indicating whether the API key has been revoked.
+     */
     readonly revoked: boolean,
+    /**
+     * The reason for revoking the API key, if it has been revoked.
+     */
     readonly revocationReason: string | null,
+    /**
+     * A boolean indicating whether the API key has expired.
+     */
     readonly expired: boolean,
+    /**
+     * The expiration date and time of the API key. `null` if the API key never expires.
+     */
     readonly expiration: number | null,
+    /**
+     * The user ID for the user creating the API key.
+     */
     readonly createdBy: string | null,
+    /**
+     * An optional description for the API key.
+     */
     readonly description: string | null,
+    /**
+     * The date and time when the API key was last used to authenticate a request.
+     */
     readonly lastUsedAt: number | null,
+    /**
+     * The date when the API key was created.
+     */
     readonly createdAt: number,
+    /**
+     * The date when the API key was last updated.
+     */
     readonly updatedAt: number,
+    /**
+     * The API key secret. **This property is only present in the response from [`create()`](/docs/reference/javascript/api-keys#create) and cannot be retrieved later.**
+     */
     readonly secret?: string,
   ) {}