@goatlab/tasks-adapter-hatchet 0.4.5 → 0.4.6

package/dist/HatchetDispatchListener.d.ts

@@ -0,0 +1,56 @@
+import type { DispatchListener } from '@goatlab/tasks-core';
+import type { Hatchet } from '@hatchet-dev/typescript-sdk';
+/**
+ * Configuration for HatchetDispatchListener.
+ */
+export interface HatchetDispatchListenerConfig {
+    /** Hatchet client instance (already initialized). Use HatchetConnector.getHatchetClient() to obtain. */
+    hatchet: ReturnType<typeof Hatchet.init>;
+    /** URL to trigger dispatch HTTP endpoint */
+    dispatchUrl: string;
+    /** Workflow name for dispatch hints. Default: 'dispatch-hint' */
+    workflowName?: string;
+    /** Optional logger */
+    logger?: {
+        info?: (...args: unknown[]) => void;
+        warn?: (...args: unknown[]) => void;
+        error?: (...args: unknown[]) => void;
+        debug?: (...args: unknown[]) => void;
+    };
+}
+/**
+ * DispatchListener implementation for Hatchet.
+ *
+ * This listener subscribes to Hatchet workflow events and triggers HTTP POST
+ * to the dispatch endpoint when a dispatch-hint workflow runs.
+ *
+ * Unlike GCP Cloud Tasks (which pushes natively), Hatchet workflows are event-driven.
+ * When a hint is enqueued via Hatchet, this worker picks it up and fires an HTTP
+ * request to the dispatch endpoint. This enables Cloud Run auto-scaling via HTTP
+ * request volume.
+ *
+ * The listener uses Hatchet's task + worker pattern (same as HatchetConnector.startWorker).
+ */
+export declare class HatchetDispatchListener implements DispatchListener {
+    private readonly config;
+    private worker;
+    private running;
+    private readonly logger;
+    constructor(config: HatchetDispatchListenerConfig);
+    /**
+     * Start listening for dispatch-hint workflows.
+     *
+     * Creates a Hatchet worker that subscribes to dispatch-hint workflow events.
+     * When a hint is enqueued, the worker executes and triggers HTTP POST to the
+     * dispatch endpoint.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the listener and clean up resources.
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if the listener is running.
+     */
+    isRunning(): boolean;
+}

