@helyx/module-reactionroles 1.0.21 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @helyx/module-reactionroles
 
+## 1.1.0
+
+### Minor Changes
+
+- Prepare the coordinated Phase 8 minor release and align internal package dependencies. Existing deployment and database-support restrictions are unchanged.
+
+### Patch Changes
+
+- Defer owned-message recovery until Discord is ready so restarts do not consume cleanup retries before login.
+
+- Updated dependencies
+  - @helyx/module-manifest@0.13.0
+  - @helyx/sdk@0.15.0
+
+## 1.0.22
+
+### Patch Changes
+
+- Bound internal dependencies to compatible releases while preserving each
+  consumer's required minimum API version.
+
 ## 1.0.21
 
 ### Patch Changes
@@ -97,25 +118,7 @@
 
 ### Patch Changes
 
-- Accept compatible internal Helyx releases within explicit minor-safe pre-1.0 or major-safe stable ranges, preventing dependency-only patch cascades.---
-  "@helyx/bot": patch
-  "@helyx/cli": patch
-  "@helyx/core": patch
-  "@helyx/framework": patch
-  "@helyx/platform": patch
-  "@helyx/sdk": patch
-  "@helyx/module-account-gate": patch
-  "@helyx/module-feedback": patch
-  "@helyx/module-giveaways": patch
-  "@helyx/module-levels": patch
-  "@helyx/module-logging": patch
-  "@helyx/module-polls": patch
-  "@helyx/module-reactionroles": patch
-  "@helyx/module-suggestions": patch
-  "@helyx/module-welcome": patch
-  ---
-
-  Accept compatible internal Helyx releases within explicit minor-safe pre-1.0 or major-safe stable ranges, preventing dependency-only patch cascades.
+- Accept compatible internal Helyx releases within explicit minor-safe pre-1.0 or major-safe stable ranges, preventing dependency-only patch cascades.
 
 ## 1.0.8
 

package/README.md

@@ -28,7 +28,7 @@ Helyx stores panel and entry configuration, Helyx-owned message references, life
 
 ## Operations and failure behavior
 
-Every owned-message cleanup record atomically schedules a bounded one-shot retry through the core scheduler; startup also reconciles paginated pending work before warming the bounded active-panel cache. Exhausted cleanup remains durable for operator review. Unknown message reactions use a short negative cache and coalesced lookups. Deleted or invalid Discord resources move affected panels to `message_missing` or `needs_attention`; repair or repost restores them. Health is unhealthy while stopped, when required services are missing, or after a recent primary operation failure, and degraded for cold-cache startup, cache saturation, or pending cleanup failure.
+Every owned-message cleanup record atomically schedules a bounded one-shot retry through the core scheduler. Startup reconciles paginated pending work when Discord is ready and warms the bounded active-panel cache; otherwise the normal worker handles cleanup after connection without consuming a pre-login attempt. Exhausted cleanup remains durable for operator review. Unknown message reactions use a short negative cache and coalesced lookups. Deleted or invalid Discord resources move affected panels to `message_missing` or `needs_attention`; repair or repost restores them. Health is unhealthy while stopped, when required services are missing, or after a recent primary operation failure, and degraded for cold-cache startup, cache saturation, or pending cleanup failure.
 
 Disablement stops new interactions without deleting configuration. Re-enable only after checking channel access, role hierarchy, and emoji availability. Rollback may restore compatible application code, but must not reverse migrations or delete panel data.
 

package/dist/panel-lifecycle.js

