@hogsend/engine 0.25.0 → 0.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hogsend/engine",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -40,14 +40,14 @@
     "svix": "^1.95.1",
     "winston": "^3.19.0",
     "zod": "^4.4.3",
-    "@hogsend/core": "^0.25.0",
-    "@hogsend/db": "^0.25.0",
-    "@hogsend/email": "^0.25.0",
-    "@hogsend/plugin-posthog": "^0.25.0",
-    "@hogsend/plugin-resend": "^0.25.0"
+    "@hogsend/db": "^0.26.0",
+    "@hogsend/core": "^0.26.0",
+    "@hogsend/email": "^0.26.0",
+    "@hogsend/plugin-posthog": "^0.26.0",
+    "@hogsend/plugin-resend": "^0.26.0"
   },
   "optionalDependencies": {
-    "@hogsend/plugin-postmark": "^0.25.0"
+    "@hogsend/plugin-postmark": "^0.26.0"
   },
   "devDependencies": {
     "@types/node": "^22.15.3",

package/src/connectors/runtime.ts

@@ -72,6 +72,9 @@ export interface ConnectorRuntimesHandle {
 const LEASE_TTL_MS = 30_000;
 const RENEW_MS = 10_000;
 const ELECT_MS = 5_000;
+// ~30s of failed elections (6 * ELECT_MS) before warning loudly that a
+// configured runtime still can't acquire its lease (Redis down or contended).
+const LEASE_MISS_WARN_AT = 6;
 
 /** Build the in-process dispatch→transform→ingest sink for one connector. */
 function makeIngest(client: HogsendClient, connector: DefinedConnector) {
@@ -150,6 +153,7 @@ function startController(
   let leading = false;
   let token = "";
   let stopped = false;
+  let leaseMisses = 0;
   let timer: ReturnType<typeof setTimeout> | undefined;
 
   /** Drop leadership: heartbeat key deleted FIRST (immediate Offline), then socket. */
@@ -178,6 +182,7 @@ function startController(
           ttlMs: LEASE_TTL_MS,
         });
         if (won) {
+          leaseMisses = 0;
           leading = true;
           heartbeat = startConnectorHeartbeat(connectorId, logger);
           heartbeat.state.setMetadata(rt.getMetadata());
@@ -198,6 +203,22 @@ function startController(
             leading = false;
             await releaseLeaderLease({ key: leaseKey, token });
           }
+        } else {
+          // Lease not acquired: another replica holds it (benign, normal during
+          // rollout) OR Redis is unreachable (the gateway can NEVER connect) —
+          // indistinguishable from the boolean. Warn LOUDLY once after ~30s of
+          // misses so a genuinely stuck runtime surfaces instead of silently
+          // never connecting (which Studio otherwise mis-reads as "intents off").
+          leaseMisses++;
+          if (leaseMisses === LEASE_MISS_WARN_AT) {
+            logger.error(
+              "Connector runtime has not acquired its leader lease after ~30s — " +
+                "Redis unreachable (check REDIS_URL points at the SAME instance " +
+                "as the API) or another replica holds it; if none does, the " +
+                "gateway will not connect.",
+              { connectorId },
+            );
+          }
         }
       } else {
         const renewed = await renewLeaderLease({

package/src/routes/admin/connectors.ts

@@ -97,7 +97,10 @@ const connectInfoSchema = z.object({
   apiPublicUrl: z.string(),
   redirectUri: z.string(),
   interactionsUrl: z.string(),
-  ingressSecretConfigured: z.boolean(),
+  // @deprecated legacy standalone-gateway signal (Boolean(CONNECTOR_INGRESS_SECRET)).
+  // The default inline runtime never uses the ingress secret; readiness is
+  // `workerOnline` (the owned Redis heartbeat). Kept one minor; NOT a precondition.
+  legacyIngressSecretConfigured: z.boolean(),
   credentialStored: z.boolean(),
   guildId: z.string().nullable(),
   // Tri-state — null = unknown (no guild from worker or derived credential).
@@ -420,7 +423,7 @@ export const adminConnectorsRouter = new OpenAPIHono<AppEnv>()
         apiPublicUrl,
         redirectUri,
         interactionsUrl: `${apiPublicUrl}/v1/connectors/discord/interactions`,
-        ingressSecretConfigured: Boolean(env.CONNECTOR_INGRESS_SECRET),
+        legacyIngressSecretConfigured: Boolean(env.CONNECTOR_INGRESS_SECRET),
         credentialStored: derived !== null,
         guildId,
         // Tri-state — a guild id (live or derived) confirms install; else null.