chore(backend): Add JSDoc around machines and m2m resource types (#6774)

Author: wobsoriano

.changeset/honest-plants-kneel.md

@@ -0,0 +1,5 @@
+---
+"@clerk/backend": patch
+---
+
+Add JSDoc around Machine and M2M resource types

.typedoc/__tests__/__snapshots__/file-structure.test.ts.snap

@@ -252,6 +252,10 @@ exports[`Typedoc output > should have a deliberate file structure 1`] = `
   "backend/infer-auth-object-from-token.mdx",
   "backend/invitation-status.mdx",
   "backend/invitation.mdx",
+  "backend/m2-m-token.mdx",
+  "backend/machine-scope.mdx",
+  "backend/machine-secret-key.mdx",
+  "backend/machine.mdx",
   "backend/o-auth-application.mdx",
   "backend/organization-invitation-status.mdx",
   "backend/organization-invitation.mdx",

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

@@ -1,5 +1,8 @@
 import type { M2MTokenJSON } from './JSON';
 
+/**
+ * The Backend `M2MToken` object holds information about a machine-to-machine token.
+ */
 export class M2MToken {
   constructor(
     readonly id: string,

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

@@ -1,5 +1,8 @@
 import type { MachineJSON } from './JSON';
 
+/**
+ * The Backend `Machine` object holds information about a machine.
+ */
 export class Machine {
   constructor(
     readonly id: string,

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

@@ -1,5 +1,8 @@
 import type { MachineScopeJSON } from './JSON';
 
+/**
+ * The Backend `MachineScope` object holds information about a machine scope.
+ */
 export class MachineScope {
   constructor(
     readonly fromMachineId: string,

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

@@ -1,5 +1,8 @@
 import type { MachineSecretKeyJSON } from './JSON';
 
+/**
+ * The Backend `MachineSecretKey` object holds information about a machine secret key.
+ */
 export class MachineSecretKey {
   constructor(readonly secret: string) {}