@helyx/bot 1.5.0 → 1.5.1

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 1.5.1
+
+### Patch Changes
+
+- Add the server-scoped `/diag` command with administrator access, one active
+  run per server, guarded repair passes and fresh checks before reporting fixes.
+  Preserve records and configuration outside the explicitly supported repairs.
+- Require PostgreSQL adapter 2.4.1 or MySQL adapter 0.2.1 for the active,
+  non-blacklisted server lookup used by diagnostic admission checks.
+
 ## 1.5.0
 
 ### Minor Changes

package/dist/command-registration-policy.js

@@ -1,6 +1,7 @@
 import { isCustomerSelectableModule } from "@helyx/module-manifest";
 const platformGlobalModuleIds = new Set([
     "helyx.management",
+    "helyx.diagnostics",
     "helyx.support",
     "helyx.oauth",
     "helyx.permissions",

package/dist/diagnostic-command.d.ts

@@ -0,0 +1,76 @@
+import type { DatabasePool } from "@helyx/database";
+import type { MysqlPool } from "@helyx/database-mysql";
+import { type ModuleDefinition, type ModuleRecordService, type PermissionActor, type ServiceAccess } from "@helyx/sdk";
+import { type Client } from "discord.js";
+export interface DiagnosticIssue {
+    kind: "repairable" | "human" | "technical" | "incomplete";
+    message: string;
+    evidence?: Readonly<Record<string, unknown>>;
+    afterRepair?: string;
+}
+export interface DiagnosticProbe {
+    id: string;
+    moduleId?: string;
+    label: string;
+    inspect(this: void): Promise<DiagnosticIssue | null>;
+    repair?(round: 1 | 2, issue: DiagnosticIssue): Promise<"attempted" | "unchanged" | "stale">;
+    verify?(issue: DiagnosticIssue): Promise<boolean>;
+}
+export interface DiagnosticLease {
+    signal: AbortSignal;
+    assertOwned(): Promise<void>;
+}
+export type DiagnosticRunExclusive = (guildId: string, operation: (lease: DiagnosticLease) => Promise<void>) => Promise<boolean>;
+export interface DiagnosticResources {
+    actor(userId: string): Promise<PermissionActor>;
+    message(channelId: string, messageId: string): Promise<"present" | "absent" | "unknown">;
+    channel(channelId: string, types: readonly string[], permissions: readonly string[]): Promise<DiagnosticIssue | null>;
+    role(roleId: string, managed: boolean): Promise<DiagnosticIssue | null>;
+    capabilities(): {
+        guildMembers: boolean;
+        messageContent: boolean;
+    };
+    guildCommands?(): Promise<{
+        definitionHash: string;
+        rootCount: number;
+    }>;
+}
+export interface DiagnosticModuleOptions {
+    modules: readonly ModuleDefinition[];
+    client?: Client;
+    resources?: (guildId: string) => DiagnosticResources;
+    runExclusive?: DiagnosticRunExclusive;
+    assertGuildAvailable?: (guildId: string) => Promise<void>;
+    listEnabledModules?: (guildId: string) => Promise<readonly {
+        moduleId: string;
+    }[]>;
+    commandStatus?: {
+        get(guildId: string): Promise<unknown>;
+        refresh(input: {
+            guildId: string;
+            actorUserId: string;
+            correlationId: string;
+        }): Promise<unknown>;
+    };
+    stageMilliseconds?: number;
+    maximumRunMilliseconds?: number;
+}
+export interface DiagnosticRecordEnvironment {
+    guildId: string;
+    actorUserId: string;
+    correlationId: string;
+    modules: readonly ModuleDefinition[];
+    records: ModuleRecordService;
+    services: ServiceAccess;
+    assertCanInspect(): Promise<void>;
+    assertCanMutate(moduleId: string): Promise<void>;
+    inspectMessage(channelId: string, messageId: string): Promise<"present" | "absent" | "unknown">;
+    now(): Date;
+}
+/** A core command, never a selectable module or a module-repair hook. */
+export declare function createDiagnosticModule(options: DiagnosticModuleOptions): ModuleDefinition;
+/** Reserve at most four sessions, leaving at least two pool slots for repairs. */
+export declare function createPostgresDiagnosticLock(pool: DatabasePool): DiagnosticRunExclusive;
+/** Reserve at most four sessions, leaving at least two pool slots for repairs. */
+export declare function createMysqlDiagnosticLock(pool: MysqlPool): DiagnosticRunExclusive;
+//# sourceMappingURL=diagnostic-command.d.ts.map