Merge pull request #8 from barrymichaeldoyle/feat/discord-bot

feat: implemented discord bot

Author: barrymichaeldoyle

…ages/action/examples/patch-pulse-bot.yml packages/action/examples/patchpulse.ymlpackages/action/examples/patch-pulse-bot.yml renamed to packages/action/examples/patchpulse.yml packages/action/examples/patch-pulse-bot.yml renamed to packages/action/examples/patchpulse.yml

@@ -1,4 +1,4 @@
-# Example: add this file to your repo at .github/workflows/patch-pulse-bot.yml
+# Example: add this file to your repo at .github/workflows/patchpulse.yml
 #
 # This workflow runs PatchPulse weekly and opens one PR per outdated package (or
 # package group). PRs include the version diff, release notes links, a

packages/docs/.astro/content-assets.mjs

@@ -1,4 +1 @@
-
-
-export default new Map([]);
-		
+export default new Map();

packages/docs/.astro/content-modules.mjs

@@ -4,6 +4,7 @@ export default new Map([
 ["src/content/docs/cli/commands.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fdocs%2Fcli%2Fcommands.mdx&astroContentModuleFlag=true")],
 ["src/content/docs/cli/configuration.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fdocs%2Fcli%2Fconfiguration.mdx&astroContentModuleFlag=true")],
 ["src/content/docs/cli/overview.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fdocs%2Fcli%2Foverview.mdx&astroContentModuleFlag=true")],
+["src/content/docs/discord-bot.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fdocs%2Fdiscord-bot.mdx&astroContentModuleFlag=true")],
 ["src/content/docs/github-action/configuration.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fdocs%2Fgithub-action%2Fconfiguration.mdx&astroContentModuleFlag=true")],
 ["src/content/docs/github-action/overview.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fdocs%2Fgithub-action%2Foverview.mdx&astroContentModuleFlag=true")],
 ["src/content/docs/index.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fdocs%2Findex.mdx&astroContentModuleFlag=true")],

packages/docs/.astro/data-store.json

@@ -51,6 +51,7 @@ export default defineConfig({
           ],
         },
         { label: 'Slack Bot', link: '/slack-bot' },
+        { label: 'Discord Bot', link: '/discord-bot' },
       ],
     }),
   ],

packages/docs/astro.config.mjs

@@ -0,0 +1,56 @@
+---
+interface Props {
+  href: string;
+}
+
+const { href } = Astro.props;
+---
+
+<a class="discord-button" href={href}>
+  <span class="discord-button__label">Add to Discord</span>
+</a>
+
+<style>
+  .discord-button {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-height: 2.75rem;
+    padding: 0.75rem 1.1rem;
+    margin: 1rem 0 1.5rem;
+    border-radius: 0.75rem;
+    border: 1px solid rgba(255, 255, 255, 0.12);
+    background:
+      linear-gradient(180deg, #6a75f7 0%, #5865f2 100%);
+    box-shadow:
+      0 12px 28px rgba(88, 101, 242, 0.28),
+      inset 0 1px 0 rgba(255, 255, 255, 0.14);
+    color: #fff;
+    font-weight: 700;
+    font-size: 0.95rem;
+    line-height: 1;
+    letter-spacing: 0.01em;
+    text-decoration: none;
+    transition:
+      transform 160ms ease,
+      box-shadow 160ms ease,
+      filter 160ms ease;
+  }
+
+  .discord-button:hover {
+    transform: translateY(-1px);
+    box-shadow:
+      0 16px 36px rgba(88, 101, 242, 0.34),
+      inset 0 1px 0 rgba(255, 255, 255, 0.18);
+    filter: brightness(1.03);
+  }
+
+  .discord-button:focus-visible {
+    outline: 2px solid #e0e3ff;
+    outline-offset: 3px;
+  }
+
+  .discord-button__label {
+    white-space: nowrap;
+  }
+</style>

packages/docs/src/components/AddToDiscordButton.astro

@@ -0,0 +1,57 @@
+---
+title: Discord Bot
+description: Get Discord notifications for new package releases in your server channels.
+---
+
+import { Aside } from '@astrojs/starlight/components';
+import AddToDiscordButton from '../../components/AddToDiscordButton.astro';
+
+The Patch Pulse Discord Bot notifies your server whenever a package you depend on releases a new version.
+
+<AddToDiscordButton href="https://grand-yak-92.convex.site/discord/install" />
+
+<Aside type="note">
+  Discord currently gets the base release notification flow. GitHub link
+  backfill and AI-generated release summaries remain Slack-only for now.
+</Aside>
+
+## How it works
+
+Once installed, the bot monitors packages you care about and sends a Discord message when a new version is published to the npm registry.
+
+Discord tracking is channel-based:
+
+- every subscription targets an explicit channel
+- the same package can be tracked in multiple channels
+- filters can be set to patch, minor, or major updates
+
+## Slash commands
+
+Use these commands in your server:
+
+- `/npmtrack package:react`
+- `/npmtrack package:react channel:#frontend`
+- `/npmtrack package:react filter:minor`
+- `/npmuntrack package:react`
+- `/npmuntrack package:react channel:#frontend`
+- `/npmlist`
+
+Command responses are ephemeral, while update notifications are posted into the subscribed channel.
+
+## Install and setup
+
+To add Patch Pulse to your server:
+
+- open [grand-yak-92.convex.site/discord/install](https://grand-yak-92.convex.site/discord/install)
+- choose the target server
+- approve the requested permissions
+
+If you are self-hosting Patch Pulse rather than using the hosted bot, the Discord app setup and environment configuration live in the notifier package docs, not the public user docs site.
+
+## Slack vs Discord
+
+Slack and Discord support the same core package tracking model, but there are a few operational differences:
+
+- Slack has a workspace default channel; Discord does not
+- Slack receives delayed GitHub link backfill and AI summaries; Discord currently does not
+- Discord commands use typed slash-command options instead of Slack's free-text command parsing

packages/docs/src/content/docs/discord-bot.mdx

@@ -35,7 +35,7 @@ The Patch Pulse GitHub Action runs on a schedule, detects outdated dependencies
 
 ## Quick start
 
-Add the following workflow to your repository at `.github/workflows/patch-pulse-bot.yml`:
+Add the following workflow to your repository at `.github/workflows/patchpulse.yml`:
 
 ```yaml
 name: PatchPulse Dependency Bot

packages/docs/src/content/docs/github-action/overview.mdx

@@ -34,6 +34,11 @@ import { CardGrid, LinkCard } from '@astrojs/starlight/components';
     href="./slack-bot"
     description="Get Slack release alerts with GitHub release links and AI-generated summaries for tracked packages."
   />
+  <LinkCard
+    title="Discord Bot"
+    href="./discord-bot"
+    description="Get Discord release alerts in your server channels for the packages you track."
+  />
   <LinkCard
     title="VS Code Extension"
     href="./vscode/overview"

packages/docs/src/content/docs/index.mdx

@@ -13,6 +13,7 @@ Patch Pulse is a suite of tools that help you keep your npm dependencies up to d
 | [GitHub Action](../github-action/overview) | Automatically open PRs for outdated dependencies on a schedule               |
 | [VS Code Extension](../vscode/overview)    | Inline version information directly in your `package.json` files             |
 | [Slack Bot](../slack-bot)                  | Get Slack release alerts with GitHub release links and AI summaries          |
+| [Discord Bot](../discord-bot)              | Get Discord release alerts in your server channels                           |
 
 ## Core concepts