@hatchet-dev/typescript-sdk 1.29.3 → 1.30.1

package/v1/examples/durable_callback_ordering/workflow.js

@@ -0,0 +1,95 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callbackOrderingRoot = exports.callbackOrderingMid = exports.callbackOrderingLeaf = exports.ROOT_DEFAULTS = void 0;
+const sleep_1 = __importDefault(require("../../../util/sleep"));
+const hatchet_client_1 = require("../hatchet-client");
+const WORKFLOW_PREFIX = 'durable-callback-ordering';
+const EVICTION_POLICY = {
+    ttl: 250,
+    allowCapacityEviction: true,
+    priority: 0,
+};
+exports.ROOT_DEFAULTS = {
+    durables: 4,
+    branches: 8,
+    childDelayMs: 1500,
+    delayStepMs: 3,
+};
+exports.callbackOrderingLeaf = hatchet_client_1.hatchet.task({
+    name: `${WORKFLOW_PREFIX}-leaf`,
+    executionTimeout: '1m',
+    fn: (input) => __awaiter(void 0, void 0, void 0, function* () {
+        yield (0, sleep_1.default)(input.delayMs);
+        return { mid: input.mid, branch: input.branch, generation: input.generation };
+    }),
+});
+exports.callbackOrderingMid = hatchet_client_1.hatchet.durableTask({
+    name: `${WORKFLOW_PREFIX}-mid`,
+    executionTimeout: '5m',
+    retries: 0,
+    evictionPolicy: EVICTION_POLICY,
+    fn: (input, ctx) => __awaiter(void 0, void 0, void 0, function* () {
+        // Staggered first-generation children complete out of spawn order, so each
+        // branch's second-generation spawn is emitted in completion order. Replays
+        // after eviction must re-deliver those completions in the recorded order or
+        // the re-emitted spawn sequence diverges from the event log.
+        const branch = (branchIndex) => __awaiter(void 0, void 0, void 0, function* () {
+            const firstDelayMs = input.childDelayMs + (input.branches - branchIndex - 1) * input.delayStepMs;
+            const first = yield exports.callbackOrderingLeaf.run({
+                mid: input.mid,
+                branch: branchIndex,
+                delayMs: firstDelayMs,
+                generation: 1,
+            });
+            const second = yield exports.callbackOrderingLeaf.run({
+                mid: input.mid,
+                branch: first.branch,
+                delayMs: input.childDelayMs,
+                generation: 2,
+            });
+            return second.branch;
+        });
+        const completed = yield Promise.all(Array.from({ length: input.branches }, (_, branchIndex) => branch(branchIndex)));
+        return {
+            mid: input.mid,
+            completedBranches: completed,
+            invocationCount: ctx.invocationCount,
+        };
+    }),
+});
+exports.callbackOrderingRoot = hatchet_client_1.hatchet.durableTask({
+    name: `${WORKFLOW_PREFIX}-root`,
+    executionTimeout: '10m',
+    retries: 0,
+    evictionPolicy: EVICTION_POLICY,
+    fn: (input, ctx) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        const durables = (_a = input.durables) !== null && _a !== void 0 ? _a : exports.ROOT_DEFAULTS.durables;
+        const results = yield Promise.all(Array.from({ length: durables }, (_, midIndex) => {
+            var _a, _b, _c;
+            return exports.callbackOrderingMid.run({
+                mid: midIndex,
+                branches: (_a = input.branches) !== null && _a !== void 0 ? _a : exports.ROOT_DEFAULTS.branches,
+                childDelayMs: (_b = input.childDelayMs) !== null && _b !== void 0 ? _b : exports.ROOT_DEFAULTS.childDelayMs,
+                delayStepMs: (_c = input.delayStepMs) !== null && _c !== void 0 ? _c : exports.ROOT_DEFAULTS.delayStepMs,
+            });
+        }));
+        return {
+            rootInvocationCount: ctx.invocationCount,
+            midInvocationCounts: results.map((item) => item.invocationCount),
+            completedMids: results.map((item) => item.mid),
+        };
+    }),
+});

package/v1/examples/durable_eviction/workflow.d.ts

@@ -13,6 +13,11 @@ export declare const evictableSleepForGracefulTermination: import("../..").TaskW
 export declare const evictableWaitForEvent: import("../..").TaskWorkflowDeclaration<import("../..").JsonObject, {
     status: string;
 }, {}, {}, {}, {}>;
