@helyx/cli 0.4.3 → 0.4.7

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## 0.4.7
+
+### Patch Changes
+
+- Updated dependencies
+  - @helyx/bot@0.4.5
+
+## 0.4.6
+
+### Patch Changes
+
+- Refresh the bundled self-host catalogue to the registry-verified Stage 4-6
+  release set.
+
+## 0.4.5
+
+### Patch Changes
+
+- Add the reusable managed-resource, durable scheduling, secure checkpointed
+  selection and hosted/self-hosted runtime support required by the Reaction
+  Roles, Polls and Giveaways launch stages.
+- Updated dependencies
+  - @helyx/database@0.4.2
+  - @helyx/bot@0.4.4
+
+## 0.4.4
+
+### Patch Changes
+
+- 18b228d: Add the unified Support transport, hosted configuration, shard-safe staff
+  notifications and paired self-host bug-report claim flow.
+- Updated dependencies [18b228d]
+- Updated dependencies [18b228d]
+  - @helyx/config@0.4.2
+  - @helyx/bot@0.4.3
+  - @helyx/database@0.4.1
+
 ## 0.4.3
 
 ### Patch Changes

package/dist/self-host/project-generator.d.ts

@@ -15,7 +15,8 @@ export interface GeneratedSelfHostProject {
     files: string[];
 }
 export declare function generateSelfHostProject(options: GenerateSelfHostProjectOptions): Promise<GeneratedSelfHostProject>;
