chore(master): release 1.18.0 (#49)

chore: remove unnecessary test file from .gitignore and add sample test release JSON for local testing

.github/workflows/test.yml

@@ -11,4 +11,15 @@ jobs:
       - name: Github Releases To Discord
         uses: ./ # Uses an action in the root directory
         with:
-          webhook_url: ${{ secrets.WEBHOOK_URL }}
+          webhook_url: ${{ inputs.WEBHOOK_URL }}
+          color: ${{ inputs.COLOR }}
+          username: ${{ inputs.USERNAME }}
+          avatar_url: ${{ inputs.AVATAR_URL }}
+          custom_html_url: ${{ inputs.CUSTOM_HTML_URL }}
+          content: ${{ inputs.CONTENT }}
+          footer_title: ${{ inputs.FOOTER_TITLE }}
+          footer_icon_url: ${{ inputs.FOOTER_ICON_URL }}
+          footer_timestamp: ${{ inputs.FOOTER_TIMESTAMP }}
+          max_description: ${{ inputs.MAX_DESCRIPTION }}
+          reduce_headings: ${{ inputs.REDUCE_HEADINGS }}
+          remove_github_reference_links: ${{ inputs.REMOVE_GITHUB_REFERENCE_LINKS }}

.github/workflows/update-semver-tags.yml

@@ -0,0 +1,15 @@
+name: Update SemVer Tags
+on:
+  push:
+    branches-ignore:
+      - '**'
+    tags:
+      - 'v*.*.*'
+
+jobs:
+  update_semver:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Update semver tags
+        uses: haya14busa/action-update-semver@v1

.gitignore

@@ -2,3 +2,8 @@
 *.iml
 out
 gen
+.env
+release.json
+repository.json
+user.json
+tests/sample-test-release-v2.json

CHANGELOG.md

@@ -1,5 +1,97 @@
 # Changelog
 
+## [1.18.0](https://github.com/SethCohen/github-releases-to-discord/compare/v1.17.0...v1.18.0) (2025-06-17)
+
+
+### Features
+
+* **index.js:** enhance sendWebhook function to handle rate limits with retries for improved reliability when sending requests to Discord ([feb5a40](https://github.com/SethCohen/github-releases-to-discord/commit/feb5a402377bc3da9cb9ea788964ece4e56f48cd))
+
+
+### Miscellaneous
+
+* remove unnecessary test file from .gitignore and add sample test release JSON for local testing ([82d906c](https://github.com/SethCohen/github-releases-to-discord/commit/82d906cc6f29adbe413b3f26b55deafc3f08ceee))
+* update README for clarity and conciseness, improve formatting, and add new sections for better user guidance ([82d906c](https://github.com/SethCohen/github-releases-to-discord/commit/82d906cc6f29adbe413b3f26b55deafc3f08ceee))
+
+## [1.17.0](https://github.com/SethCohen/github-releases-to-discord/compare/v1.16.2...v1.17.0) (2025-06-17)
+
+
+### Features
+
+* **workflow:** add GitHub Actions workflow to automatically update SemVer tags on tag push events ([e768ce1](https://github.com/SethCohen/github-releases-to-discord/commit/e768ce10237a6100cccd7e80b2e994e9a2609150))
+
+## [1.16.2](https://github.com/SethCohen/github-releases-to-discord/compare/v1.16.1...v1.16.2) (2024-10-18)
+
+
+### Documentation
+
+* update README output example ([6aa0dd9](https://github.com/SethCohen/github-releases-to-discord/commit/6aa0dd988c547f3b3a73463bc6e69d944621c613))
+
+## [1.16.1](https://github.com/SethCohen/github-releases-to-discord/compare/v1.16.0...v1.16.1) (2024-10-18)
+
+
+### Bug Fixes
+
+* correct conversion of standalone PR, issue, and changelog URLs to markdown format ([4786949](https://github.com/SethCohen/github-releases-to-discord/commit/47869497ed80cf0d6188692d82d71dff7a55dffe)), closes [#38](https://github.com/SethCohen/github-releases-to-discord/issues/38)
+
+
+### Documentation
+
+* update README with details on markdown link conversion and other features ([9737dc9](https://github.com/SethCohen/github-releases-to-discord/commit/9737dc900274be227db48f8e23c715aa00b4af59))
+
+## [1.16.0](https://github.com/SethCohen/github-releases-to-discord/compare/v1.15.3...v1.16.0) (2024-10-18)
+
+
+### Features
+
+* add function to convert PR, issue, and changelog links to markdown format ([07c2e1c](https://github.com/SethCohen/github-releases-to-discord/commit/07c2e1c3e60591d601b5d4b5bd4fc90e599867f8)), closes [#32](https://github.com/SethCohen/github-releases-to-discord/issues/32)
+
+## [1.15.3](https://github.com/SethCohen/github-releases-to-discord/compare/v1.15.2...v1.15.3) (2024-10-18)
+
+
+### Documentation
+
+* add contribution guidelines to README.md ([5fd64bf](https://github.com/SethCohen/github-releases-to-discord/commit/5fd64bf266cea87ab4952ef9a4c6aaf099f266bc))
+* update version reference in README.md ([93d02ce](https://github.com/SethCohen/github-releases-to-discord/commit/93d02ce8714c5f3e201f5b379422e978b837774b))
+
+
+### Miscellaneous
+
+* update .gitignore ([3449e38](https://github.com/SethCohen/github-releases-to-discord/commit/3449e38629b0c40dde5af524e2fef220dab24ead))
+* update package-lock.json ([5dc4108](https://github.com/SethCohen/github-releases-to-discord/commit/5dc41089e63d18b5b191533c34cdddeab34a07e8))
+
+## [1.15.2](https://github.com/SethCohen/github-releases-to-discord/compare/v1.15.1...v1.15.2) (2024-10-18)
+
+
+### Bug Fixes
+
+* improve [@mention](https://github.com/mention) parsing for GitHub usernames ([#33](https://github.com/SethCohen/github-releases-to-discord/issues/33)) ([925765f](https://github.com/SethCohen/github-releases-to-discord/commit/925765f099dcdc3b12316eaa6dc3c17506734b51))
+
+## [1.15.1](https://github.com/SethCohen/github-releases-to-discord/compare/v1.15.0...v1.15.1) (2024-10-04)
+
+
+### Documentation
+
+* updated README.md ([613ba26](https://github.com/SethCohen/github-releases-to-discord/commit/613ba269d7fe40e97040da19de58b0ae00b47aaf))
+
+
+### Miscellaneous
+
+* added test envs to .gitignore ([735cca9](https://github.com/SethCohen/github-releases-to-discord/commit/735cca9de37b345e69b0c74ff761610eab6f1fd1))
+* updated test action ([305fe92](https://github.com/SethCohen/github-releases-to-discord/commit/305fe9299dddb3a514f2b1692773570862c34d46))
+
+
+### Code Refactoring
+
+* code cleanup ([5ca1453](https://github.com/SethCohen/github-releases-to-discord/commit/5ca1453a69f962930450a9f77d4e20cc37e4110f))
+
+## [1.15.0](https://github.com/SethCohen/github-releases-to-discord/compare/v1.14.0...v1.15.0) (2023-12-14)
+
+
+### Features
+
+* added clip description at last newline ([#25](https://github.com/SethCohen/github-releases-to-discord/issues/25)) ([97a4813](https://github.com/SethCohen/github-releases-to-discord/commit/97a481333d0b902f599b12f03b47c4a6cbfa5e52))
+
 ## [1.14.0](https://github.com/SethCohen/github-releases-to-discord/compare/v1.13.1...v1.14.0) (2023-12-11)
 
 

README.md

@@ -1,28 +1,50 @@
-# GitHub Releases To Discord Action
-A GitHub action that parses a GitHub release and posts it to a Discord channel as a stylized Discord webhook.
+# GitHub Releases to Discord Action
+
+Easily notify your Discord community about new GitHub releases! This GitHub Action automatically sends a beautifully formatted Discord embed message with your release notes whenever you publish a release on GitHub.
+
+**Main Benefits:**
+
+- Instantly share release changelogs with your Discord server.
+- Highly customizable message appearance and content.
+- Simple setup—no coding required.
+- Supports advanced formatting and filtering for professional notifications.
 
 ---
-## Output
-![output](https://i.imgur.com/Zf3TXtb.png)
 
-## Configuration
+## Features
 
-| Variable        | Required | Default                                                                                               | Description                                     |
-|-----------------|----------|-------------------------------------------------------------------------------------------------------|-------------------------------------------------|
-| webhook_url     | ✔        |                                                                                                       | Discord's webhook url. Use GH repo secrets.     |
-| color           | ❌       | "2105893"                                                                                             | Decimal color value for embed.                  |
-| username        | ❌       |                                                                                                       | String username for webhook.                    |
-| avatar_url      | ❌       |                                                                                                       | String url to webhook avatar picture.           |
-| content         | ❌       |                                                                                                       | String content for webhook.                     |
-| footer_title    | ❌       |                                                                                                       | String title for the webhook footer.            |
-| footer_icon_url | ❌       |                                                                                                       | String url for the webhook footer picture.      |
-| footer_timestamp| ❌       |                                                                                                       | Boolean to enable footer timestamp.             |
-| max_description | ❌       | "4096"                                                                                                | Max length for the description.                 |
-| reduce_headings | ❌       | false                                                                                                 | Converts H3 to bold, h2 to bold & underline.    |
+- **Automatic Release Notifications:** Sends a Discord embed when a GitHub release is published.
+- **Clean Formatting:**
+  - Removes carriage returns and HTML comments.
+  - Optimizes whitespace and paragraph spacing.
+- **Mention & Link Handling:**
+  - Converts `@mentions` to clickable GitHub profile links.
+  - Converts PR, issue, and changelog URLs to Markdown links.
+  - Optionally removes PR, commit, and issue links for cleaner messages.
+- **Heading Reduction:**
+  - Optionally reduces heading sizes for compact display.
+- **Custom Embed Appearance:**
+  - Set color, username, avatar, footer, and more.
+- **Length Management:**
+  - Ensures messages fit Discord's embed limits, trimming and linking as needed.
+- **Error Handling:**
+  - Clear errors for missing or invalid inputs.
+- **Easy Integration:**
+  - Works with any public or private repository.
 
-## Example Usage
+---
+
+## Quick Start
+
+### 1. Create a Discord Webhook
+
+- Go to your Discord server settings → **Integrations** → **Webhooks**.
+- Click **Create Webhook** and copy the webhook URL.
+
+### 2. Add the Action to Your Workflow
+
+Create (or update) `.github/workflows/github-releases-to-discord.yml`:
 
-`.github/workflows/github-releases-to-discord.yml`
 ```yaml
 on:
   release:
@@ -34,8 +56,8 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v3
-      - name: Github Releases To Discord
-        uses: SethCohen/github-releases-to-discord@v1.13.1
+      - name: GitHub Releases to Discord
+        uses: SethCohen/github-releases-to-discord@v1
         with:
           webhook_url: ${{ secrets.WEBHOOK_URL }}
           color: "2105893"
@@ -43,19 +65,118 @@ jobs:
           avatar_url: "https://cdn.discordapp.com/avatars/487431320314576937/bd64361e4ba6313d561d54e78c9e7171.png"
           content: "||@everyone||"
           footer_title: "Changelog"
-          footer_icon_url: "https://cdn.discordapp.com/avatars/487431320314576937/bd64361e4ba6313d561d54e78c9e7171.png"
-          footer_timestamp: true
+          reduce_headings: true
 ```
 
-## Setup Instructions
-1. Open your **Server Settings** and head into the **Integrations** tab:
-2. Click the "**Create Webhook**" button to create a new webhook!
-   ![](https://support.discord.com/hc/article_attachments/1500000463501/Screen_Shot_2020-12-15_at_4.41.53_PM.png)
-   ![](https://support.discord.com/hc/article_attachments/360101553853/Screen_Shot_2020-12-15_at_4.51.38_PM.png)
-3. Copy the webhook url
-4. Create a new GitHub repository secret called WEBHOOK_URL and paste the webhook url into it.
-   ![](https://i.imgur.com/hAaNOds.png)
-5. Save the secret.
-6. Add the secret to your action configuration.
+### 3. Add Your Webhook URL as a Secret
 
-And you're done! Whenever you create a new release, the workflow should run and, if properly setup, post to your specified Discord channel.
+- In your GitHub repo, go to **Settings → Secrets and variables → Actions**.
+- Add a new secret named `WEBHOOK_URL` and paste your Discord webhook URL.
+
+---
+
+## Configuration Options
+
+| Input Name                    | Required | Default     | Description                                                        |
+|-------------------------------|----------|-------------|--------------------------------------------------------------------|
+| `webhook_url`                 | ✔        |             | Discord webhook URL (use a GitHub secret).                         |
+| `color`                       | ❌       | 2105893     | Embed color (decimal).                                             |
+| `username`                    | ❌       |             | Webhook username.                                                  |
+| `avatar_url`                  | ❌       |             | Webhook avatar image URL.                                          |
+| `custom_html_url`             | ❌       |             | Custom URL for the embed title (overrides GitHub release URL).     |
+| `content`                     | ❌       |             | Additional message content (e.g., `@everyone`).                    |
+| `footer_title`                | ❌       |             | Footer title.                                                      |
+| `footer_icon_url`             | ❌       |             | Footer icon image URL.                                             |
+| `footer_timestamp`            | ❌       | false       | Show timestamp in footer (`true`/`false`).                         |
+| `max_description`             | ❌       | 4096        | Max description length (Discord limit: 4096).                      |
+| `remove_github_reference_links`| ❌      | false       | Remove PR, commit, and issue links from the description.           |
+| `reduce_headings`             | ❌       | false       | Reduce heading sizes for compact display.                          |
+
+---
+
+## Example Output
+
+![Discord Embed Example](https://i.imgur.com/ovr0gTL.png)
+
+---
+
+## Best Practices & Notes
+
+- **Use Secrets for Webhook URLs:** Never commit your Discord webhook URL directly to your repository.
+- **Discord Embed Limits:**
+  - Title: 256 characters max
+  - Description: 4096 characters max
+  - The action will trim and link if limits are exceeded.
+- **Release Body Formatting:**
+  - Use Markdown in your release notes for best results.
+- **Private Repos:**
+  - The action works for both public and private repositories.
+
+---
+
+## Troubleshooting & FAQ
+
+**Q: The action didn't post to Discord!**
+
+- Check that your webhook URL is correct and not expired.
+- Ensure the `webhook_url` secret is set in your repository.
+- Review the Actions log for error messages.
+
+**Q: My message is cut off.**
+
+- Discord has strict embed limits. The action trims long messages and adds a link if needed.
+
+**Q: How do I customize the embed?**
+
+- Use the configuration options above to set color, username, avatar, footer, and more.
+
+**Q: Can I mention everyone or specific roles?**
+
+- Use the `content` input (e.g., `content: "@everyone"`).
+
+---
+
+## Contributing
+
+We welcome contributions! To get started:
+
+1. **Fork** this repository.
+2. **Clone** your fork and run `npm install`.
+3. **Create a test release payload:**
+   - Copy `tests/sample-test-release.json` and edit as needed.
+4. **Create a `.env` file** in the root with your webhook and config (see below):
+
+   ```env
+   INPUT_WEBHOOK_URL=your_webhook_url
+   INPUT_COLOR=2105893
+   ...
+   ```
+
+5. **Test locally** with [`act`](https://github.com/nektos/act):
+
+   ```bash
+   act release -e tests/sample-test-release.json
+   ```
+
+6. **Make your changes** and commit using [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).
+7. **Open a pull request** with a clear description of your changes.
+
+---
+
+## License
+
+[MIT License](LICENSE)
+
+---
+
+## Support & Feedback
+
+- **Issues:** [Open an issue](https://github.com/SethCohen/github-releases-to-discord/issues) for bugs, questions, or feature requests.
+- **Pull Requests:** Contributions are welcome—see above!
+
+---
+
+## Acknowledgements
+
+- Inspired by the needs of open source maintainers and Discord communities.
+- Built and maintained by [SethCohen](https://github.com/SethCohen).

action.yml

@@ -15,6 +15,9 @@ inputs:
   avatar_url:
     description: String url to webhook avatar picture.
     required: false
+  custom_html_url:
+    description: If filled, replaces github's release url with your custom html url.
+    required: false
   content:
     description: String content for webhook.
     required: false
@@ -31,6 +34,10 @@ inputs:
     description: Max length for the description.
     required: false
     default: '4096'
+  remove_github_reference_links:
+    description: Remove any PR, commit, and issue links from the description.
+    required: false
+    default: 'false'
   reduce_headings:
     description: Converts H3 to bold, h2 to bold & underline.
     required: false
@@ -40,4 +47,4 @@ runs:
   main: 'index.js'
 branding:
   icon: file-text
-  color: blue
+  color: blue

index.js

@@ -2,172 +2,277 @@ import core from '@actions/core';
 import github from '@actions/github';
 import fetch from 'node-fetch';
 
+/**
+ * Removes carriage return characters.
+ * @param {string} text The input text.
+ * @returns {string} The text without carriage return characters.
+ */
+const removeCarriageReturn = (text) => text.replace(/\r/g, '');
+
+/**
+ * Removes HTML comments.
+ * @param {string} text The input text.
+ * @returns {string} The text without HTML comments.
+ */
+const removeHTMLComments = (text) => text.replace(/<!--.*?-->/gs, '');
+
+/**
+ * Reduces redundant newlines and spaces.
+ * Keeps a maximum of 2 newlines to provide spacing between paragraphs.
+ * @param {string} text The input text.
+ * @returns {string} The text with reduced newlines.
+ */
+const reduceNewlines = (text) => text.replace(/\n\s*\n/g, (ws) => {
+    const nlCount = (ws.match(/\n/g) || []).length;
+    return nlCount >= 2 ? '\n\n' : '\n';
+});
+
+/**
+ * Converts @mentions to GitHub profile links for valid GitHub usernames.
+ * @param {string} text The input text.
+ * @returns {string} The text with valid @mentions converted to links.
+ */
+const convertMentionsToLinks = (text) => text.replace(
+    /(?<![/@\w])@((?!-)(?!.*?--)[a-zA-Z0-9](?:-?[a-zA-Z0-9]){0,37})(?![.\w/-])(?!.*\])/g,
+    (match, name) => `[@${name}](https://github.com/${name})`
+);
+
+/**
+ * Removes any GitHub PR, commit, or issue links from the text, including markdown links.
+ * @param {string} text The input text.
+ * @returns {string} The text without GitHub PR and commit links.
+ */
+const removeGithubReferenceLinks = (text) => text
+    // Remove markdown links to PRs, commits, and issues
+    .replace(/\[[^\]]*\]\(https:\/\/github\.com\/[^(\s)]+\/pull\/\d+\)/g, '')
+    .replace(/\[[^\]]*\]\(https:\/\/github\.com\/[^(\s)]+\/commit\/\w+\)/g, '')
+    .replace(/\[[^\]]*\]\(https:\/\/github\.com\/[^(\s)]+\/issues\/\d+\)/g, '')
+    // Remove bare PR, commit, and issue URLs
+    .replace(/https:\/\/github\.com\/[^(\s)]+\/pull\/\d+/g, '')
+    .replace(/https:\/\/github\.com\/[^(\s)]+\/commit\/\w+/g, '')
+    .replace(/https:\/\/github\.com\/[^(\s)]+\/issues\/\d+/g, '')
+    // Remove empty parentheses left behind
+    .replace(/\(\s*\)/g, '');
+
+/**
+ * Reduces headings to a smaller format if 'reduce_headings' is enabled.
+ * Converts H3 to bold+underline, H2 to bold.
+ * @param {string} text The input text.
+ * @returns {string} The text with reduced heading sizes.
+ */
+const reduceHeadings = (text) => text
+    .replace(/^###\s+(.+)$/gm, '**__$1__**') // Convert H3 to bold + underline
+    .replace(/^##\s+(.+)$/gm, '**$1**');     // Convert H2 to bold
+
+/**
+ * Converts PR, issue, and changelog links to markdown format, ignoring existing markdown links.
+ * - PR links: `https://github.com/OWNER/REPO/pull/1` -> `[PR #1](https://github.com/OWNER/REPO/pull/1)`
+ * - Issue links: `https://github.com/OWNER/REPO/issues/1` -> `[Issue #30](https://github.com/OWNER/REPO/issues/1)`
+ * - Changelog links: `https://github.com/OWNER/REPO/compare/v1.0.0...v1.1.0` -> `[v1.0.0...v1.1.0](https://github.com/OWNER/REPO/compare/v1.0.0...v1.1.0)`
+ * @param {string} text The input text.
+ * @returns {string} The text with links converted to markdown format.
+ */
+const convertLinksToMarkdown = (text) => {
+    // Extract existing markdown links and replace them with placeholders
+    const markdownLinks = [];
+    const textWithoutMarkdownLinks = text.replace(/\[.*?\]\(.*?\)/g, (link) => {
+        markdownLinks.push(link);
+        return `__MARKDOWN_LINK_PLACEHOLDER_${markdownLinks.length - 1}__`;
+    });
+
+    // Convert standalone PR, issue, and changelog URLs to markdown format
+    let processedText = textWithoutMarkdownLinks
+        .replace(/https:\/\/github\.com\/([\w-]+)\/([\w-]+)\/pull\/(\d+)/g, (match, owner, repo, prNumber) => `[PR #${prNumber}](${match})`)
+        .replace(/https:\/\/github\.com\/([\w-]+)\/([\w-]+)\/issues\/(\d+)/g, (match, owner, repo, issueNumber) => `[Issue #${issueNumber}](${match})`)
+        .replace(/https:\/\/github\.com\/([\w-]+)\/([\w-]+)\/compare\/([v\w.-]+)\.\.\.([v\w.-]+)/g, (match, owner, repo, fromVersion, toVersion) => `[${fromVersion}...${toVersion}](${match})`);
+
+    // Reinsert the original markdown links
+    return processedText.replace(/__MARKDOWN_LINK_PLACEHOLDER_(\d+)__/g, (match, index) => markdownLinks[parseInt(index, 10)]);
+};
+
 /**
  * Stylizes a markdown body into an appropriate embed message style.
- *  Remove HTML comments (commonly added by 'Generate release notes' button)
- *  Better URL linking for common Github links: PRs, Issues, Compare
- *  Redundant whitespace and newlines removed, keeping at max 2 to provide space between paragraphs
- *  Trim leading/trailing whitespace
- *  If reduce_headings:
- *   H3s converted to bold and underlined
- *   H2s converted to bold
- * @param {string} description
+ * @param {string} description The description to format.
+ * @returns {string} The formatted description.
  */
 const formatDescription = (description) => {
-    let edit = description
-        .replace(/<!--.*?-->/gs, '')
-        .replace(
-            new RegExp(
-                "https://github.com/(.+)/(.+)/(issues|pull|commit|compare)/(\\S+)",
-                "g"
-            ),
-            (match, user, repo, type, id) => {
-                return `[${getTypePrefix(type) + id}](${match})`
-            }
-        )
-        .replace(/\n\s*\n/g, (ws) => {
-            const nlCount = (ws.match(/\n/g) || []).length
-            return nlCount >= 2 ? '\n\n' : '\n'
-        })
-        .trim()
+    let edit = removeCarriageReturn(description);
+    edit = removeHTMLComments(edit);
+    edit = reduceNewlines(edit);
+        
+    if (core.getBooleanInput('remove_github_reference_links')) {
+        edit = removeGithubReferenceLinks(edit);
+    }
+    edit = convertMentionsToLinks(edit);
+    edit = convertLinksToMarkdown(edit);
+    edit = edit.trim();
 
     if (core.getBooleanInput('reduce_headings')) {
-        edit = edit
-            .replace(/^###\s+(.+)$/gm, '**__$1__**')
-            .replace(/^##\s+(.+)$/gm, '**$1**')
+        edit = reduceHeadings(edit);
     }
 
-    return edit
-}
+    return edit;
+};
 
 /**
- * Get a prefix to use for Github link display
- * @param {'issues' | 'pull' | 'commit' | 'compare'} type 
+ * Gets the max description length, defaulting to 4096 if not set or invalid.
+ * @returns {number} The max description length.
  */
-function getTypePrefix (type) {
-    switch (type) {
-        case 'issues':
-            return 'Issue #'
-        case 'pull':
-            return 'PR #'
-        case 'commit':
-            return 'Commit #'
-        case 'compare':
-            return ''
-        default:
-            return '#'
-    }
-}
-
-/**
- * Gets the max description length if set to a valid number,
- * otherwise the default of 4096
- */
-function getMaxDescription () {
+const getMaxDescription = () => {
     try {
-        const max = core.getInput('max_description')
-        if (typeof max === 'string' && max.length) {
-            // 4096 is max for Embed Description
-            // https://discord.com/developers/docs/resources/channel#embed-object-embed-limits
-            return Math.min(parseInt(max, 10), 4096)
+        const max = core.getInput('max_description');
+        if (max && !isNaN(max)) {
+            return Math.min(parseInt(max, 10), 4096);
         }
     } catch (err) {
-        core.warning(`max_description not a valid number: ${err}`)
+        core.warning(`Invalid max_description: ${err}`);
     }
-    return 4096
-}
+    return 4096;
+};
 
 /**
- * Get the context of the action, returns a GitHub Release payload.
+ * Get the context of the action, returning a GitHub Release payload.
+ * @returns {object} The context with release details.
  */
-function getContext () {
-    const payload = github.context.payload;
-
+const getContext = () => {
+    const { release } = github.context.payload;
     return {
-        body: payload.release.body,
-        name: payload.release.name,
-        html_url: payload.release.html_url
-    }
-}
+        body: release.body,
+        name: release.name,
+        html_url: release.html_url
+    };
+};
 
 /**
- * 
- * @param {string} str
- * @param {number} maxLength
- * @param {string=} url
+ * Limits the string to a maximum length, optionally adding a URL or clipping at a newline.
+ * @param {string} str The string to limit.
+ * @param {number} maxLength The maximum allowed length.
+ * @param {string} [url] Optional URL for linking the truncated text.
+ * @param {boolean} [clipAtLine=false] Whether to clip at the nearest newline.
+ * @returns {string} The limited string.
  */
-function limit(str, maxLength, url) {
-    if (str.length <= maxLength)
-        return str
-    let replacement = '…'
-    if (url) {
-        replacement = `([${replacement}](${url}))`
-    }
-    maxLength = maxLength - replacement.length
-    str = str.substring(0, maxLength)
+const limitString = (str, maxLength, url, clipAtLine = false) => {
+    if (str.length <= maxLength) return str;
 
-    const lastWhitespace = str.search(/[^\s]*$/)
-    if (lastWhitespace > -1) {
-        str = str.substring(0, lastWhitespace)
+    const replacement = url
+        ? `${clipAtLine ? '\n' : ''}([…](${url}))`
+        : (clipAtLine ? '\n…' : '…');
+
+    maxLength -= replacement.length;
+    str = str.substring(0, maxLength);
+
+    const lastNewline = str.search(new RegExp(`[^${clipAtLine ? '\n' : '\s'}]*$`));
+    if (lastNewline > -1) {
+        str = str.substring(0, lastNewline);
     }
 
-    return str + replacement
-}
+    return str + replacement;
+};
 
 /**
- * Handles the action.
- * Get inputs, creates a stylized response webhook, and sends it to the channel.
+ * Builds the embed message for the Discord webhook.
+ * @param {string} name The title or name of the release.
+ * @param {string} html_url The URL of the release.
+ * @param {string} description The formatted description of the release.
+ * @returns {object} The embed message to send in the webhook.
  */
-async function run () {
+const buildEmbedMessage = (name, html_url, description) => {
+    const embedMsg = {
+        title: limitString(name, 256),
+        url: html_url,
+        color: core.getInput('color'),
+        description: limitString(description, Math.min(getMaxDescription(), 6000 - name.length)),
+        footer: {}
+    };
+
+    if (core.getInput('custom_html_url')) {
+        embedMsg.url = core.getInput('custom_html_url');
+    }
+    if (core.getInput('footer_title')) {
+        embedMsg.footer.text = limitString(core.getInput('footer_title'), 2048);
+    }
+    if (core.getInput('footer_icon_url')) {
+        embedMsg.footer.icon_url = core.getInput('footer_icon_url');
+    }
+    if (core.getInput('footer_timestamp') === 'true') {
+        embedMsg.timestamp = new Date().toISOString();
+    }
+
+    return embedMsg;
+};
+
+/**
+ * Sends the webhook request to Discord, handling rate limits (429) with retries.
+ * @param {string} webhookUrl The URL of the Discord webhook.
+ * @param {object} requestBody The payload to send in the webhook.
+ * @param {number} [maxRetries=3] Maximum number of retries on rate limit.
+ */
+const sendWebhook = async (webhookUrl, requestBody, maxRetries = 3) => {
+    let attempt = 0;
+    while (attempt <= maxRetries) {
+        try {
+            const response = await fetch(`${webhookUrl}?wait=true`, {
+                method: 'POST',
+                body: JSON.stringify(requestBody),
+                headers: { 'Content-Type': 'application/json' }
+            });
+            if (response.status === 429) {
+                // Rate limited, get retry-after
+                const retryAfter = parseInt(response.headers.get('retry-after') || '1', 10);
+                core.warning(`Rate limited by Discord. Retrying after ${retryAfter} seconds (attempt ${attempt + 1}/${maxRetries})`);
+                await new Promise(res => setTimeout(res, retryAfter * 1000));
+                attempt++;
+                continue;
+            }
+            const data = await response.json();
+            if (!response.ok) {
+                core.setFailed(`Discord webhook error: ${JSON.stringify(data)}`);
+            } else {
+                core.info(JSON.stringify(data));
+            }
+            break;
+        } catch (err) {
+            core.setFailed(err.message);
+            break;
+        }
+    }
+    if (attempt > maxRetries) {
+        core.setFailed('Exceeded maximum Discord webhook retry attempts due to rate limiting.');
+    }
+};
+
+/**
+ * Builds the request body for the Discord webhook.
+ * @param {object} embedMsg The embed message to include in the request body.
+ * @returns {object} The request body for the webhook.
+ */
+const buildRequestBody = (embedMsg) => {
+    return {
+        embeds: [embedMsg],
+        ...(core.getInput('username') && { username: core.getInput('username') }),
+        ...(core.getInput('avatar_url') && { avatar_url: core.getInput('avatar_url') }),
+        ...(core.getInput('content') && { content: core.getInput('content') })
+    };
+};
+
+
+/**
+ * Main function to handle the action: get inputs, format the message, and send the webhook.
+ */
+const run = async () => {
     const webhookUrl = core.getInput('webhook_url');
-    const color = core.getInput('color');
-    const username = core.getInput('username');
-    const avatarUrl = core.getInput('avatar_url');
-    const content = core.getInput('content');
-    const footerTitle = core.getInput('footer_title');
-    const footerIconUrl = core.getInput('footer_icon_url');
-    const footerTimestamp = core.getInput('footer_timestamp');
-
-    if (!webhookUrl) return core.setFailed('webhook_url not set. Please set it.');
-
-    const {body, html_url, name} = getContext();
+    if (!webhookUrl) return core.setFailed('webhook_url not set.');
 
+    const { body, html_url, name } = getContext();
     const description = formatDescription(body);
 
-    let embedMsg = {
-        title: limit(name, 256),
-        url: html_url,
-        color: color,
-        description: description,
-        footer: {}
-    }
+    const embedMsg = buildEmbedMessage(name, html_url, description);
 
-    if (footerTitle != '') embedMsg.footer.text = limit(footerTitle, 2048);
-    if (footerIconUrl != '') embedMsg.footer.icon_url = footerIconUrl;
-    if (footerTimestamp == 'true') embedMsg.timestamp = new Date().toISOString();
+    const requestBody = buildRequestBody(embedMsg);
 
-    let embedSize = embedMsg.title.length + (embedMsg.footer?.text?.length ?? 0)
-    embedMsg.description = limit(embedMsg.description, Math.min(getMaxDescription(), 6000 - embedSize), embedMsg.url)
-
-    let requestBody = {
-        embeds: [embedMsg]
-    }
-
-    if (username != '') requestBody.username = username;
-    if (avatarUrl != '') requestBody.avatar_url = avatarUrl;
-    if (content != '') requestBody.content = content;
-
-    const url = `${webhookUrl}?wait=true`;
-    fetch(url, {
-        method: 'post',
-        body: JSON.stringify(requestBody),
-        headers: { 'Content-Type': 'application/json' }
-    })
-        .then(res => res.json())
-        .then(data => core.info(JSON.stringify(data)))
-        .catch(err => core.info(err))
-}
+    await sendWebhook(webhookUrl, requestBody);
+};
 
 run()
-    .then(() => {core.info('Action completed successfully')})
-    .catch(err => {core.setFailed(err.message)})
+    .then(() => core.info('Action completed successfully'))
+    .catch(err => core.setFailed(err.message));

node_modules/.package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "github-releases-to-discord",
-  "version": "1.13.0",
+  "version": "1.15.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "github-releases-to-discord",
-  "version": "1.14.0",
+  "version": "1.18.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "github-releases-to-discord",
-      "version": "1.14.0",
+      "version": "1.18.0",
       "license": "MIT",
       "dependencies": {
         "@actions/core": "^1.10.1",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-releases-to-discord",
-  "version": "1.14.0",
+  "version": "1.18.0",
   "description": "A GitHub Action that automatically sends a stylized Discord webhook of a GitHub Release description to a specified Discord channel.",
   "type": "module",
   "main": "index.js",

tests/sample-test-release.json

@@ -0,0 +1,12 @@
+{
+    "action": "published",
+    "release": {
+        "html_url": "https://example.com/releases/tag/v1.0.0",
+        "name": "v1.0.0",
+        "body": "## [1.0.0](https://example.com/compare/v0.9.0...v1.0.0) (1970-01-01)\n\n### Features\n* **core:** added initial release ([abc1234](https://example.com/commit/abc1234))\n* **api:** implemented endpoints ([def5678](https://example.com/commit/def5678))\n\n### Bug Fixes\n* **ui:** fixed button alignment ([#42](https://example.com/issues/42)) ([789abcd](https://example.com/commit/789abcd))\n\n### Miscellaneous\n* see [PR #7](https://example.com/pull/7) for details\n"
+    },
+    "repository": {
+        "full_name": "example/repo",
+        "html_url": "https://example.com/example/repo"
+    }
+}