docs: add TSDoc for payment processor + generate docs (#5917)

* added tsdocs for payment processor

* generated reference for payment processor

packages/medusa/src/models/payment-session.ts

@@ -13,11 +13,31 @@ import { generateEntityId } from "../utils"
 import { DbAwareColumn, resolveDbType } from "../utils/db-aware-column"
 import { Cart } from "./cart"
 
+/**
+ * @enum
+ * 
+ * The status of a payment session.
+ */
 export enum PaymentSessionStatus {
+  /**
+   * The payment is authorized.
+   */
   AUTHORIZED = "authorized",
+  /**
+   * The payment is pending.
+   */
   PENDING = "pending",
+  /**
+   * The payment requires an action.
+   */
   REQUIRES_MORE = "requires_more",
+  /**
+   * An error occurred while processing the payment.
+   */
   ERROR = "error",
+  /**
+   * The payment is canceled.
+   */
   CANCELED = "canceled",
 }