-type EnvironmentExample = Record<keyof BotEnvironmentInput, {
+type HostedOnlyBotEnvironment = "HELYX_SUPPORT_SERVICE_SECRET" | "HELYX_SUPPORT_STAFF_CHANNEL_ID";
+type EnvironmentExample = Record<Exclude<keyof BotEnvironmentInput, HostedOnlyBotEnvironment>, {
     value: string;
     optional: boolean;
 }>;

package/dist/self-host/project-generator.js

@@ -215,6 +215,8 @@ function isRecord(value) {
 // This compile-time map intentionally stays adjacent to the generator. Adding a
 // bot environment field makes the generated contract fail to compile until the
 // self-host example receives an explicit safe value or omission decision.
+// Support service authentication and staff delivery remain hosted-only and are
+// deliberately excluded from generated self-host projects.
 export const selfHostEnvironmentContract = {
     DATABASE_URL: {
         value: "postgresql://database:5432/helyx",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helyx/cli",
-  "version": "0.4.3",
+  "version": "0.4.7",
   "description": "Command-line tools for running and generating self-hosted Helyx deployments.",
   "keywords": [
     "helyx",
@@ -52,9 +52,9 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@helyx/bot": "0.4.2",
-    "@helyx/config": "0.4.1",
-    "@helyx/database": "0.4.0",
+    "@helyx/bot": "0.4.5",
+    "@helyx/config": "0.4.2",
+    "@helyx/database": "0.4.2",
     "semver": "7.8.5",
     "zod": "4.4.3"
   },

package/self-host-catalogue.json

@@ -1,14 +1,14 @@
 {
   "schemaVersion": 1,
-  "catalogueVersion": 15,
+  "catalogueVersion": 16,
   "core": {
     "package": "@helyx/bot",
-    "version": "0.4.2",
+    "version": "0.4.4",
     "availability": "published"
   },
   "generator": {
     "package": "@helyx/cli",
-    "version": "0.4.3",
+    "version": "0.4.5",
     "command": "helyx",
     "availability": "published"
   },
@@ -16,7 +16,7 @@
     {
       "id": "helyx.feedback",
       "package": "@helyx/module-feedback",
-      "version": "1.1.2",
+      "version": "1.1.3",
       "name": "Feedback",
       "description": "Collects simple feedback from Discord server members.",
       "category": "Community",
@@ -26,7 +26,7 @@
     {
       "id": "helyx.welcome",
       "package": "@helyx/module-welcome",
-      "version": "1.1.2",
+      "version": "1.1.3",
       "name": "Welcome",
       "description": "Greets new members and can give them a starting role.",
       "category": "Community",
@@ -36,7 +36,7 @@
     {
       "id": "helyx.suggestions",
       "package": "@helyx/module-suggestions",
-      "version": "1.1.2",
+      "version": "1.1.3",
       "name": "Suggestions",
       "description": "Collects community ideas with configurable reaction or button voting.",
       "category": "Community",
@@ -46,12 +46,12 @@
     {
       "id": "helyx.polls",
       "package": "@helyx/module-polls",
-      "version": null,
+      "version": "1.0.0",
       "name": "Polls",
       "description": "Run clear single or multiple-choice polls.",
       "category": "Community",
-      "availability": "planned",
-      "releaseStatus": "planned"
+      "availability": "unpublished",
+      "releaseStatus": "testing"
     },
     {
       "id": "helyx.starboard",
@@ -156,12 +156,12 @@
     {
       "id": "helyx.reactionroles",
       "package": "@helyx/module-reactionroles",
-      "version": null,
-      "name": "Self roles",
+      "version": "1.0.0",
+      "name": "Reaction Roles",
       "description": "Let members select approved roles themselves.",
       "category": "Automation",
-      "availability": "planned",
-      "releaseStatus": "planned"
+      "availability": "unpublished",
+      "releaseStatus": "testing"
     },
     {
       "id": "helyx.reminders",
@@ -206,12 +206,12 @@
     {
       "id": "helyx.giveaways",
       "package": "@helyx/module-giveaways",
-      "version": null,
+      "version": "1.0.0",
       "name": "Giveaways",
       "description": "Run auditable giveaways with eligibility rules.",
       "category": "Engagement",
-      "availability": "planned",
-      "releaseStatus": "planned"
+      "availability": "unpublished",
+      "releaseStatus": "testing"
     },
     {
       "id": "helyx.birthdays",
@@ -236,7 +236,7 @@
     {
       "id": "helyx.logging",
       "package": "@helyx/module-logging",
-      "version": "1.1.2",
+      "version": "1.1.3",
       "name": "Logging",
       "description": "Posts configurable activity records from enabled Helyx modules.",
       "category": "Insights",

package/templates/self-host/.env.example

@@ -73,7 +73,8 @@ HELYX_PRIVACY_ENABLED=false
 # Generated module selection
 HELYX_MODULE_CATALOGUE_PATH=./helyx.modules.json
 
-# Generated privately by npm run setup. Never change it after Cloud Connect.
+# Generated privately by npm run setup. Never change it while Cloud Connect is
+# enrolled or a checkpointed Giveaways draw is in progress.
 # HELYX_DATA_ENCRYPTION_KEY=replace-with-a-base64-encoded-32-byte-key
 
 # Official Cloud Connect endpoints

package/templates/self-host/README.md

@@ -43,6 +43,10 @@ Use this path when Docker with Compose support is available. The included config
 
 Use this path when a provider installs npm packages and runs the package start script for you. Configure `npm start` as the start command and supply every required variable through the provider's environment or variables panel. Use a PostgreSQL database reachable from that provider. A local `.env` file is not required when the host supplies the variables. Generate `HELYX_DATA_ENCRYPTION_KEY` once with `node -e "console.log(require('node:crypto').randomBytes(32).toString('base64'))"`, store it in the provider's secret-variable panel and retain it across every restart and deployment.
 
+That key is also required when Giveaways is selected. Do not rotate it while a
+giveaway draw is in progress because it protects resumable selection
+checkpoints.
+
 If a provider cannot run `npm ci`, execute `npm start`, or connect to PostgreSQL, it cannot run this Helyx starter. A future hosting-specific download may package additional provider files, but it cannot remove the PostgreSQL requirement.
 
 ## Discord setup