feat(web-api): add markdown_text property to chat.{postEphemeral|postMessage|scheduleMessage|update} methods

[hello-ashleyintech]

Summary

This PR resolves issue #2329 and adds an optional string markdown_text property for ChatPostMessageArguments

Requirements (place an x in each [ ])

• I've read and understood the Contributing Guidelines and have done my best effort to follow them.
• I've read and agree to the Code of Conduct.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.75%. Comparing base (c2a8c84) to head (67ac56a).
⚠️ Report is 1 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2330      +/-   ##
==========================================
+ Coverage   92.74%   92.75%   +0.01%     
==========================================
  Files          38       38              
  Lines       10660    10676      +16     
  Branches      687      692       +5     
==========================================
+ Hits         9887     9903      +16     
  Misses        761      761              
  Partials       12       12              

Flag	Coverage Δ
cli-hooks	95.23% <ø> (ø)
cli-test	94.74% <ø> (ø)
oauth	77.39% <ø> (ø)
socket-mode	61.87% <ø> (ø)
web-api	97.99% <100.00%> (+<0.01%)	⬆️
webhook	96.66% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[zimeg]

@hello-ashleyintech This is looking great! Would it be possible to include this in a few other methods too to match changes of slackapi/python-slack-sdk#1718?

• https://docs.slack.dev/reference/methods/chat.postephemeral
• https://docs.slack.dev/reference/methods/chat.postmessage
• https://docs.slack.dev/reference/methods/chat.schedulemessage
• https://docs.slack.dev/reference/methods/chat.update/

Edit: Oops keyboard shortctus are difficult - sorry for closing this ahhhhgh.

[hello-ashleyintech]

@zimeg great catch! 😄 I will update this expeditiously

[zimeg]

@hello-ashleyintech Nice and so appreciated - this is working well for me! 👁️‍🗨️

An update to the PR title was made just above this but before merging it, the fallback text warning might be nice to update to expect markdown_text too: 🙏 ✨

node-slack-sdk/packages/web-api/src/WebClient.ts

Lines 997 to 998 in dc32203

	const isEmptyText = (args: Record<string, unknown>) =>
	args.text === undefined || args.text === null || args.text === '';

I left a few other comments of jsdoc also and would love to hear your thoughts on such topic! 🔏

[zimeg]

praise: Thank you for adding jsdoc 📚 ✨

thought: Might leaving line breaks to the editor should be an overall change we make? I'm thinking we could perhaps snag this from the kind docs.slack.dev/reference/methods pages in neartimes 🤖

[zimeg]

thought: That "editor" I realize is not so clear but I find this in testing:

[zimeg]

praise: I am a fan of inlining these arguments! 👾

[pedropaccola]

Hey guys, I'm happy to help in order to expedite this release, given the branch isn't from a fork.

@zimeg by adjusting the fallback to consider the markdown fields, do you mean:

const isEmptyText = (args: Record<string, unknown>) =>
    args.text === undefined || args.text === null || args.text === '' || args.markdown_text === undefined || args.markdown_text === null || args.markdown_text === '';

[pedropaccola]

Apparently I don't have permission to push to this branch directly, sorry about that 😢

[zimeg]

@hello-ashleyintech A few final touches on this PR were made in recent commits! After more testing I'm feeling good to merge this 🚢 💨

@pedropaccola Thanks too for sharing this suggestion! A similar change was made in 46359c6 that also adds tests. The investigation is so appreciated 🙏 ✨

[zimeg]

🗣️ note: Including markdown_text here was found to be helpful in avoiding typescript errors since none of the other "content" arguments are required!

⏳ ramble: Otherwise an attachments was expected I noticed-