package/dist/HatchetDispatchListener.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HatchetDispatchListener = void 0;
+/**
+ * DispatchListener implementation for Hatchet.
+ *
+ * This listener subscribes to Hatchet workflow events and triggers HTTP POST
+ * to the dispatch endpoint when a dispatch-hint workflow runs.
+ *
+ * Unlike GCP Cloud Tasks (which pushes natively), Hatchet workflows are event-driven.
+ * When a hint is enqueued via Hatchet, this worker picks it up and fires an HTTP
+ * request to the dispatch endpoint. This enables Cloud Run auto-scaling via HTTP
+ * request volume.
+ *
+ * The listener uses Hatchet's task + worker pattern (same as HatchetConnector.startWorker).
+ */
+class HatchetDispatchListener {
+    config;
+    worker = null;
+    running = false;
+    logger;
+    constructor(config) {
+        this.config = config;
+        this.logger = {
+            info: config.logger?.info ?? console.info,
+            warn: config.logger?.warn ?? console.warn,
+            error: config.logger?.error ?? console.error,
+            debug: config.logger?.debug ?? console.debug,
+        };
+    }
+    /**
+     * Start listening for dispatch-hint workflows.
+     *
+     * Creates a Hatchet worker that subscribes to dispatch-hint workflow events.
+     * When a hint is enqueued, the worker executes and triggers HTTP POST to the
+     * dispatch endpoint.
+     */
+    async start() {
+        if (this.running) {
+            this.logger.warn('[HatchetDispatchListener] Already running');
+            return;
+        }
+        const workflowName = this.config.workflowName ?? 'dispatch-hint';
+        // Create a Hatchet task that triggers HTTP POST on execution
+        const dispatchTask = this.config.hatchet.task({
+            name: workflowName,
+            fn: async () => {
+                try {
+                    // Manual timeout implementation (AbortSignal.timeout not available in all environments)
+                    const controller = new AbortController();
+                    const timeoutId = setTimeout(() => controller.abort(), 60000);
+                    try {
+                        const response = await globalThis.fetch(this.config.dispatchUrl, {
+                            method: 'POST',
+                            headers: {
+                                'Content-Type': 'application/json',
+                                'X-Dispatch-Source': 'listener',
+                            },
+                            signal: controller.signal,
+                        });
+                        clearTimeout(timeoutId);
+                        if (!response.ok) {
+                            throw new Error(`Dispatch failed: ${response.status}`);
+                        }
+                        this.logger.debug('[HatchetDispatchListener] Dispatch trigger succeeded');
+                    }
+                    catch (fetchError) {
+                        clearTimeout(timeoutId);
+                        throw fetchError;
+                    }
+                }
+                catch (error) {
+                    // Log error but let Hatchet handle retry
+                    this.logger.error('[HatchetDispatchListener] Dispatch trigger failed', {
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                    throw error;
+                }
+            },
+        });
+        // Create worker and start listening
+        this.worker = await this.config.hatchet.worker('dispatch-listener', {
+            workflows: [dispatchTask],
+            slots: 5,
+        });
+        await this.worker.start();
+        this.running = true;
+        this.logger.info('[HatchetDispatchListener] Started', {
+            workflowName,
+            dispatchUrl: this.config.dispatchUrl,
+        });
+    }
+    /**
+     * Stop the listener and clean up resources.
+     */
+    async stop() {
+        if (this.worker) {
+            // Hatchet workers have a stop() method for cleanup
+            if (typeof this.worker.stop === 'function') {
+                await this.worker.stop();
+            }
+            this.worker = null;
+        }
+        this.running = false;
+        this.logger.info('[HatchetDispatchListener] Stopped');
+    }
+    /**
+     * Check if the listener is running.
+     */
+    isRunning() {
+        return this.running;
+    }
+}
+exports.HatchetDispatchListener = HatchetDispatchListener;
+//# sourceMappingURL=HatchetDispatchListener.js.map

package/dist/HatchetDispatchListener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HatchetDispatchListener.js","sourceRoot":"","sources":["../src/HatchetDispatchListener.ts"],"names":[],"mappings":";;;AAsBA;;;;;;;;;;;;GAYG;AACH,MAAa,uBAAuB;IAOL;IANrB,MAAM,GAAQ,IAAI,CAAA;IAClB,OAAO,GAAG,KAAK,CAAA;IACN,MAAM,CAEtB;IAED,YAA6B,MAAqC;QAArC,WAAM,GAAN,MAAM,CAA+B;QAChE,IAAI,CAAC,MAAM,GAAG;YACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI;YACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI;YACzC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK;YAC5C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK;SAC7C,CAAA;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,OAAO,EAAE;YAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAA;YAC7D,OAAM;SACP;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,eAAe,CAAA;QAEhE,6DAA6D;QAC7D,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;YAC5C,IAAI,EAAE,YAAY;YAClB,EAAE,EAAE,KAAK,IAAI,EAAE;gBACb,IAAI;oBACF,wFAAwF;oBACxF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;oBACxC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,KAAM,CAAC,CAAA;oBAE9D,IAAI;wBACF,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;4BAC/D,MAAM,EAAE,MAAM;4BACd,OAAO,EAAE;gCACP,cAAc,EAAE,kBAAkB;gCAClC,mBAAmB,EAAE,UAAU;6BAChC;4BACD,MAAM,EAAE,UAAU,CAAC,MAAM;yBAC1B,CAAC,CAAA;wBAEF,YAAY,CAAC,SAAS,CAAC,CAAA;wBAEvB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;4BAChB,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;yBACvD;wBAED,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,sDAAsD,CACvD,CAAA;qBACF;oBAAC,OAAO,UAAU,EAAE;wBACnB,YAAY,CAAC,SAAS,CAAC,CAAA;wBACvB,MAAM,UAAU,CAAA;qBACjB;iBACF;gBAAC,OAAO,KAAK,EAAE;oBACd,yCAAyC;oBACzC,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,mDAAmD,EACnD;wBACE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC9D,CACF,CAAA;oBACD,MAAM,KAAK,CAAA;iBACZ;YACH,CAAC;SACF,CAAC,CAAA;QAEF,oCAAoC;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE;YAClE,SAAS,EAAE,CAAC,YAAY,CAAC;YACzB,KAAK,EAAE,CAAC;SACT,CAAC,CAAA;QAEF,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;QAEzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE;YACpD,YAAY;YACZ,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;SACrC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,MAAM,EAAE;YACf,mDAAmD;YACnD,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE;gBAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;aACzB;YACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;SACnB;QAED,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;QACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAA;IACvD,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;CACF;AAjHD,0DAiHC"}

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export type { HatchetConnectorConfig } from './HatchetConnector';
 export { HatchetConnector } from './HatchetConnector';
+export { HatchetDispatchListener, type HatchetDispatchListenerConfig, } from './HatchetDispatchListener';

package/dist/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HatchetConnector = void 0;
+exports.HatchetDispatchListener = exports.HatchetConnector = void 0;
 var HatchetConnector_1 = require("./HatchetConnector");
 Object.defineProperty(exports, "HatchetConnector", { enumerable: true, get: function () { return HatchetConnector_1.HatchetConnector; } });
+var HatchetDispatchListener_1 = require("./HatchetDispatchListener");
+Object.defineProperty(exports, "HatchetDispatchListener", { enumerable: true, get: function () { return HatchetDispatchListener_1.HatchetDispatchListener; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,uDAAqD;AAA5C,oHAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,uDAAqD;AAA5C,oHAAA,gBAAgB,OAAA;AACzB,qEAGkC;AAFhC,kIAAA,uBAAuB,OAAA"}