@helyx/bot 1.6.0 → 1.7.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.7.0
+
+### Minor Changes
+
+- Add the built-in private /help command with module selection, reviewed answer choices and local self-host fallback. Keep question selection and its answer in the same private message, show the original question above choices, and use a compact FAQ ID footer. Add opt-in encrypted online Help enrolment and fail closed for unavailable hosted publication state. Integrate authenticated Server Overview reads, bounded Discord profiles and protected invite provenance across direct, Cloud Connect and sharded runtimes.
+
 ## 1.6.0
 
 ### Minor Changes

package/command-root-catalogue.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "revision": 3,
+  "revision": 6,
   "roots": [
     { "name": "access", "type": 1, "ownerModuleId": "helyx.account-gate" },
     { "name": "access", "type": 1, "ownerModuleId": "helyx.verification" },
@@ -17,6 +17,7 @@
     { "name": "games", "type": 1, "ownerModuleId": "helyx.counting" },
     { "name": "games", "type": 1, "ownerModuleId": "helyx.trivia" },
     { "name": "giveaway", "type": 1, "ownerModuleId": "helyx.giveaways" },
+    { "name": "help", "type": 1, "ownerModuleId": "helyx.help" },
     { "name": "helyx", "type": 1, "ownerModuleId": "helyx.cloud-connect" },
     { "name": "helyx", "type": 1, "ownerModuleId": "helyx.management" },
     { "name": "helyx", "type": 1, "ownerModuleId": "helyx.oauth" },
@@ -62,6 +63,13 @@
         "sourcePath": "apps/bot/src/diagnostic-command.ts",
         "version": "0.1.0"
       },
+      {
+        "commands": ["help"],
+        "moduleId": "helyx.help",
+        "releaseStatus": "live",
+        "sourcePath": "apps/bot/src/help-module.ts",
+        "version": "0.1.0"
+      },
       {
         "commands": ["helyx.modules"],
         "moduleId": "helyx.management",
@@ -124,7 +132,7 @@
         "moduleId": "helyx.account-gate",
         "packageName": "@helyx/module-account-gate",
         "releaseStatus": "live",
-        "version": "2.1.2"
+        "version": "2.1.3"
       },
       {
         "commands": [
@@ -135,7 +143,7 @@
         "moduleId": "helyx.achievements",
         "packageName": "@helyx/module-achievements",
         "releaseStatus": "live",
-        "version": "2.1.3"
+        "version": "2.1.4"
       },
       {
         "commands": ["afk"],
@@ -284,7 +292,7 @@
         "moduleId": "helyx.reactionroles",
         "packageName": "@helyx/module-reactionroles",
         "releaseStatus": "live",
-        "version": "1.1.2"
+        "version": "1.1.3"
       },
       {
         "commands": [],
@@ -456,5 +464,5 @@
       }
     ]
   },
-  "fingerprint": "70fb5cb9554c8fdb723ff8139a9e1b0ae2128d256b12a6146d5674c63774c42a"
+  "fingerprint": "9bd09abbfbaaac0ddb932b6e25911b9a2eb8a3dd5febe92f5862ef903534b2e5"
 }

package/dist/cloud-connector.js

