@helyx/bot 1.4.0 → 1.5.1

package/dist/shard-worker.js

@@ -1,6 +1,6 @@
 import { parseBotEnvironment } from "@helyx/config";
 import { safeError, ServiceRegistry } from "@helyx/core";
-import { checkDatabaseConnection, createDatabasePool, PremiumAllocationRepository, } from "@helyx/database";
+import { checkDatabaseConnection, createDatabasePool, PremiumAllocationRepository, InstallationRepository, } from "@helyx/database";
 import { assertRepositoryEngineSupported } from "@helyx/database/adapters";
 import { REVIEWED_PREMIUM_MODULE_IDS } from "@helyx/module-manifest";
 import { createRuntime } from "@helyx/framework";
@@ -18,6 +18,8 @@ import { installCreatorInvitePlatform } from "./creator-onboarding-platform.js";
 import { installGuildTracking, } from "./guilds.js";
 import { installInteractions, } from "./interactions.js";
 import { createManagementModule } from "./management-module.js";
+import { createDiagnosticModule, createPostgresDiagnosticLock, } from "./diagnostic-command.js";
+import { GuildCommandReadService } from "./guild-command-read-service.js";
 import { DiscordModuleLoggingService } from "./module-logging.js";
 import { resolveModulePackageSpecifiers } from "./module-configuration.js";
 import { loadConfiguredModulePackages, platformServiceOptions, secureRandomSelectionWorkerKeyName, } from "./modules.js";
