@hatchet-dev/typescript-sdk 1.32.0 → 1.33.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hatchet-dev/typescript-sdk",
-  "version": "1.32.0",
+  "version": "1.33.0",
   "engines": {
     "node": ">=20"
   },

package/v1/client/worker/health-server.d.ts

@@ -23,6 +23,8 @@ export declare class HealthServer {
     constructor(port: number, getStatus: () => WorkerStatus, workerName: string, getSlots: () => number, getActions: () => string[], getLabels: () => Record<string, string | number>, logger: Logger);
     private handleRequest;
     private handleHealth;
+    private handleReadyz;
+    private handleLivez;
     private initializeMetrics;
     private handleMetrics;
     start(): Promise<void>;

package/v1/client/worker/health-server.js

@@ -40,6 +40,12 @@ class HealthServer {
             if (url === '/health' && req.method === 'GET') {
                 yield this.handleHealth(res);
             }
+            else if (url === '/readyz' && req.method === 'GET') {
+                this.handleReadyz(res);
+            }
+            else if (url === '/livez' && req.method === 'GET') {
+                this.handleLivez(res);
+            }
             else if (url === '/metrics' && req.method === 'GET') {
                 yield this.handleMetrics(res);
             }
@@ -59,10 +65,32 @@ class HealthServer {
                 labels: this.getLabels(),
                 nodeVersion: process.version,
             };
+            // Always return 200 for compatibility with consumers that inspect the JSON
+            // status. Use /readyz when the HTTP status must indicate readiness.
             res.writeHead(200, { 'Content-Type': 'application/json' });
             yield res.end(JSON.stringify(response));
         });
     }
+    // Kubernetes-style readiness probe: 200 only when the worker is HEALTHY
+    // (registered and holding an action listener), 503 otherwise. Unlike
+    // /health, this is a plain status-code contract a vanilla `httpGet` probe
+    // can consume directly, with no body to parse.
+    handleReadyz(res) {
+        const ready = this.getStatus() === exports.workerStatus.HEALTHY;
+        res.writeHead(ready ? 200 : 503, { 'Content-Type': 'text/plain' });
+        res.end(ready ? 'ok' : 'not ready');
+    }
+    // Kubernetes-style liveness probe: 200 whenever this handler can run at
+    // all, deliberately independent of Hatchet connectivity. A worker that has
+    // temporarily lost its action listener (UNHEALTHY) should be pulled from
+    // rotation via /readyz, not killed and restarted via /livez — restarting
+    // does nothing to fix an upstream Hatchet outage and drops in-flight work.
+    // /livez only needs to fail when the process itself is deadlocked/wedged,
+    // which this HTTP response reaching the caller already disproves.
+    handleLivez(res) {
+        res.writeHead(200, { 'Content-Type': 'text/plain' });
+        res.end('ok');
+    }
     initializeMetrics() {
         try {
             // THIS IS AN OPTIONAL DEPENDENCY

package/version.d.ts

@@ -1 +1 @@
-export declare const HATCHET_VERSION = "1.32.0";
+export declare const HATCHET_VERSION = "1.33.0";

package/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HATCHET_VERSION = void 0;
-exports.HATCHET_VERSION = '1.32.0';
+exports.HATCHET_VERSION = '1.33.0';