+export declare const MEMO_EVENT_KEY = "durable-eviction:memo-event";
+export declare const evictableMemoThenWaitForEvent: import("../..").TaskWorkflowDeclaration<import("../..").JsonObject, {
+    status: string;
+    memoizedNow: string;
+}, {}, {}, {}, {}>;
 export declare const evictableChildSpawn: import("../..").TaskWorkflowDeclaration<import("../..").JsonObject, {
     child: {
         child_status: string;

package/v1/examples/durable_eviction/workflow.js

@@ -12,7 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.nonEvictableSleep = exports.capacityEvictableSleep = exports.CAPACITY_SLEEP_SECONDS = exports.evictableChildBulkSpawn = exports.bulkChildTask = exports.multipleEviction = exports.evictableChildSpawn = exports.evictableWaitForEvent = exports.evictableSleepForGracefulTermination = exports.evictableSleep = exports.childTask = exports.EVENT_KEY = exports.LONG_SLEEP_SECONDS = exports.EVICTION_TTL_SECONDS = void 0;
+exports.nonEvictableSleep = exports.capacityEvictableSleep = exports.CAPACITY_SLEEP_SECONDS = exports.evictableChildBulkSpawn = exports.bulkChildTask = exports.multipleEviction = exports.evictableChildSpawn = exports.evictableMemoThenWaitForEvent = exports.MEMO_EVENT_KEY = exports.evictableWaitForEvent = exports.evictableSleepForGracefulTermination = exports.evictableSleep = exports.childTask = exports.EVENT_KEY = exports.LONG_SLEEP_SECONDS = exports.EVICTION_TTL_SECONDS = void 0;
 const sleep_1 = __importDefault(require("../../../util/sleep"));
 const hatchet_client_1 = require("../hatchet-client");
 exports.EVICTION_TTL_SECONDS = 5;
@@ -66,6 +66,20 @@ exports.evictableWaitForEvent = hatchet_client_1.hatchet.durableTask({
         return { status: 'completed' };
     }),
 });
