Intentando aplicar $ref de OpenAPI a mi caso de uso.

Entonces, estoy intentando aplicar $ref en mis documentos OpenApi, pero no estoy seguro de estar haciéndolo correctamente. Tengo algo que luce así por ahora para uno de mis puntos finales:

/**
 * @openapi
 * /api/v2/auth/permissions:
 *   get:
 *     description: Obtener permisos.
 *     responses:
 *       200:
 *         description: Obtener permisos.
 *         content:
 *         application/json:
 *           schema:
 *             $ref: './model/permission.model'
 */

Esto solo muestra la cadena como "string".

Hazme saber si necesitas revisar ese archivo de modelo o cualquier otra cosa.

El archivo permission.model.ts luce así:

interface Permission {
  _id: ID,

  roleId?: string,
  userId?: number,
  groupId?: number
}

const PermissionSchemaFields: Record<keyof Permission, any> = {
  _id: Types.ObjectId,

  roleId: { type: String, required: false }
  userId: { type: Number, required: false }
  groupId: { type: Number, required: false }
}

const PermissionSchema = new Schema(
  PermissionSchemaFields,
  { timestamps: { createdAt: 'createdOn', updatedAt: 'updatedOn'}}
);

export {PermissionSchema, Permission}