@@ -158,6 +160,35 @@ export async function startShardWorker(processEnvironment = process.env, identit
         const guildResources = new DiscordGuildResourceDirectory(client);
         const permissionsModule = createPermissionsModule(featureModules);
         const managementModule = createManagementModule(featureModules, guildResources);
+        const diagnosticInstallations = new InstallationRepository(database);
+        const diagnosticModule = createDiagnosticModule({
+            client,
+            modules: featureModules,
+            runExclusive: createPostgresDiagnosticLock(database),
+            assertGuildAvailable: async (guildId) => {
+                if (shuttingDown ||
+                    guildIdToShardId(guildId, identity.shardCount) !== identity.shardId)
+                    throw new Error("The server is no longer owned by this shard");
+                const installation = await diagnosticInstallations.getActiveGuild(guildId);
+                if (!installation ||
+                    installation.shardGeneration !== identity.generation ||
+                    installation.shardDeploymentOrder !==
+                        BigInt(identity.deploymentOrder ?? 1) ||
+                    installation.shardSupervisorId !== identity.supervisorId ||
+                    installation.shardId !== identity.shardId ||
+                    installation.shardFencingToken !== BigInt(identity.fencingToken))
+                    throw new Error("The server installation or shard ownership changed");
+            },
+            listEnabledModules: (guildId) => diagnosticInstallations.listEnabledModules(guildId),
+            commandStatus: {
+                get: (guildId) => {
+                    return guildCommandReads.getStatus(guildId);
+                },
+                refresh: (input) => {
+                    return guildCommandReads.refreshStatus(input);
+                },
+            },
+        });
         cloudProxy = new WorkerCloudConnectorProxy();
         const cloudManagementModule = environment.HELYX_CLOUD_CONNECT_ENABLED
             ? createCloudManagementModule({
@@ -184,6 +215,7 @@ export async function startShardWorker(processEnvironment = process.env, identit
             : undefined;
         const publicModules = [
             managementModule,
+            diagnosticModule,
             permissionsModule,
             supportModule,
             privacyModule,
@@ -206,6 +238,7 @@ export async function startShardWorker(processEnvironment = process.env, identit
                     : {}),
                 coreFunctions: [
                     managementModule,
+                    diagnosticModule,
                     permissionsModule,
                     supportModule,
                     privacyModule,
@@ -224,6 +257,7 @@ export async function startShardWorker(processEnvironment = process.env, identit
             ...publicModules,
             ...(operationsModule ? [operationsModule] : []),
         ];
+        const guildCommandReads = new GuildCommandReadService(database, environment.DISCORD_CLIENT_ID, undefined, environment.DISCORD_TOKEN, environment.HELYX_GUILD_COMMAND_WRITES_ENABLED, environment.HELYX_GUILD_COMMAND_WRITE_GUILD_IDS, environment.HELYX_GUILD_COMMAND_WRITE_SCOPE === "all", modules);
         const platformServices = new Map();
         const serviceAccess = new ServiceRegistry(platformServices);
         const serviceOptions = platformServiceOptions(environment, publicModules);
@@ -328,6 +362,7 @@ export async function startShardWorker(processEnvironment = process.env, identit
         runtime = createRuntime({ modules, logger, services: platformServices });
         const enabledCoreModuleIds = new Set([
             managementModule.manifest.id,
+            diagnosticModule.manifest.id,
             permissionsModule.manifest.id,
             supportModule.manifest.id,
             ...(premiumActivationModule ? [premiumActivationModule.manifest.id] : []),
@@ -359,6 +394,7 @@ export async function startShardWorker(processEnvironment = process.env, identit
                 ? { operationsModuleId: operationsModule.manifest.id }
                 : {}),
             supportModuleId: supportModule.manifest.id,
+            diagnosticModuleId: diagnosticModule.manifest.id,
             ...(premiumActivationModule
                 ? { premiumActivationModuleId: premiumActivationModule.manifest.id }
                 : {}),
@@ -563,6 +599,7 @@ export function shardWorkerCommandRegistration(input) {
         synchronise: false,
         selfAuthorizingGuildModuleIds: new Set([
             input.supportModuleId,
+            ...(input.diagnosticModuleId ? [input.diagnosticModuleId] : []),
             ...(input.premiumActivationModuleId
                 ? [input.premiumActivationModuleId]
                 : []),

package/documentation/reference/environment.md

@@ -37,7 +37,7 @@ commented.
 
 Enable privileged intents in the Discord Developer Portal as well as the bot
 environment when required: Counting needs Message Content, Welcome and Access
-Control need Guild Members, and Levels needs both. Access Control's Password
+Control need Guild Members. Levels needs Guild Members, and Message Content only when using **Custom message types** rather than **All messages**. Access Control's Password
 Entry also needs Message Content. The corresponding variables are
 `HELYX_MESSAGE_CONTENT_ENABLED` and `HELYX_GUILD_MEMBERS_ENABLED`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helyx/bot",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "Production Discord runtime for the modular Helyx platform.",
   "keywords": [
     "helyx",
@@ -51,14 +51,14 @@
   },
   "dependencies": {
     "@helyx/config": ">=1.4.0 <2.0.0",
-    "@helyx/control-protocol": ">=0.7.0 <0.8.0",
+    "@helyx/control-protocol": ">=0.8.0 <0.9.0",
     "@helyx/core": ">=0.2.0 <0.3.0",
-    "@helyx/database": ">=2.4.0 <3.0.0",
+    "@helyx/database": ">=2.4.1 <3.0.0",
     "@helyx/database-contracts": ">=0.2.0 <0.3.0",
     "@helyx/framework": ">=0.2.0 <0.3.0",
     "@helyx/module-manifest": ">=0.13.0 <0.14.0",
     "@helyx/platform": ">=1.3.0 <2.0.0",
-    "@helyx/sdk": ">=0.15.0 <0.16.0",
+    "@helyx/sdk": ">=0.16.0 <0.17.0",
     "@helyx/status-client": ">=0.3.0 <0.4.0",
     "@helyx/verification-contracts": ">=0.4.0 <0.5.0",
     "discord.js": "14.27.0",
@@ -70,11 +70,11 @@
     "zod": "4.4.3"
   },
   "optionalDependencies": {
-    "@helyx/database-mysql": ">=0.2.0 <0.3.0"
+    "@helyx/database-mysql": ">=0.2.1 <0.3.0"
   },
   "peerDependencies": {
-    "@helyx/module-automod": ">=1.1.0 <2.0.0",
-    "@helyx/module-moderation": ">=1.1.0 <2.0.0"
+    "@helyx/module-automod": ">=1.1.1 <2.0.0",
+    "@helyx/module-moderation": ">=1.1.1 <2.0.0"
   },
   "peerDependenciesMeta": {
     "@helyx/module-automod": {