@helyx/cli 0.1.4 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.2.0
+
+### Minor Changes
+
+- 7b25ea0: Add the opt-in Helyx Cloud Connect configuration, local persistence, connector runtime, support-redaction contract and generated self-host environment guidance. Cloud Connect remains disabled until a deployment owner explicitly configures and enrols it.
+
+### Patch Changes
+
+- Updated dependencies [7b25ea0]
+  - @helyx/config@0.2.0
+  - @helyx/database@0.2.0
+  - @helyx/bot@0.2.0
+
 ## 0.1.4 - 2026-07-23
 
 - Generate self-hosted projects with the interaction-timeout fix and refreshed

package/dist/self-host/catalogue.d.ts

@@ -20,6 +20,16 @@ export declare const selfHostModuleSchema: z.ZodObject<{
         unpublished: "unpublished";
         published: "published";
     }>;
+    releaseStatus: z.ZodOptional<z.ZodEnum<{
+        planned: "planned";
+        testing: "testing";
+        beta: "beta";
+        live: "live";
+    }>>;
+    tier: z.ZodOptional<z.ZodEnum<{
+        free: "free";
+        premium: "premium";
+    }>>;
 }, z.core.$strict>;
 export declare const selfHostCatalogueSchema: z.ZodObject<{
     schemaVersion: z.ZodLiteral<1>;
@@ -61,6 +71,16 @@ export declare const selfHostCatalogueSchema: z.ZodObject<{
             unpublished: "unpublished";
             published: "published";
         }>;
+        releaseStatus: z.ZodOptional<z.ZodEnum<{
+            planned: "planned";
+            testing: "testing";
+            beta: "beta";
+            live: "live";
+        }>>;
+        tier: z.ZodOptional<z.ZodEnum<{
+            free: "free";
+            premium: "premium";
+        }>>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type SelfHostModule = z.infer<typeof selfHostModuleSchema>;

package/dist/self-host/catalogue.js

@@ -23,6 +23,8 @@ const moduleId = z
     .string()
     .regex(/^helyx\.[a-z0-9][a-z0-9-]*$/u, "must be a Helyx module ID");
 const availability = z.enum(["planned", "unpublished", "published"]);
+const releaseStatus = z.enum(["planned", "testing", "beta", "live"]);
+const moduleTier = z.enum(["free", "premium"]);
 const componentSchema = z
     .object({
     package: helyxPackage,
@@ -47,6 +49,8 @@ export const selfHostModuleSchema = z
     description: z.string().trim().min(1).max(300),
     category: z.enum(selfHostCategories),
     availability,
+    releaseStatus: releaseStatus.optional(),
+    tier: moduleTier.optional(),
 })
     .strict()
     .superRefine((module, context) => {

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

@@ -238,6 +238,39 @@ export const selfHostEnvironmentContract = {
         optional: true,
     },
     HELYX_BOT_CONTROL_PORT: { value: "3001", optional: true },
+    HELYX_CLOUD_CONNECT_ENABLED: { value: "false", optional: false },
+    HELYX_CLOUD_ENROLMENT_TOKEN: {
+        value: "replace-with-a-short-lived-enrolment-code",
+        optional: true,
+    },
+    HELYX_CLOUD_ENROLMENT_FILE: {
+        value: "./helyx.cloud-enrolment.json",
+        optional: true,
+    },
+    HELYX_DATA_ENCRYPTION_KEY: {
+        value: "replace-with-a-base64-encoded-32-byte-key",
+        optional: true,
+    },
+    HELYX_CLOUD_API_URL: {
+        value: "https://api.helyx.gg",
+        optional: true,
+    },
+    HELYX_CLOUD_ENDPOINT: {
+        value: "wss://connect.helyx.gg/v1/connect",
+        optional: true,
+    },
+    HELYX_OWNER_USER_IDS: {
+        value: "12345678901234567",
+        optional: true,
+    },
+    HELYX_CLOUD_AUDIT_RETENTION_DAYS: {
+        value: "90",
+        optional: true,
+    },
+    HELYX_CLOUD_CREDENTIAL_AUDIT_RETENTION_DAYS: {
+        value: "365",
+        optional: true,
+    },
     LOG_LEVEL: { value: "info", optional: false },
     NODE_ENV: { value: "production", optional: false },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helyx/cli",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "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.1.3",
-    "@helyx/config": "0.1.2",
-    "@helyx/database": "0.1.1",
+    "@helyx/bot": "0.2.0",
+    "@helyx/config": "0.2.0",
+    "@helyx/database": "0.2.0",
     "semver": "7.8.5",
     "zod": "4.4.3"
   },

package/self-host-catalogue.json

@@ -92,7 +92,9 @@
       "name": "Verification",
       "description": "Add a deliberate member verification step.",
       "category": "Safety",
-      "availability": "planned"
+      "availability": "planned",
+      "releaseStatus": "testing",
+      "tier": "premium"
     },
     {
       "id": "helyx.antiraid",

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

@@ -21,6 +21,17 @@ HELYX_MODULE_CATALOGUE_PATH=./helyx.modules.json
 # HELYX_BOT_CONTROL_SECRET=replace-with-a-base64-encoded-32-byte-key
 # HELYX_BOT_CONTROL_PORT=3001
 
+# Optional Helyx Cloud Connect. It remains fully disabled unless set to true.
+HELYX_CLOUD_CONNECT_ENABLED=false
+# HELYX_CLOUD_ENROLMENT_TOKEN=replace-with-a-short-lived-enrolment-code
+# HELYX_CLOUD_ENROLMENT_FILE=./helyx.cloud-enrolment.json
+# HELYX_DATA_ENCRYPTION_KEY=replace-with-a-base64-encoded-32-byte-key
+# HELYX_CLOUD_API_URL=https://api.helyx.gg
+# HELYX_CLOUD_ENDPOINT=wss://connect.helyx.gg/v1/connect
+# HELYX_OWNER_USER_IDS=12345678901234567
+# HELYX_CLOUD_AUDIT_RETENTION_DAYS=90
+# HELYX_CLOUD_CREDENTIAL_AUDIT_RETENTION_DAYS=365
+
 LOG_LEVEL=info
 NODE_ENV=production
 

package/templates/self-host/gitignore.template

@@ -1,3 +1,4 @@
 .env
+helyx.cloud-enrolment.json
 node_modules/
 npm-debug.log*