+exports.MEMO_EVENT_KEY = 'durable-eviction:memo-event';
+exports.evictableMemoThenWaitForEvent = hatchet_client_1.hatchet.durableTask({
+    name: 'evictable-memo-then-wait-for-event',
+    executionTimeout: '5m',
+    evictionPolicy: EVICTION_POLICY,
+    fn: (_input, ctx) => __awaiter(void 0, void 0, void 0, function* () {
+        // now() records a memo node. On replay after eviction, the server
+        // re-delivers that node's completion, which never has a callback waiter
+        // and must not block the event completion queued behind it.
+        const memoizedNow = yield ctx.now();
+        yield ctx.waitForEvent(exports.MEMO_EVENT_KEY, 'true');
+        return { status: 'completed', memoizedNow: memoizedNow.toISOString() };
+    }),
+});
 exports.evictableChildSpawn = hatchet_client_1.hatchet.durableTask({
     name: 'evictable-child-spawn',
     executionTimeout: '5m',

package/v1/examples/e2e-worker.js

@@ -22,30 +22,33 @@ const cancellation_workflow_1 = require("./cancellation/cancellation-workflow");
 const complex_workflow_1 = require("./conditions/complex-workflow");
 const workflow_3 = require("./concurrency_cancel_in_progress/workflow");
 const workflow_4 = require("./concurrency_cancel_newest/workflow");
-const workflow_5 = require("./concurrency_multiple_keys/workflow");
-const workflow_6 = require("./concurrency_workflow_level/workflow");
-const workflow_7 = require("./dag/workflow");
-const workflow_8 = require("./durable/workflow");
-const workflow_9 = require("./durable_event/workflow");
-const workflow_10 = require("./durable_eviction/workflow");
-const workflow_11 = require("./durable_sleep/workflow");
-const workflow_12 = require("./logger/workflow");
-const workflow_13 = require("./non_retryable/workflow");
-const workflow_14 = require("./on_failure/workflow");
-const workflow_15 = require("./idempotency/workflow");
-const workflow_16 = require("./on_event/workflow");
-const workflow_17 = require("./return_exceptions/workflow");
-const workflow_18 = require("./run_details/workflow");
+const workflow_5 = require("./concurrency_cancel_queued_except_newest/workflow");
+const workflow_6 = require("./concurrency_cancel_queued_except_oldest/workflow");
+const workflow_7 = require("./concurrency_multiple_keys/workflow");
+const workflow_8 = require("./concurrency_workflow_level/workflow");
+const workflow_9 = require("./dag/workflow");
+const workflow_10 = require("./durable/workflow");
+const workflow_11 = require("./durable_event/workflow");
+const workflow_12 = require("./durable_eviction/workflow");
+const workflow_13 = require("./durable_callback_ordering/workflow");
+const workflow_14 = require("./durable_sleep/workflow");
+const workflow_15 = require("./logger/workflow");
+const workflow_16 = require("./non_retryable/workflow");
+const workflow_17 = require("./on_failure/workflow");
+const workflow_18 = require("./idempotency/workflow");
+const workflow_19 = require("./on_event/workflow");
+const workflow_20 = require("./return_exceptions/workflow");
+const workflow_21 = require("./run_details/workflow");
 const e2e_workflows_1 = require("./simple/e2e-workflows");
-const workflow_19 = require("./batch_assign/workflow");
-const workflow_20 = require("./streaming/workflow");
-const workflow_21 = require("./subscribe_to_stream/workflow");
-const workflow_22 = require("./timeout/workflow");
-const workflow_23 = require("./webhooks/workflow");
-const workflow_24 = require("./child_index/workflow");
-const workflow_25 = require("./support_agent/workflow");
-const workflow_26 = require("./welcome_email/workflow");
-const workflow_27 = require("./pdf_pipeline/workflow");
+const workflow_22 = require("./batch_assign/workflow");
+const workflow_23 = require("./streaming/workflow");
+const workflow_24 = require("./subscribe_to_stream/workflow");
+const workflow_25 = require("./timeout/workflow");
+const workflow_26 = require("./webhooks/workflow");
+const workflow_27 = require("./child_index/workflow");
+const workflow_28 = require("./support_agent/workflow");
+const workflow_29 = require("./welcome_email/workflow");
+const workflow_30 = require("./pdf_pipeline/workflow");
 const workflows = [
     workflow_1.bulkChild,
     workflow_1.bulkParentWorkflow,
@@ -56,75 +59,81 @@ const workflows = [
     complex_workflow_1.taskConditionWorkflow,
     workflow_3.concurrencyCancelInProgressWorkflow,
     workflow_4.concurrencyCancelNewestWorkflow,
-    workflow_5.concurrencyMultipleKeysWorkflow,
-    workflow_6.concurrencyWorkflowLevelWorkflow,
-    workflow_7.dag,
-    workflow_8.durableWorkflow,
-    workflow_8.waitForSleepTwice,
-    workflow_8.spawnChildTask,
-    workflow_8.durableWithSpawn,
-    workflow_8.durableWithBulkSpawn,
-    workflow_8.durableSleepEventSpawn,
-    workflow_8.durableWithExplicitSpawn,
-    workflow_8.durableNonDeterminism,
-    workflow_8.durableReplayReset,
-    workflow_8.dagChildWorkflow,
-    workflow_8.durableSpawnDag,
-    workflow_8.waitForEventLookback,
-    workflow_8.waitForOrEventLookback,
-    workflow_8.waitForTwoEventsSecondPushedFirst,
-    workflow_8.errorRaisingTask,
-    workflow_8.errorRaisingDurableParent,
-    workflow_9.durableEvent,
-    workflow_9.durableEventWithFilter,
-    workflow_11.durableSleep,
-    workflow_10.evictableSleep,
-    workflow_10.evictableWaitForEvent,
-    workflow_10.evictableChildSpawn,
-    workflow_10.multipleEviction,
-    workflow_10.nonEvictableSleep,
-    workflow_10.childTask,
-    workflow_10.bulkChildTask,
-    workflow_10.evictableChildBulkSpawn,
-    (0, workflow_12.createLoggingWorkflow)(hatchet_client_1.hatchet),
-    workflow_13.nonRetryableWorkflow,
-    workflow_14.failureWorkflow,
-    workflow_15.idempotentTask,
-    workflow_15.idempotentTaskShortWindow,
-    workflow_16.lower,
-    workflow_17.returnExceptionsTask,
-    workflow_18.runDetailTestWorkflow,
+    workflow_5.concurrencyCancelQueuedExceptNewestWorkflow,
+    workflow_6.concurrencyCancelQueuedExceptOldestWorkflow,
+    workflow_7.concurrencyMultipleKeysWorkflow,
+    workflow_8.concurrencyWorkflowLevelWorkflow,
+    workflow_9.dag,
+    workflow_10.durableWorkflow,
+    workflow_10.waitForSleepTwice,
+    workflow_10.spawnChildTask,
+    workflow_10.durableWithSpawn,
+    workflow_10.durableWithBulkSpawn,
+    workflow_10.durableSleepEventSpawn,
+    workflow_10.durableWithExplicitSpawn,
+    workflow_10.durableNonDeterminism,
+    workflow_10.durableReplayReset,
+    workflow_10.dagChildWorkflow,
+    workflow_10.durableSpawnDag,
+    workflow_10.waitForEventLookback,
+    workflow_10.waitForOrEventLookback,
+    workflow_10.waitForTwoEventsSecondPushedFirst,
+    workflow_10.errorRaisingTask,
+    workflow_10.errorRaisingDurableParent,
+    workflow_11.durableEvent,
+    workflow_11.durableEventWithFilter,
+    workflow_13.callbackOrderingLeaf,
+    workflow_13.callbackOrderingMid,
+    workflow_13.callbackOrderingRoot,
+    workflow_14.durableSleep,
+    workflow_12.evictableSleep,
+    workflow_12.evictableWaitForEvent,
+    workflow_12.evictableMemoThenWaitForEvent,
+    workflow_12.evictableChildSpawn,
+    workflow_12.multipleEviction,
+    workflow_12.nonEvictableSleep,
+    workflow_12.childTask,
+    workflow_12.bulkChildTask,
+    workflow_12.evictableChildBulkSpawn,
+    (0, workflow_15.createLoggingWorkflow)(hatchet_client_1.hatchet),
+    workflow_16.nonRetryableWorkflow,
+    workflow_17.failureWorkflow,
+    workflow_18.idempotentTask,
+    workflow_18.idempotentTaskShortWindow,
+    workflow_19.lower,
+    workflow_20.returnExceptionsTask,
+    workflow_21.runDetailTestWorkflow,
     e2e_workflows_1.helloWorld,
     e2e_workflows_1.helloWorldDurable,
-    workflow_20.streamingTask,
-    workflow_21.dagStream,
-    workflow_21.longStream,
-    workflow_22.timeoutTask,
-    workflow_22.refreshTimeoutTask,
-    workflow_23.webhookWorkflow,
-    workflow_24.childIndexChild,
-    workflow_24.childIndexParent,
-    workflow_24.scenarioTask,
-    workflow_24.orchestratorTask,
-    workflow_25.supportAgent,
-    workflow_25.triageTicket,
-    workflow_25.generateReply,
-    workflow_25.escalateTicket,
-    workflow_26.welcomeEmail,
-    workflow_27.pdfPipeline,
-    workflow_19.batchSimple,
-    workflow_19.batchKeyed,
-    workflow_19.batchKeyedFailable,
-    workflow_19.batchKeyedInterval,
-    workflow_19.batchLarge,
-    workflow_19.batchSingle,
-    workflow_19.batchOrdered,
-    workflow_19.batchBroadcast,
-    workflow_19.batchCancel,
-    workflow_19.child,
-    workflow_19.childBatch,
-    workflow_19.batchChildSpawn,
-    workflow_19.batchChildBatchSpawn,
+    workflow_23.streamingTask,
+    workflow_24.dagStream,
+    workflow_24.longStream,
+    workflow_25.timeoutTask,
+    workflow_25.refreshTimeoutTask,
+    workflow_26.webhookWorkflow,
+    workflow_27.childIndexChild,
+    workflow_27.childIndexParent,
+    workflow_27.scenarioTask,
+    workflow_27.orchestratorTask,
+    workflow_28.supportAgent,
+    workflow_28.triageTicket,
+    workflow_28.generateReply,
+    workflow_28.escalateTicket,
+    workflow_29.welcomeEmail,
+    workflow_30.pdfPipeline,
+    workflow_22.batchSimple,
+    workflow_22.batchKeyed,
+    workflow_22.batchKeyedFailable,
+    workflow_22.batchKeyedInterval,
+    workflow_22.batchLarge,
+    workflow_22.batchSingle,
+    workflow_22.batchOrdered,
+    workflow_22.batchBroadcast,
+    workflow_22.batchCancel,
+    workflow_22.child,
+    workflow_22.childBatch,
+    workflow_22.batchChildSpawn,
+    workflow_22.batchChildBatchSpawn,
 ];
 function main() {
     return __awaiter(this, void 0, void 0, function* () {

package/version.d.ts

@@ -1 +1 @@
-export declare const HATCHET_VERSION = "1.29.3";
+export declare const HATCHET_VERSION = "1.30.1";

package/version.js

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