@theholocron/holocron-plugin-discord 5.0.0-alpha.182 → 5.0.0-alpha.184

package/README.md

@@ -68,8 +68,10 @@ that need to split the URL into its parts.
 channels, roles and webhooks through the `notifications` capability's `ensure*`
 methods. They use the **Holonet bot**, not a webhook URL:
 
-- `HOLOCRON_DISCORD_BOT_TOKEN` (or `DISCORD_BOT_TOKEN`) — the bot token from
-  the Developer Portal. Only read when a provisioning command runs.
+- `HOLOCRON_DISCORD_BOT_TOKEN` (or `DISCORD_BOT_TOKEN`), or the keyring entry
+  `discord.holonet` (`holocron auth set discord.holonet <token>`) — the bot token
+  from the Developer Portal. Only read when a provisioning command runs, or when
+  `holocron doctor` checks a provider that has a `guildId`; posting never needs it.
 - `guildId` — the server id (not a secret), set in the provider options.
 - `layout` — categories, channels (each optionally with a `webhook`) and roles.
 

package/dist/index.d.mts

@@ -37,6 +37,15 @@ declare class DiscordNotifications implements Notifications {
   bot?: () => DiscordBotClient);
   get layout(): NotificationsLayout | undefined;
   send(channel: string, message: string): Promise<void>;
+  /**
+   * `holocron doctor`: the bot token is valid and can see the configured server.
+   * Null when no `guildId` is set -- a post-only config has no bot to check. A
+   * `layout` without a `guildId` is a half-written provisioning config, so that
+   * fails instead of passing as post-only.
+   */
+  whoami(): Promise<{
+    target: string;
+  } | null>;
   private guild;
   private static same;
   ensureCategory(name: string): Promise<EnsuredResource>;
@@ -91,7 +100,7 @@ interface PluginContext {
    * resolved on first `send()`, not at plugin load. `describe()` never calls it.
    */
   defaultWebhookUrl: () => string;
-  /** Memoized — resolves the bot token on the first provisioning call; `send()` and `describe()` never touch it. */
+  /** Memoized — resolves the bot token on the first provisioning call, or when `holocron doctor` checks a provider that has a `guildId`; `send()` and `describe()` never touch it. */
   bot: () => DiscordBotClient;
 }
 declare function createContext(options?: DiscordPluginOptions): PluginContext;

package/dist/index.mjs

@@ -11,8 +11,8 @@ const resolveToken = createResolveToken({
 const resolveBotToken = createResolveToken({
 	envName: "HOLOCRON_DISCORD_BOT_TOKEN",
 	vendorEnvName: "DISCORD_BOT_TOKEN",
-	keyringService: "discord-bot",
-	errorMessage: "no Discord bot token found. Set HOLOCRON_DISCORD_BOT_TOKEN (or DISCORD_BOT_TOKEN) — it is the bot token from the Discord developer portal (Bot → Reset Token), not a webhook URL."
+	keyringService: "discord.holonet",
+	errorMessage: "no Discord bot token found. Set HOLOCRON_DISCORD_BOT_TOKEN (or DISCORD_BOT_TOKEN), or run: holocron auth set discord.holonet <token> — it is the bot token from the Discord developer portal (Bot → Reset Token), not a webhook URL."
 });
 //#endregion
 //#region src/capabilities/notifications.ts
@@ -39,6 +39,21 @@ var DiscordNotifications = class DiscordNotifications {
 		const { id, token } = parseWebhookUrl(webhookUrl);
 		await this.client.webhooks.execute(id, token, message);
 	}
+	/**
+	* `holocron doctor`: the bot token is valid and can see the configured server.
+	* Null when no `guildId` is set -- a post-only config has no bot to check. A
+	* `layout` without a `guildId` is a half-written provisioning config, so that
+	* fails instead of passing as post-only.
+	*/
+	async whoami() {
+		if (!this.opts.guildId) {
+			if (this.opts.layout) throw new Error("`layout` is set but `guildId` is not — add the server id to the discord provider options");
+			return null;
+		}
+		const bot = this.bot();
+		const me = await bot.users.me();
+		return { target: `${(await bot.guilds.get(this.opts.guildId)).name} (as ${me.username})` };
+	}
 	guild() {
 		if (!this.opts.guildId) throw new Error("no Discord server id — set `guildId` in the discord provider options in holocron.config.ts");
 		return this.opts.guildId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/holocron-plugin-discord",
-  "version": "5.0.0-alpha.182",
+  "version": "5.0.0-alpha.184",
   "description": "Holocron plugin for Discord. Implements the notifications capability via Discord incoming webhooks.",
   "keywords": [
     "discord",
@@ -48,12 +48,12 @@
     "tsx": "4.23.15",
     "typescript": "^5.9.3",
     "vitest": "^4.1.11",
-    "@theholocron/cli": "5.0.0-alpha.182"
+    "@theholocron/cli": "5.0.0-alpha.184"
   },
   "peerDependencies": {
     "@theholocron/discord-client": "^1.43.1",
     "@theholocron/misc-utils": "^1.16.0",
-    "@theholocron/cli": "5.0.0-alpha.182"
+    "@theholocron/cli": "5.0.0-alpha.184"
   },
   "engines": {
     "node": ">=22"