@@ -31,8 +31,10 @@ export class PanelLifecycleService {
     async recoverMessageCleanup(services) {
         if (!services.has(HELYX_SERVICE_NAMES.discordOwnedMessages))
             return { completed: 0, failed: 0, abandoned: 0 };
-        const repository = this.repositoryFor(services);
         const messages = services.get(HELYX_SERVICE_NAMES.discordOwnedMessages);
+        if (messages.isReady?.() === false)
+            return { completed: 0, failed: 0, abandoned: 0 };
+        const repository = this.repositoryFor(services);
         let completed = 0;
         let failed = 0;
         let abandoned = 0;
@@ -75,6 +77,16 @@ export class PanelLifecycleService {
                 },
                 recovered: false,
             };
+        const messages = services.get(HELYX_SERVICE_NAMES.discordOwnedMessages);
+        if (messages.isReady?.() === false)
+            return {
+                result: {
+                    outcome: "deferred",
+                    delayMs: 60_000,
+                    safeCode: "reaction_role_cleanup_discord_not_ready",
+                },
+                recovered: false,
+            };
         const repository = this.repositoryFor(services);
         let cleanup;
         try {
@@ -134,7 +146,7 @@ export class PanelLifecycleService {
                 recovered: false,
             };
         try {
-            await this.completeClaimedCleanup(repository, services.get(HELYX_SERVICE_NAMES.discordOwnedMessages), claimed);
+            await this.completeClaimedCleanup(repository, messages, claimed);
             return { result: { outcome: "completed" }, recovered: true };
         }
         catch {

package/manifest.json

@@ -1,5 +1,6 @@
 {
   "manifestVersion": "0.4",
+  "databaseEngines": ["postgresql", "mysql"],
   "releaseStatus": "live",
   "deploymentSupport": "both",
   "credentialRisk": "none",
@@ -10,10 +11,10 @@
   "healthExposure": "direct",
   "id": "helyx.reactionroles",
   "name": "Reaction Roles",
-  "version": "1.0.21",
+  "version": "1.1.0",
   "description": "Let members select approved roles themselves.",
   "entry": "./dist/index.js",
-  "framework": "^0.1.0",
+  "framework": "^0.2.0",
   "dependencies": [],
   "permissions": [
     "ADD_REACTIONS",

package/migrations-mysql/0001_reactionroles_foundation.sql

@@ -0,0 +1,89 @@
+CREATE TABLE reactionroles_panels (
+  panel_id CHAR(36) CHARACTER SET ascii COLLATE ascii_bin PRIMARY KEY,
+  guild_id VARCHAR(20) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+  channel_id VARCHAR(20) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+  message_id VARCHAR(20) CHARACTER SET ascii COLLATE ascii_bin NULL,
+  title VARCHAR(80) COLLATE utf8mb4_bin NOT NULL,
+  message_body VARCHAR(1000) COLLATE utf8mb4_bin NOT NULL,
+  message_style VARCHAR(5) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+  control_type VARCHAR(9) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+  selection_mode VARCHAR(8) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+  embed_colour INT NULL,
+  dropdown_placeholder VARCHAR(100) COLLATE utf8mb4_bin NULL,
+  status VARCHAR(15) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+  revision BIGINT NOT NULL DEFAULT 1,
+  created_by_user_id VARCHAR(20) CHARACTER SET ascii COLLATE ascii_bin NULL,
+  updated_by_user_id VARCHAR(20) CHARACTER SET ascii COLLATE ascii_bin NULL,
+  created_at DATETIME(3) NOT NULL,
+  updated_at DATETIME(3) NOT NULL,
+  persistent_reactions BOOLEAN NOT NULL DEFAULT TRUE,
+  CONSTRAINT reactionroles_panels_message_unique UNIQUE (guild_id, message_id),
+  KEY reactionroles_panels_guild_status_idx (guild_id, status, updated_at DESC, panel_id),
+  CHECK (CHAR_LENGTH(title) BETWEEN 1 AND 80),
+  CHECK (CHAR_LENGTH(message_body) BETWEEN 1 AND 1000),
+  CHECK (message_style IN ('text', 'embed')),
+  CHECK (control_type IN ('buttons', 'dropdown', 'reactions')),
+  CHECK (selection_mode IN ('multiple', 'one_only')),
+  CHECK (embed_colour IS NULL OR embed_colour BETWEEN 0 AND 16777215),
+  CHECK (dropdown_placeholder IS NULL OR CHAR_LENGTH(dropdown_placeholder) BETWEEN 1 AND 100),
+  CHECK (status IN ('pending', 'active', 'disabled', 'message_missing',
+    'needs_attention', 'cleanup_pending', 'deleting')),
+  CHECK (revision > 0),
+  CHECK (persistent_reactions IN (0, 1)),
+  CONSTRAINT reactionroles_panels_reaction_selection_check CHECK (
+    control_type <> 'reactions' OR selection_mode <> 'one_only'
+    OR persistent_reactions = FALSE
+  )
+) ENGINE=InnoDB DEFAULT CHARACTER SET=utf8mb4 COLLATE=utf8mb4_bin;
+
+CREATE TABLE reactionroles_entries (
+  entry_id VARCHAR(100) CHARACTER SET ascii COLLATE ascii_bin PRIMARY KEY,
+  panel_id CHAR(36) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+  position INT NOT NULL,
+  role_id VARCHAR(20) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+  nameplate VARCHAR(80) COLLATE utf8mb4_bin NOT NULL,
+  emoji_kind VARCHAR(7) CHARACTER SET ascii COLLATE ascii_bin NULL,
+  emoji_name VARCHAR(80) COLLATE utf8mb4_bin NULL,
+  emoji_id VARCHAR(20) CHARACTER SET ascii COLLATE ascii_bin NULL,
+  emoji_animated BOOLEAN NULL,
+  button_style VARCHAR(9) CHARACTER SET ascii COLLATE ascii_bin NULL,
+  created_at DATETIME(3) NOT NULL,
+  updated_at DATETIME(3) NOT NULL,
+  emoji_id_unique VARCHAR(20) CHARACTER SET ascii COLLATE ascii_bin
+    GENERATED ALWAYS AS (COALESCE(emoji_id, '')) STORED,
+  CONSTRAINT reactionroles_entries_panel_fk FOREIGN KEY (panel_id)
+    REFERENCES reactionroles_panels (panel_id) ON DELETE CASCADE,
+  CONSTRAINT reactionroles_entries_panel_position_unique UNIQUE (panel_id, position),
+  CONSTRAINT reactionroles_entries_panel_role_unique UNIQUE (panel_id, role_id),
+  CONSTRAINT reactionroles_entries_emoji_unique UNIQUE
+    (panel_id, emoji_kind, emoji_name, emoji_id_unique),
+  KEY reactionroles_entries_panel_idx (panel_id, position),
+  KEY reactionroles_entries_role_panel_idx (role_id, panel_id),
+  KEY reactionroles_entries_emoji_panel_idx (emoji_id, panel_id),
+  CHECK (position BETWEEN 0 AND 24),
+  CHECK (CHAR_LENGTH(nameplate) BETWEEN 1 AND 80),
+  CHECK (emoji_kind IS NULL OR emoji_kind IN ('unicode', 'custom')),
+  CHECK (emoji_animated IS NULL OR emoji_animated IN (0, 1)),
+  CHECK (button_style IS NULL OR button_style IN ('primary', 'secondary', 'success', 'danger')),
+  CHECK ((emoji_kind IS NULL AND emoji_name IS NULL AND emoji_id IS NULL)
+    OR (emoji_kind = 'unicode' AND emoji_name IS NOT NULL AND emoji_id IS NULL)
+    OR (emoji_kind = 'custom' AND emoji_name IS NOT NULL AND emoji_id IS NOT NULL))
+) ENGINE=InnoDB DEFAULT CHARACTER SET=utf8mb4 COLLATE=utf8mb4_bin;
+
+CREATE TABLE reactionroles_message_cleanup (
+  cleanup_id CHAR(36) CHARACTER SET ascii COLLATE ascii_bin PRIMARY KEY,
+  guild_id VARCHAR(20) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+  panel_id CHAR(36) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+  channel_id VARCHAR(20) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+  message_id VARCHAR(20) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+  reason VARCHAR(11) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+  attempts INT NOT NULL DEFAULT 0,
+  next_attempt_at DATETIME(3) NOT NULL,
+  created_at DATETIME(3) NOT NULL,
+  completed_at DATETIME(3) NULL,
+  CONSTRAINT reactionroles_cleanup_message_reason_unique UNIQUE
+    (guild_id, channel_id, message_id, reason),
+  KEY reactionroles_cleanup_pending_idx (completed_at, next_attempt_at, created_at),
+  CHECK (reason IN ('replacement', 'rollback', 'delete')),
+  CHECK (attempts BETWEEN 0 AND 10)
+) ENGINE=InnoDB DEFAULT CHARACTER SET=utf8mb4 COLLATE=utf8mb4_bin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helyx/module-reactionroles",
-  "version": "1.0.21",
+  "version": "1.1.0",
   "description": "Configurable self-service Discord role panels for Helyx.",
   "keywords": [
     "helyx",
@@ -25,7 +25,7 @@
   },
   "publishConfig": {
     "access": "public",
-    "provenance": true
+    "provenance": false
   },
   "type": "module",
   "files": [
@@ -33,6 +33,7 @@
     "!dist/*.tsbuildinfo",
     "!dist/**/*.map",
     "migrations",
+    "migrations-mysql",
     "manifest.json",
     "README.md",
     "CHANGELOG.md",
@@ -49,7 +50,7 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@helyx/module-manifest": ">=0.11.0 <0.12.0",
-    "@helyx/sdk": ">=0.14.0"
+    "@helyx/module-manifest": ">=0.13.0 <0.14.0",
+    "@helyx/sdk": ">=0.15.0 <0.16.0"
   }
 }