@helyx/bot 0.4.8 → 0.4.11

package/dist/shard-worker.d.ts

@@ -37,6 +37,7 @@ export declare function parseShardWorkerEnvironment(processEnvironment: NodeJS.P
     HELYX_SUPPORT_STAFF_CHANNEL_ID: string | undefined;
     HELYX_BOT_CONTROL_PORT: number;
     HELYX_PRIVACY_ENABLED: boolean;
+    HELYX_MESSAGE_CONTENT_ENABLED: boolean;
     HELYX_CLOUD_CONNECT_ENABLED: boolean;
     HELYX_CLOUD_ENROLMENT_TOKEN: string | undefined;
     HELYX_CLOUD_ENROLMENT_FILE: string;

package/dist/shard-worker.js

@@ -9,7 +9,7 @@ import { monitorEventLoopDelay } from "node:perf_hooks";
 import pino from "pino";
 import { createCloudManagementModule } from "./cloud-management-module.js";
 import { BotControlService, DiscordGuildResourceDirectory, mapBotControlError, } from "./control-server.js";
-import { DiscordMemberRoleService, DiscordResourceInspection, installModuleEvents, } from "./events.js";
+import { DiscordMessageDeliveryService, DiscordMemberEnforcementService, DiscordMemberRoleService, DiscordResourceInspection, installModuleEvents, } from "./events.js";
 import { installGuildTracking } from "./guilds.js";
 import { installInteractions, } from "./interactions.js";
 import { createManagementModule } from "./management-module.js";
@@ -25,6 +25,8 @@ import { assertShardMessageSize, controlOperationGuildId, executeShardControlOpe
 import { gatewayIntentsForModules, readBotVersion, } from "./index.js";
 import { createSupportModule } from "./support-module.js";
 import { createLocalScheduledTaskRoute, } from "./scheduled-task-runner.js";
+import { createLocalNumericWriteBehind } from "./numeric-write-behind.js";
+import { WorkerNumericWriteBehindProxy } from "./numeric-write-behind-proxy.js";
 const HEALTH_INTERVAL_MS = 5_000;
 export const WORKER_ORPHAN_TERMINATION_BOUND_MS = SHARD_LEASE_HEARTBEAT_TIMEOUT_MS + 5_000;
 export function createLeaseHeartbeatWatchdog(onExpired, timeoutMs = SHARD_LEASE_HEARTBEAT_TIMEOUT_MS) {
@@ -76,6 +78,7 @@ export async function startShardWorker(processEnvironment = process.env, identit
     let shardHealthProvider;
     let leaseHeartbeatWatchdog;
     let forcedLeaseExit;
+    let numericWriteBehind;
     async function shutdown(reason = "programmatic") {
         if (shuttingDown)
             return;
@@ -92,6 +95,7 @@ export async function startShardWorker(processEnvironment = process.env, identit
         await moduleEvents?.stop().catch(() => undefined);
         if (runtimeStarted)
             await runtime?.stop().catch(() => undefined);
+        await numericWriteBehind?.stop();
         await client?.destroy();
         eventLoopDelay.disable();
         await database.end();
@@ -104,7 +108,7 @@ export async function startShardWorker(processEnvironment = process.env, identit
         const modulePackages = await loadConfiguredModulePackages(moduleSpecifiers);
         const featureModules = modulePackages.map(({ definition }) => definition);
         client = new Client({
-            intents: gatewayIntentsForModules(featureModules),
+            intents: gatewayIntentsForModules(featureModules, environment.HELYX_MESSAGE_CONTENT_ENABLED),
             partials: [Partials.Message, Partials.Channel, Partials.Reaction],
             allowedMentions: { parse: [] },
             shards: [identity.shardId],
@@ -156,14 +160,27 @@ export async function startShardWorker(processEnvironment = process.env, identit
             ...publicModules,
             ...(operationsModule ? [operationsModule] : []),
         ];
-        const platformServices = new Map(createPlatformServices(database, publicModules, platformServiceOptions(environment, publicModules)));
+        const platformServices = new Map();
+        const serviceAccess = new ServiceRegistry(platformServices);
+        for (const [name, service] of createPlatformServices(database, publicModules, {
+            ...platformServiceOptions(environment, publicModules),
+            activationServices: serviceAccess,
+        })) {
+            platformServices.set(name, service);
+        }
+        numericWriteBehind =
+            identity.scope === "coordinated"
+                ? new WorkerNumericWriteBehindProxy(identity)
+                : createLocalNumericWriteBehind(platformServices, publicModules);
+        platformServices.set(HELYX_SERVICE_NAMES.numericWriteBehind, numericWriteBehind);
         platformServices.set(HELYX_SERVICE_NAMES.resourceAuthorization, new CoreResourceAuthorizationService(platformServices.get(HELYX_SERVICE_NAMES.permissions)));
+        platformServices.set(HELYX_SERVICE_NAMES.discordMessages, new DiscordMessageDeliveryService(client));
         platformServices.set(HELYX_SERVICE_NAMES.discordOwnedMessages, new DiscordOwnedMessageDeletionService(client));
+        platformServices.set(HELYX_SERVICE_NAMES.memberEnforcement, new DiscordMemberEnforcementService(client));
         platformServices.set(HELYX_SERVICE_NAMES.memberRoles, new DiscordMemberRoleService(client));
         platformServices.set(HELYX_SERVICE_NAMES.discordResources, new DiscordResourceInspection(client));
         if (featureModules.some(({ manifest }) => manifest.id === "helyx.logging"))
             platformServices.set(HELYX_SERVICE_NAMES.moduleLogging, new DiscordModuleLoggingService(client, database, publicModules, logger));
-        const serviceAccess = new ServiceRegistry(platformServices);
         const scheduledTaskRoute = createLocalScheduledTaskRoute({
             modules: publicModules,
             services: serviceAccess,
@@ -207,7 +224,7 @@ export async function startShardWorker(processEnvironment = process.env, identit
             if (!parsed.success)
                 return;
             if (parsed.data.type === "helyx.control.request") {
-                void handleControl(identity, controlService, parsed.data);
+                void handleControl(identity, controlService, parsed.data, logger);
             }
             else if (parsed.data.type === "helyx.lease.heartbeat") {
                 if (sameShardIdentity(parsed.data.identity, identity))
@@ -390,7 +407,7 @@ export function shardWorkerCommandRegistration(input) {
         ]),
     };
 }
-async function handleControl(identity, service, request) {
+async function handleControl(identity, service, request, logger) {
     let response;
     const guildId = controlOperationGuildId(request.operation);
     if (request.generation !== identity.generation ||
@@ -418,6 +435,13 @@ async function handleControl(identity, service, request) {
             };
         }
         catch (error) {
+            logger.error({
+                event: "shard.control_failed",
+                requestId: request.requestId,
+                operation: request.operation.kind,
+                guildId,
+                error: safeError(error),
+            }, "Shard control operation failed");
             const mapped = mapBotControlError(error);
             response = {
                 version: 1,
@@ -429,7 +453,27 @@ async function handleControl(identity, service, request) {
             };
         }
     }
-    assertShardMessageSize(response);
+    try {
+        assertShardMessageSize(response);
+    }
+    catch (error) {
+        logger.error({
+            event: "shard.control_response_oversized",
+            requestId: request.requestId,
+            operation: request.operation.kind,
+            guildId,
+            error: safeError(error),
+        }, "Shard control response exceeded the transport limit");
+        response = {
+            version: 1,
+            type: "helyx.control.response",
+            requestId: request.requestId,
+            ok: false,
+            status: 502,
+            message: "The owning shard returned too much data",
+        };
+        assertShardMessageSize(response);
+    }
     process.send?.(response);
 }
 function health(identity, client, status, eventLoopDelayNanoseconds, queueDepth) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helyx/bot",
-  "version": "0.4.8",
+  "version": "0.4.11",
   "description": "Production Discord runtime for the modular Helyx platform.",
   "keywords": [
     "helyx",
@@ -48,14 +48,14 @@
     "start": "node --env-file-if-exists=../../.env dist/index.js"
   },
   "dependencies": {
-    "@helyx/config": "0.4.2",
-    "@helyx/control-protocol": "0.1.4",
-    "@helyx/core": "0.1.8",
-    "@helyx/database": "0.4.2",
-    "@helyx/framework": "0.1.8",
-    "@helyx/module-manifest": "0.4.1",
-    "@helyx/platform": "0.2.6",
-    "@helyx/sdk": "0.3.3",
+    "@helyx/config": "0.4.3",
+    "@helyx/control-protocol": "0.2.0",
+    "@helyx/core": "0.1.11",
+    "@helyx/database": "0.5.0",
+    "@helyx/framework": "0.1.11",
+    "@helyx/module-manifest": "0.5.0",
+    "@helyx/platform": "0.3.0",
+    "@helyx/sdk": "0.4.0",
     "discord.js": "14.27.0",
     "fastify": "5.10.0",
     "pino": "10.3.1",