@@ -904,6 +904,8 @@ function connectorCapabilities() {
         "installation.health.read.v1",
         "guild.state.read.v1",
         "guild.user-identities.read.v1",
+        "guild.overview.read.v1",
+        "guild.overview.invite.revoke.v1",
         "guild.dashboard.access.read.v1",
         "guild.access-policy.read.v1",
         "guild.access-policy.write.v1",

package/dist/cloud-control-dispatcher.js

@@ -18,6 +18,26 @@ export class CloudControlDispatcher {
             : undefined;
         let result;
         switch (request.operation) {
+            case "guild.overview.read.v1": {
+                const input = parseOperationInput(request.operation, request.input);
+                if (!this.control.readServerOverview)
+                    throw new Error("Overview is unavailable");
+                result = await this.control.readServerOverview({
+                    ...input,
+                    actorUserId: requiredActor(actorUserId),
+                });
+                break;
+            }
+            case "guild.overview.invite.revoke.v1": {
+                const input = parseOperationInput(request.operation, request.input);
+                if (!this.control.revokeServerOverviewInvite)
+                    throw new Error("Invite management is unavailable");
+                result = await this.control.revokeServerOverviewInvite({
+                    ...input,
+                    actorUserId: requiredActor(actorUserId),
+                });
+                break;
+            }
             case "installation.health.read.v1":
                 parseOperationInput(request.operation, request.input);
                 result = {

package/dist/command-registration-policy.js

@@ -7,6 +7,7 @@ const platformGlobalModuleIds = new Set([
     "helyx.permissions",
     "helyx.privacy",
     "helyx.process-info",
+    "helyx.help",
     "helyx.premium-activation",
 ]);
 const deploymentModuleIds = new Set(["helyx.cloud-connect"]);

package/dist/control-directory-contracts.d.ts

@@ -0,0 +1,50 @@
+import type { DiscordUserIdentityControl } from "@helyx/control-protocol/discord-user-identities";
+import type { MessageResponse, PermissionActor, PublicAchievementProjectionPage } from "@helyx/sdk";
+import type { OverviewDiscordDirectory } from "./server-overview-discord.js";
+export interface BotControlGuildResources {
+    botGuildPermissions?: string[];
+    channels: Array<{
+        id: string;
+        name: string;
+        type: "guild_text" | "guild_announcement" | "guild_category" | "guild_forum" | "guild_media";
+    }>;
+    roles: Array<{
+        id: string;
+        name: string;
+        colour: string;
+        position: number;
+    }>;
+}
+export interface BotPublicModuleProjection {
+    server: {
+        id: string;
+        name: string;
+        memberCount: number;
+    };
+    projection: PublicAchievementProjectionPage;
+}
+export type BotGuildPresenceState = "installed" | "not_installed" | "unknown" | "unavailable";
+export interface BotGuildPresenceObservation {
+    guildId: string;
+    state: BotGuildPresenceState;
+    observedAt: string;
+}
+export interface BotControlGuildResourceDirectory extends DiscordUserIdentityControl {
+    overview?: OverviewDiscordDirectory;
+    listGuildPresence(guildIds: readonly string[]): Promise<BotGuildPresenceObservation[]>;
+    getGuildResources(guildId: string): Promise<BotControlGuildResources>;
+    getGuildPublicSummary(guildId: string): Promise<{
+        id: string;
+        name: string;
+        memberCount: number;
+    }>;
+    sendToChannel(channelId: string, response: MessageResponse): Promise<{
+        messageId: string;
+    }>;
+    deleteChannelMessage(channelId: string, messageId: string): Promise<void>;
+    editChannelMessage(channelId: string, messageId: string, response: MessageResponse): Promise<void>;
+    addChannelMessageReaction(channelId: string, messageId: string, emojiIdentifier: string): Promise<void>;
+    resolveActor(guildId: string, actorUserId: string): Promise<PermissionActor>;
+    sendPrivateSupportNotification?(guildId: string, channelId: string, response: MessageResponse, notificationId: string): Promise<void>;
+}
+//# sourceMappingURL=control-directory-contracts.d.ts.map

package/dist/control-directory-contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=control-directory-contracts.js.map

package/dist/control-server-schemas.d.ts

@@ -8,9 +8,9 @@ export declare const permissionState: z.ZodObject<{
     module: z.ZodObject<{
         preset: z.ZodEnum<{
             everyone: "everyone";
+            custom: "custom";
             moderators: "moderators";
             administrators: "administrators";
-            custom: "custom";
         }>;
         allowedRoleIds: z.ZodArray<z.ZodString>;
         deniedRoleIds: z.ZodArray<z.ZodString>;
@@ -22,9 +22,9 @@ export declare const permissionState: z.ZodObject<{
         policy: z.ZodObject<{
             preset: z.ZodEnum<{
                 everyone: "everyone";
+                custom: "custom";
                 moderators: "moderators";
                 administrators: "administrators";
-                custom: "custom";
             }>;
             allowedRoleIds: z.ZodArray<z.ZodString>;
             deniedRoleIds: z.ZodArray<z.ZodString>;
@@ -59,8 +59,8 @@ export declare const managedResourceDetailSchema: z.ZodObject<{
     availableActionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     notices: z.ZodOptional<z.ZodArray<z.ZodObject<{
         kind: z.ZodEnum<{
-            info: "info";
             warning: "warning";
+            info: "info";
         }>;
         message: z.ZodString;
     }, z.core.$strict>>>;

package/dist/control-server.d.ts

@@ -1,9 +1,13 @@
+import type { BotControlGuildResources, BotPublicModuleProjection, BotGuildPresenceObservation, BotControlGuildResourceDirectory } from "./control-directory-contracts.js";
+export type { BotControlGuildResources, BotPublicModuleProjection, BotGuildPresenceState, BotGuildPresenceObservation, BotControlGuildResourceDirectory, } from "./control-directory-contracts.js";
 import { type DiscordUserIdentityControl, type DiscordUserIdentityRequest } from "@helyx/control-protocol/discord-user-identities";
+import type { ServerOverviewControl } from "@helyx/control-protocol";
+import { type OverviewDiscordDirectory } from "./server-overview-discord.js";
 import { AuditRepository, GuildAccessPolicyRepository, InstallationRepository, ModuleLoggingPolicyRepository, PermissionPolicyRepository, type DatabasePool, type GuildShardOwnership } from "@helyx/database";
 import type { MysqlPool } from "@helyx/database-mysql";
 import type { CreatorOnboardingRequest, CreatorOnboardingResponse } from "@helyx/sdk";
 export { mapBotControlError, safeBotControlFieldError, } from "./control-error-mapping.js";
-import { type DashboardActionInspection, type DashboardActionResult, type FeatureAccessDecision, type GuildAccessPolicy, type ManagedResourceCreationIntent, type ManagedResourceDetail, type ManagedResourcePage, type ManagedResourceRelationPage, type ManagedResourceValue, type MessageResponse, type ModuleDefinition, type OAuthConsumerCleanupResult, type PermissionActor, type PrivacyCapturePage, type PrivacyErasePage, type PrivacyProviderExecutor, type PublicAchievementProjectionPage, type ServiceAccess } from "@helyx/sdk";
+import { type DashboardActionInspection, type DashboardActionResult, type FeatureAccessDecision, type GuildAccessPolicy, type ManagedResourceCreationIntent, type ManagedResourceDetail, type ManagedResourcePage, type ManagedResourceRelationPage, type ManagedResourceValue, type MessageResponse, type ModuleDefinition, type OAuthConsumerCleanupResult, type PermissionActor, type PrivacyCapturePage, type PrivacyErasePage, type PrivacyProviderExecutor, type ServiceAccess } from "@helyx/sdk";
 import { type ActionReceipt, type SignedAssessmentEnvelope } from "@helyx/verification-contracts";
 import { type Client } from "discord.js";
 import { type FastifyInstance } from "fastify";
@@ -29,53 +33,10 @@ interface DashboardLoggingPolicy {
     enabled: boolean;
     version: number;
 }
-export interface BotControlGuildResources {
-    channels: Array<{
-        id: string;
-        name: string;
-        type: "guild_text" | "guild_announcement" | "guild_category" | "guild_forum" | "guild_media";
-    }>;
-    roles: Array<{
-        id: string;
-        name: string;
-        colour: string;
-        position: number;
-    }>;
-}
-export interface BotPublicModuleProjection {
-    server: {
-        id: string;
-        name: string;
-        memberCount: number;
-    };
-    projection: PublicAchievementProjectionPage;
-}
-export type BotGuildPresenceState = "installed" | "not_installed" | "unknown" | "unavailable";
-export interface BotGuildPresenceObservation {
-    guildId: string;
-    state: BotGuildPresenceState;
-    observedAt: string;
-}
-export interface BotControlGuildResourceDirectory extends DiscordUserIdentityControl {
-    listGuildPresence(guildIds: readonly string[]): Promise<BotGuildPresenceObservation[]>;
-    getGuildResources(guildId: string): Promise<BotControlGuildResources>;
-    getGuildPublicSummary(guildId: string): Promise<{
-        id: string;
-        name: string;
-        memberCount: number;
-    }>;
-    sendToChannel(channelId: string, response: MessageResponse): Promise<{
-        messageId: string;
-    }>;
-    deleteChannelMessage(channelId: string, messageId: string): Promise<void>;
-    editChannelMessage(channelId: string, messageId: string, response: MessageResponse): Promise<void>;
-    addChannelMessageReaction(channelId: string, messageId: string, emojiIdentifier: string): Promise<void>;
-    resolveActor(guildId: string, actorUserId: string): Promise<PermissionActor>;
-    sendPrivateSupportNotification?(guildId: string, channelId: string, response: MessageResponse, notificationId: string): Promise<void>;
-}
 export declare class DiscordGuildResourceDirectory implements BotControlGuildResourceDirectory {
     #private;
     private readonly client;
+    readonly overview: OverviewDiscordDirectory;
     constructor(client: Client);
     resolveDiscordUserIdentities(input: DiscordUserIdentityRequest): Promise<{
         guildId: string;
@@ -110,6 +71,7 @@ export interface SupportNotificationInput {
     source: "dashboard_bug" | "dashboard_support" | "dashboard_security" | "discord_command";
 }
 export interface BotControlState {
+    botGuildPermissions?: string[];
     discordCapabilities?: {
         messageContent: boolean;
     };
@@ -134,7 +96,7 @@ export interface DashboardGuildAccessState extends GuildAccessPolicy {
     actorHighestRolePosition: number | null;
     updatedAt: string | null;
 }
-export interface BotControlHandler extends FirstTimeCommandSetupHandler, DashboardActionHandler, ManagedResourceCreateDefaultsControl, ChannelAuditControl, DiscordUserIdentityControl {
+export interface BotControlHandler extends ServerOverviewControl, FirstTimeCommandSetupHandler, DashboardActionHandler, ManagedResourceCreateDefaultsControl, ChannelAuditControl, DiscordUserIdentityControl {
     creatorOnboarding?(input: CreatorOnboardingRequest): Promise<CreatorOnboardingResponse>;
     cleanupOAuthConsumer(input: {
         consumerBindingId: string;
@@ -363,6 +325,8 @@ export declare class BotControlService implements BotControlHandler {
     private readonly supportNotifications?;
     private readonly presenceOwnership?;
     private readonly presenceShardCount?;
+    readonly readServerOverview: NonNullable<ServerOverviewControl["readServerOverview"]>;
+    readonly revokeServerOverviewInvite: NonNullable<ServerOverviewControl["revokeServerOverviewInvite"]>;
     readonly readChannelAuditConfiguration: Required<ChannelAuditControl>["readChannelAuditConfiguration"];
     readonly checkChannelAudit: Required<ChannelAuditControl>["checkChannelAudit"];
     constructor(databaseOrPersistence: DatabasePool | BotControlPersistence, modules: readonly ModuleDefinition[], resources: BotControlGuildResourceDirectory, services: ServiceAccess, privacyExecutor?: PrivacyProviderExecutor, supportNotifications?: {

package/dist/control-server.js

@@ -1,4 +1,8 @@
+import { overviewReadContext } from "./server-overview-profile.js";
 import { discordUserIdentityRequestSchema, } from "@helyx/control-protocol/discord-user-identities";
+import { createServerOverviewControl } from "./server-overview-control.js";
+import { createOverviewDiscordDirectory, } from "./server-overview-discord.js";
+import { registerServerOverviewControlRoutes } from "./server-overview-routes.js";
 import { createDiscordUserIdentityLookup, } from "./discord-user-identities.js";
 import { AuditRepository, GuildAccessPolicyRepository, InstallationRepository, ModuleLoggingPolicyRepository, OptimisticConcurrencyError, PermissionPolicyRepository, withTransaction, } from "@helyx/database";
 import { safeError } from "@helyx/core";
@@ -44,9 +48,11 @@ import { validateDiscordUserSettingSelections, validateDiscordSettingSelections,
 import { configurationValue, guildAccessPolicy, managedResourceDeleteResultSchema, managedResourceDetailSchema, managedResourceFilters, managedResourceObject, managedResourcePageSchema, managedResourceRelationPageSchema, moduleId, mutationContext, permissionState, resourceActionId, resourceCursor, resourceId, snowflake, } from "./control-server-schemas.js";
 export class DiscordGuildResourceDirectory {
     client;
+    overview;
     #identities;
     constructor(client) {
         this.client = client;
+        this.overview = createOverviewDiscordDirectory(client);
         this.#identities = createDiscordUserIdentityLookup(client);
     }
     resolveDiscordUserIdentities(input) {
@@ -107,6 +113,9 @@ export class DiscordGuildResourceDirectory {
                     colour: role.hexColor,
                     position: role.position,
                 })),
+                ...(guild.members?.me
+                    ? { botGuildPermissions: guild.members.me.permissions.toArray() }
+                    : {}),
             };
         }
         catch (error) {
@@ -242,6 +251,9 @@ export class BotControlService {
     #services;
     #privacyProviders;
     #persistence;
+    #overview;
+    readServerOverview;
+    revokeServerOverviewInvite;
     readChannelAuditConfiguration;
     checkChannelAudit;
     constructor(databaseOrPersistence, modules, resources, services, privacyExecutor, supportNotifications, presenceOwnership, presenceShardCount, statusModules) {
@@ -276,6 +288,33 @@ export class BotControlService {
         });
         this.readChannelAuditConfiguration = audit.readChannelAuditConfiguration;
         this.checkChannelAudit = audit.checkChannelAudit;
+        this.#overview = createServerOverviewControl({
+            modules: this.#modules,
+            services: this.#services,
+            permissions: this.#permissions,
+            directory: resources.overview,
+            auditInviteRevoke: async (input) => {
+                await this.#persistence.repositories.audit.append({
+                    guildId: input.guildId,
+                    actorUserId: input.actorUserId,
+                    action: `server.invite.${input.outcome}`,
+                    source: "dashboard",
+                    correlationId: input.correlationId,
+                    targetType: "discord-invite",
+                    targetId: createHash("sha256")
+                        .update(`${input.guildId}:${input.code}`)
+                        .digest("hex"),
+                });
+            },
+            resolveActor: (guildId, actorUserId) => resources.resolveActor(guildId, actorUserId),
+            readGuildPolicy: (guildId) => this.#readGuildAccessPolicy(guildId),
+            listModules: (guildId) => this.#persistence.repositories.installations.listModules(guildId),
+            requireAccessible: (guildId, moduleId) => this.#requireModuleAccessible(guildId, moduleId),
+            context: (guildId, actor) => overviewReadContext(guildId, actor, this.#services),
+        });
+        this.readServerOverview = this.#overview.readServerOverview.bind(this.#overview);
+        this.revokeServerOverviewInvite =
+            this.#overview.revokeServerOverviewInvite.bind(this.#overview);
     }
     async creatorOnboarding(input) {
         return executeCreatorOnboarding(input, {
@@ -994,7 +1033,9 @@ export class BotControlService {
         const declaredIntents = declaration?.creationIntents ?? ["publish"];
         if (!declaredIntents.includes(input.intent))
             throw new DashboardActionValidationError("This creation intent is not declared by the module.");
-        return normalizeManagedResourceDetail(managedResourceDetailSchema.parse(await resource.create(context, input.value, input.intent)), managedResourceColumnKeys(module, input.resourceType));
+        const result = normalizeManagedResourceDetail(managedResourceDetailSchema.parse(await resource.create(context, input.value, input.intent)), managedResourceColumnKeys(module, input.resourceType));
+        this.#overview.invalidate(input.guildId);
+        return result;
     }
     async updateManagedResource(input) {
         await this.#requireModuleAccessible(input.guildId, input.moduleId);
@@ -1005,11 +1046,13 @@ export class BotControlService {
             declaration?.featureId,
             ...resourceFieldFeatureIds(declaration?.fields ?? [], input.value),
         ]);
-        return normalizeManagedResourceDetail(managedResourceDetailSchema.parse(await resource.update(await this.#managedResourceContext(input, module, "update"), {
+        const result = normalizeManagedResourceDetail(managedResourceDetailSchema.parse(await resource.update(await this.#managedResourceContext(input, module, "update"), {
             resourceId: input.resourceId,
             expectedRevision: input.expectedRevision,
             value: input.value,
         })), managedResourceColumnKeys(module, input.resourceType));
+        this.#overview.invalidate(input.guildId);
+        return result;
     }
     async deleteManagedResource(input) {
         await this.#requireModuleAccessible(input.guildId, input.moduleId);
@@ -1017,10 +1060,12 @@ export class BotControlService {
         this.#requireManagedResourceOperation(module, input.resourceType, "delete");
         const declaration = module.manifest.dashboard?.resources?.find(({ id }) => id === input.resourceType);
         await requireDashboardFeatures(this.#services, input.guildId, input.moduleId, [declaration?.featureId]);
-        return managedResourceDeleteResultSchema.parse(await resource.delete(await this.#managedResourceContext(input, module, "delete"), {
+        const result = managedResourceDeleteResultSchema.parse(await resource.delete(await this.#managedResourceContext(input, module, "delete"), {
             resourceId: input.resourceId,
             expectedRevision: input.expectedRevision,
         }));
+        this.#overview.invalidate(input.guildId);
+        return result;
     }
     async executeManagedResourceAction(input) {
         await this.#requireModuleAccessible(input.guildId, input.moduleId);
@@ -1046,6 +1091,7 @@ export class BotControlService {
             expectedRevision: input.expectedRevision,
             value: input.value,
         });
+        this.#overview.invalidate(input.guildId);
         return result === null
             ? null
             : normalizeManagedResourceDetail(managedResourceDetailSchema.parse(result), managedResourceColumnKeys(module, input.resourceType));
@@ -1523,6 +1569,7 @@ export async function createBotControlServer(input) {
         return input.service.setModuleStatus({ ...params, ...body });
     });
     registerDashboardActionRoutes(server, input.service);
+    registerServerOverviewControlRoutes(server, input.service);
     registerChannelAuditRoutes(server, input.service);
     server.get("/v1/guilds/:guildId/modules/:moduleId/resources/:resourceType", async (request) => {
         const params = z

package/dist/creator-invite-service.d.ts

@@ -8,6 +8,13 @@ export declare class DiscordCreatorInviteService implements CreatorInviteService
     private readonly repository;
     private readonly services;
     private readonly module;
+    identifyInvites(input: {
+        guildId: string;
+        codes: readonly string[];
+    }): Promise<readonly {
+        code: string;
+        reference: string;
+    }[]>;
     constructor(client: Client, repository: CreatorInviteRepository, services: ServiceAccess, module: ModuleDefinition | undefined, encryption: string | {
         inviteEncryptionKey: string;
     });

package/dist/creator-invite-service.js

@@ -16,6 +16,23 @@ export class DiscordCreatorInviteService {
     repository;
     services;
     module;
+    async identifyInvites(input) {
+        validateId(input.guildId);
+        if (input.codes.length > 15 ||
+            input.codes.some((code) => !/^[A-Za-z0-9_-]{1,100}$/u.test(code)))
+            throw new CreatorInviteOperationError("unavailable");
+        this.#ownedGuild(input.guildId);
+        if (!(await this.repository.isInstalled()))
+            return [];
+        const requested = new Set(input.codes);
+        const found = [];
+        for (const record of await this.repository.listOwnedForGuild(input.guildId)) {
+            const code = this.#decrypt(record);
+            if (requested.has(code))
+                found.push({ code, reference: record.reference });
+        }
+        return found;
+    }
     #key;
     #rest = null;
     #cleanupCursor;

package/dist/discord-guild-health.d.ts

@@ -163,8 +163,8 @@ export declare class DiscordGuildHealthInspection implements DiscordGuildHealthI
             resourceValidationValid: boolean | null;
             activationValid: boolean | null;
             catalogueMatches: boolean;
-            requiredCapabilities: readonly ("message-content" | "guild-members")[];
-            missingCapabilities: ("message-content" | "guild-members")[];
+            requiredCapabilities: readonly ("guild-members" | "message-content")[];
+            missingCapabilities: ("guild-members" | "message-content")[];
             missingPermissions: string[];
             healthStatus: "healthy" | "degraded" | "unhealthy";
             healthMessage: string | null;

package/dist/events.d.ts

@@ -113,6 +113,7 @@ export declare class DiscordResourceInspection implements DiscordResourceInspect
         userId: string;
         displayName: string | null;
         avatarUrl?: string;
+        isBot?: boolean;
     }[]>;
     searchMembers(input: {
         guildId: string;

package/dist/events.js

@@ -1802,6 +1802,7 @@ export class DiscordResourceInspection {
             const member = members.get(userId) ?? null;
             const cachedUser = this.client.users?.cache?.get(userId);
             const avatarUrl = memberAvatarUrl(member);
+            const isBot = member?.user?.bot ?? cachedUser?.bot;
             return {
                 userId,
                 displayName: member?.displayName ??
@@ -1809,6 +1810,7 @@ export class DiscordResourceInspection {
                     cachedUser?.username ??
                     null,
                 ...(avatarUrl ? { avatarUrl } : {}),
+                ...(typeof isBot === "boolean" ? { isBot } : {}),
             };
         });
     }

package/dist/help-credentials.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export declare const HELP_API_ORIGIN = "https://api.helyx.gg";
+declare const credentialSchema: z.ZodObject<{
+    installationId: z.ZodString;
+    token: z.ZodString;
+    expiresAt: z.ZodString;
+}, z.core.$strict>;
+export type HelpCredential = z.infer<typeof credentialSchema>;
+export declare const parseHelpCredential: (value: unknown) => HelpCredential;
+export declare class HelpCredentialError extends Error {
+    constructor();
+}
+/** Encrypted, opt-in file; separate from Cloud Connect and every provider secret. */
+export declare class HelpCredentialStore {
+    readonly path: string;
+    private readonly key;
+    constructor(directory: string, dataKey: string);
+    private aad;
+    private checkDirectory;
+    read(): Promise<HelpCredential | null>;
+    save(input: HelpCredential): Promise<void>;
+    remove(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=help-credentials.d.ts.map