@helyx/bot 0.4.40 → 0.4.41

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.4.41
+
+### Patch Changes
+
+- Keep coordinated rolling deployments ready through remote shard ownership and atomically escalate terminal privacy-provider failures to staff review.
+
 ## 0.4.40
 
 ### Patch Changes

package/dist/control-server.d.ts

@@ -559,6 +559,7 @@ export declare function createBotControlServer(input: {
         level: string;
     };
     shardHealth?: () => Promise<ShardHealthSnapshot>;
+    readiness?: () => Promise<boolean>;
     guildCommands?: Parameters<typeof registerGuildCommandControlRoutes>[1];
 }): Promise<FastifyInstance>;
 export declare function mapBotControlError(error: unknown): {

package/dist/control-server.js

@@ -1209,10 +1209,18 @@ export async function createBotControlServer(input) {
             return reply.code(401).send({ message: "Control authentication failed" });
     });
     async function readiness(reply) {
-        if (!input.shardHealth)
+        const deploymentReadiness = input.readiness;
+        const shardHealth = input.shardHealth;
+        if (!deploymentReadiness && !shardHealth)
             return { status: "ok" };
         try {
-            const health = await input.shardHealth();
+            if (deploymentReadiness && (await deploymentReadiness()))
+                return { status: "ok" };
+            if (deploymentReadiness)
+                return reply.code(503).send({ status: "unavailable" });
+            if (!shardHealth)
+                return reply.code(503).send({ status: "unavailable" });
+            const health = await shardHealth();
             if (health.status === "healthy")
                 return { status: "ok" };
         }

package/dist/shard-supervisor.d.ts

@@ -2,7 +2,7 @@ import type { BotEnvironment } from "@helyx/config";
 import { type DatabasePool } from "@helyx/database";
 import type { ModuleDefinition, NumericWriteBehindCommittedBatch, ScheduledTaskExecutionResult } from "@helyx/sdk";
 import { buildApplicationCommandDefinitions } from "./interactions.js";
-import { type ShardCloudRequest, type ShardIdentity, type ShardProcessHealth } from "./shard-contracts.js";
+import { type ShardCloudRequest, type ShardHealthSnapshot, type ShardIdentity, type ShardProcessHealth } from "./shard-contracts.js";
 import { type ShardCoordinator, type ShardGenerationDescriptor, type ShardLeaderLease, type ShardLease } from "./shard-coordinator.js";
 import type { BotHandle } from "./index.js";
 export declare const STEADY_STATE_LEASE_LOSS_BOUND_MS: number;
@@ -20,6 +20,11 @@ export declare function startShardSupervisor(environment: BotEnvironment, proces
 export declare function splitNumericCommittedBatch(batch: NumericWriteBehindCommittedBatch, index: number): NumericWriteBehindCommittedBatch;
 export declare function buildShardWorkerEnvironment(source: NodeJS.ProcessEnv, identity: ShardIdentity, restartCount: number): NodeJS.ProcessEnv;
 export declare function shardRuntimeCompositionHash(modules: readonly ModuleDefinition[], internalGuildId?: string, globalCommandMode?: Parameters<typeof buildApplicationCommandDefinitions>[2]): string;
+export declare function coordinatedFollowerReady(input: {
+    health: ShardHealthSnapshot;
+    activeLeader: ShardLeaderLease | undefined;
+    supervisorId: string;
+}): boolean;
 export declare function boundedRespawnDelay(attempt: number): number;
 export interface SteadyStateOwnershipRenewal {
     generationRenewed: boolean;

package/dist/shard-supervisor.js

@@ -420,6 +420,7 @@ export async function startShardSupervisor(environment, processEnvironment, work
                 secret: environment.HELYX_BOT_CONTROL_SECRET,
                 logger: { level: environment.LOG_LEVEL },
                 shardHealth: buildHealth,
+                readiness: buildDeploymentReadiness,
                 guildCommands: new GuildCommandReadService(database, environment.DISCORD_CLIENT_ID, () => guildCommandWorker?.getHealth(), environment.DISCORD_TOKEN, environment.HELYX_GUILD_COMMAND_WRITES_ENABLED, environment.HELYX_GUILD_COMMAND_WRITE_GUILD_IDS, environment.HELYX_GUILD_COMMAND_WRITE_SCOPE === "all", commandModules),
             });
             await controlServer.listen({
@@ -1343,6 +1344,19 @@ export async function startShardSupervisor(environment, processEnvironment, work
             shards,
         });
     }
+    async function buildDeploymentReadiness() {
+        const health = await buildHealth();
+        if (health.status === "healthy")
+            return true;
+        if (!coordinator)
+            return false;
+        const activeLeader = await withTimeout(coordinator.getLeaderLease(), LEASE_VALIDATION_TIMEOUT_MS).catch(() => undefined);
+        return coordinatedFollowerReady({
+            health,
+            activeLeader,
+            supervisorId,
+        });
+    }
     async function shutdown(reason = "programmatic") {
         if (shuttingDown)
             return;
@@ -1690,6 +1704,16 @@ function boundedOperationalHealth(health) {
         shards: health.shards.slice(0, 25),
     });
 }
+export function coordinatedFollowerReady(input) {
+    return (input.health.scope === "coordinated" &&
+        input.health.status === "degraded" &&
+        input.health.readyShardCount === input.health.configuredShardCount &&
+        input.health.coordination.redis === "healthy" &&
+        input.health.coordination.database === "healthy" &&
+        input.health.scheduler?.status === "unavailable" &&
+        input.activeLeader?.generation === input.health.generation &&
+        input.activeLeader.supervisorId !== input.supervisorId);
+}
 function wait(milliseconds) {
     return new Promise((resolve) => setTimeout(resolve, milliseconds));
 }

package/package.json

@@ -1,74 +1,74 @@
-{
-  "name": "@helyx/bot",
-  "version": "0.4.40",
-  "description": "Production Discord runtime for the modular Helyx platform.",
-  "keywords": [
-    "helyx",
-    "discord",
-    "bot",
-    "modular"
-  ],
-  "private": false,
-  "license": "HSAL 1.0",
-  "homepage": "https://helyx.gg/",
-  "bugs": {
-    "url": "https://github.com/ZyC0R3/Helyx/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ZyC0R3/Helyx.git",
-    "directory": "apps/bot"
-  },
-  "engines": {
-    "node": ">=24 <27",
-    "npm": ">=11"
-  },
-  "publishConfig": {
-    "access": "public",
-    "provenance": true
-  },
-  "type": "module",
-  "files": [
-    "dist",
-    "!dist/*.tsbuildinfo",
-    "!dist/**/*.map",
-    "documentation",
-    "CHANGELOG.md",
-    "README.md",
-    "LICENSE"
-  ],
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    }
-  },
-  "scripts": {
-    "build": "tsc -b",
-    "prepack": "node ../../scripts/public-documentation.mjs --sync-bot",
-    "dev": "node --env-file-if-exists=../../.env --import tsx src/index.ts",
-    "start": "node --env-file-if-exists=../../.env dist/index.js"
-  },
-  "dependencies": {
-    "@helyx/config": ">=0.5.0 <0.6.0",
-    "@helyx/control-protocol": ">=0.4.0 <0.5.0",
-    "@helyx/core": ">=0.1.0 <0.2.0",
-    "@helyx/database": ">=0.8.6 <0.9.0",
-    "@helyx/framework": ">=0.1.0 <0.2.0",
-    "@helyx/module-manifest": ">=0.7.0 <0.8.0",
-    "@helyx/platform": ">=0.6.2 <0.7.0",
-    "@helyx/sdk": ">=0.8.4 <0.9.0",
-    "@helyx/status-client": ">=0.1.0 <0.2.0",
-    "@helyx/verification-contracts": ">=0.3.0 <0.4.0",
-    "discord.js": "14.27.0",
-    "fastify": "5.10.0",
-    "pino": "10.3.1",
-    "redis": "6.1.0",
-    "undici": "6.28.0",
-    "ws": "8.21.1",
-    "zod": "4.4.3"
-  },
-  "devDependencies": {
-    "@types/ws": "8.18.1"
-  }
-}
+{
+  "name": "@helyx/bot",
+  "version": "0.4.41",
+  "description": "Production Discord runtime for the modular Helyx platform.",
+  "keywords": [
+    "helyx",
+    "discord",
+    "bot",
+    "modular"
+  ],
+  "private": false,
+  "license": "HSAL 1.0",
+  "homepage": "https://helyx.gg/",
+  "bugs": {
+    "url": "https://github.com/ZyC0R3/Helyx/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ZyC0R3/Helyx.git",
+    "directory": "apps/bot"
+  },
+  "engines": {
+    "node": ">=24 <27",
+    "npm": ">=11"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "!dist/*.tsbuildinfo",
+    "!dist/**/*.map",
+    "documentation",
+    "CHANGELOG.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "prepack": "node ../../scripts/public-documentation.mjs --sync-bot",
+    "dev": "node --env-file-if-exists=../../.env --import tsx src/index.ts",
+    "start": "node --env-file-if-exists=../../.env dist/index.js"
+  },
+  "dependencies": {
+    "@helyx/config": ">=0.5.0 <0.6.0",
+    "@helyx/control-protocol": ">=0.4.0 <0.5.0",
+    "@helyx/core": ">=0.1.0 <0.2.0",
+    "@helyx/database": ">=0.8.6 <0.9.0",
+    "@helyx/framework": ">=0.1.0 <0.2.0",
+    "@helyx/module-manifest": ">=0.7.0 <0.8.0",
+    "@helyx/platform": ">=0.6.2 <0.7.0",
+    "@helyx/sdk": ">=0.8.4 <0.9.0",
+    "@helyx/status-client": ">=0.1.0 <0.2.0",
+    "@helyx/verification-contracts": ">=0.3.0 <0.4.0",
+    "discord.js": "14.27.0",
+    "fastify": "5.10.0",
+    "pino": "10.3.1",
+    "redis": "6.1.0",
+    "undici": "6.28.0",
+    "ws": "8.21.1",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@types/ws": "8.18.1"
+  }
+}