@hatchet-dev/typescript-sdk 1.37.0 → 1.38.0

package/package.json

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

package/protoc/v1/streams.d.ts

@@ -47,6 +47,12 @@ export interface StreamTopicMetadata {
     /** when the newest retained message was stored; unset when none is retained */
     lastPublishedAt: Date | undefined;
 }
+export interface ResetStreamTopicRequest {
+    namespace: string;
+    topic: string;
+}
+export interface ResetStreamTopicResponse {
+}
 export declare const PublishStreamMessageRequest: MessageFns<PublishStreamMessageRequest>;
 export declare const PublishStreamMessageResponse: MessageFns<PublishStreamMessageResponse>;
 export declare const SubscribeStreamRequest: MessageFns<SubscribeStreamRequest>;
@@ -54,6 +60,8 @@ export declare const StreamMessage: MessageFns<StreamMessage>;
 export declare const StreamEntry: MessageFns<StreamEntry>;
 export declare const GetStreamTopicMetadataRequest: MessageFns<GetStreamTopicMetadataRequest>;
 export declare const StreamTopicMetadata: MessageFns<StreamTopicMetadata>;
+export declare const ResetStreamTopicRequest: MessageFns<ResetStreamTopicRequest>;
+export declare const ResetStreamTopicResponse: MessageFns<ResetStreamTopicResponse>;
 export type V1StreamsDefinition = typeof V1StreamsDefinition;
 export declare const V1StreamsDefinition: {
     readonly name: "V1Streams";
@@ -83,17 +91,27 @@ export declare const V1StreamsDefinition: {
             readonly responseStream: false;
             readonly options: {};
         };
+        readonly reset: {
+            readonly name: "Reset";
+            readonly requestType: typeof ResetStreamTopicRequest;
+            readonly requestStream: false;
+            readonly responseType: typeof ResetStreamTopicResponse;
+            readonly responseStream: false;
+            readonly options: {};
+        };
     };
 };
 export interface V1StreamsServiceImplementation<CallContextExt = {}> {
     publish(request: PublishStreamMessageRequest, context: CallContext & CallContextExt): Promise<DeepPartial<PublishStreamMessageResponse>>;
     subscribe(request: SubscribeStreamRequest, context: CallContext & CallContextExt): ServerStreamingMethodResult<DeepPartial<StreamMessage>>;
     getTopicMetadata(request: GetStreamTopicMetadataRequest, context: CallContext & CallContextExt): Promise<DeepPartial<StreamTopicMetadata>>;
+    reset(request: ResetStreamTopicRequest, context: CallContext & CallContextExt): Promise<DeepPartial<ResetStreamTopicResponse>>;
 }
 export interface V1StreamsClient<CallOptionsExt = {}> {
     publish(request: DeepPartial<PublishStreamMessageRequest>, options?: CallOptions & CallOptionsExt): Promise<PublishStreamMessageResponse>;
     subscribe(request: DeepPartial<SubscribeStreamRequest>, options?: CallOptions & CallOptionsExt): AsyncIterable<StreamMessage>;
     getTopicMetadata(request: DeepPartial<GetStreamTopicMetadataRequest>, options?: CallOptions & CallOptionsExt): Promise<StreamTopicMetadata>;
+    reset(request: DeepPartial<ResetStreamTopicRequest>, options?: CallOptions & CallOptionsExt): Promise<ResetStreamTopicResponse>;
 }
 type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
 export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {

package/protoc/v1/streams.js

@@ -5,7 +5,7 @@
 //   protoc               v3.19.1
 // source: v1/streams.proto
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.V1StreamsDefinition = exports.StreamTopicMetadata = exports.GetStreamTopicMetadataRequest = exports.StreamEntry = exports.StreamMessage = exports.SubscribeStreamRequest = exports.PublishStreamMessageResponse = exports.PublishStreamMessageRequest = exports.protobufPackage = void 0;
+exports.V1StreamsDefinition = exports.ResetStreamTopicResponse = exports.ResetStreamTopicRequest = exports.StreamTopicMetadata = exports.GetStreamTopicMetadataRequest = exports.StreamEntry = exports.StreamMessage = exports.SubscribeStreamRequest = exports.PublishStreamMessageResponse = exports.PublishStreamMessageRequest = exports.protobufPackage = void 0;
 /* eslint-disable */
 const wire_1 = require("@bufbuild/protobuf/wire");
 const timestamp_1 = require("../google/protobuf/timestamp");
@@ -694,6 +694,112 @@ exports.StreamTopicMetadata = {
         return message;
     },
 };
+function createBaseResetStreamTopicRequest() {
+    return { namespace: '', topic: '' };
+}
+exports.ResetStreamTopicRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.namespace !== '') {
+            writer.uint32(10).string(message.namespace);
+        }
+        if (message.topic !== '') {
+            writer.uint32(18).string(message.topic);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseResetStreamTopicRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.namespace = reader.string();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.topic = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return {
+            namespace: isSet(object.namespace) ? globalThis.String(object.namespace) : '',
+            topic: isSet(object.topic) ? globalThis.String(object.topic) : '',
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.namespace !== '') {
+            obj.namespace = message.namespace;
+        }
+        if (message.topic !== '') {
+            obj.topic = message.topic;
+        }
+        return obj;
+    },
+    create(base) {
+        return exports.ResetStreamTopicRequest.fromPartial(base !== null && base !== void 0 ? base : {});
+    },
+    fromPartial(object) {
+        var _a, _b;
+        const message = createBaseResetStreamTopicRequest();
+        message.namespace = (_a = object.namespace) !== null && _a !== void 0 ? _a : '';
+        message.topic = (_b = object.topic) !== null && _b !== void 0 ? _b : '';
+        return message;
+    },
+};
+function createBaseResetStreamTopicResponse() {
+    return {};
+}
+exports.ResetStreamTopicResponse = {
+    encode(_, writer = new wire_1.BinaryWriter()) {
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseResetStreamTopicResponse();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(_) {
+        return {};
+    },
+    toJSON(_) {
+        const obj = {};
+        return obj;
+    },
+    create(base) {
+        return exports.ResetStreamTopicResponse.fromPartial(base !== null && base !== void 0 ? base : {});
+    },
+    fromPartial(_) {
+        const message = createBaseResetStreamTopicResponse();
+        return message;
+    },
+};
 exports.V1StreamsDefinition = {
     name: 'V1Streams',
     fullName: 'v1.V1Streams',
@@ -722,6 +828,14 @@ exports.V1StreamsDefinition = {
             responseStream: false,
             options: {},
         },
+        reset: {
+            name: 'Reset',
+            requestType: exports.ResetStreamTopicRequest,
+            requestStream: false,
+            responseType: exports.ResetStreamTopicResponse,
+            responseStream: false,
+            options: {},
+        },
     },
 };
 function bytesFromBase64(b64) {

package/protoc-es/v1/streams_pb.d.ts

@@ -181,6 +181,33 @@ export type StreamTopicMetadata = Message<"v1.StreamTopicMetadata"> & {
  * Use `create(StreamTopicMetadataSchema)` to create a new message.
  */
 export declare const StreamTopicMetadataSchema: GenMessage<StreamTopicMetadata>;
+/**
+ * @generated from message v1.ResetStreamTopicRequest
+ */
+export type ResetStreamTopicRequest = Message<"v1.ResetStreamTopicRequest"> & {
+    /**
+     * @generated from field: string namespace = 1;
+     */
+    namespace: string;
+    /**
+     * @generated from field: string topic = 2;
+     */
+    topic: string;
+};
+/**
+ * Describes the message v1.ResetStreamTopicRequest.
+ * Use `create(ResetStreamTopicRequestSchema)` to create a new message.
+ */
+export declare const ResetStreamTopicRequestSchema: GenMessage<ResetStreamTopicRequest>;
+/**
+ * @generated from message v1.ResetStreamTopicResponse
+ */
+export type ResetStreamTopicResponse = Message<"v1.ResetStreamTopicResponse"> & {};
+/**
+ * Describes the message v1.ResetStreamTopicResponse.
+ * Use `create(ResetStreamTopicResponseSchema)` to create a new message.
+ */
+export declare const ResetStreamTopicResponseSchema: GenMessage<ResetStreamTopicResponse>;
 /**
  * @generated from service v1.V1Streams
  */
@@ -209,4 +236,12 @@ export declare const V1Streams: GenService<{
         input: typeof GetStreamTopicMetadataRequestSchema;
         output: typeof StreamTopicMetadataSchema;
     };
+    /**
+     * @generated from rpc v1.V1Streams.Reset
+     */
+    reset: {
+        methodKind: "unary";
+        input: typeof ResetStreamTopicRequestSchema;
+        output: typeof ResetStreamTopicResponseSchema;
+    };
 }>;

package/protoc-es/v1/streams_pb.js

@@ -3,13 +3,13 @@
 // @generated from file v1/streams.proto (package v1, syntax proto3)
 /* eslint-disable */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.V1Streams = exports.StreamTopicMetadataSchema = exports.GetStreamTopicMetadataRequestSchema = exports.StreamEntrySchema = exports.StreamMessageSchema = exports.SubscribeStreamRequestSchema = exports.PublishStreamMessageResponseSchema = exports.PublishStreamMessageRequestSchema = exports.file_v1_streams = void 0;
+exports.V1Streams = exports.ResetStreamTopicResponseSchema = exports.ResetStreamTopicRequestSchema = exports.StreamTopicMetadataSchema = exports.GetStreamTopicMetadataRequestSchema = exports.StreamEntrySchema = exports.StreamMessageSchema = exports.SubscribeStreamRequestSchema = exports.PublishStreamMessageResponseSchema = exports.PublishStreamMessageRequestSchema = exports.file_v1_streams = void 0;
 const codegenv2_1 = require("@bufbuild/protobuf/codegenv2");
 const wkt_1 = require("@bufbuild/protobuf/wkt");
 /**
  * Describes the file v1/streams.proto.
  */
-exports.file_v1_streams = (0, codegenv2_1.fileDesc)("ChB2MS9zdHJlYW1zLnByb3RvEgJ2MSKQAQobUHVibGlzaFN0cmVhbU1lc3NhZ2VSZXF1ZXN0EhEKCW5hbWVzcGFjZRgBIAEoCRINCgV0b3BpYxgCIAEoCRIPCgdwYXlsb2FkGAMgASgMEhMKC3Byb2R1Y2VyX2lkGAQgASgJEhQKDHByb2R1Y2VyX3NlcRgFIAEoAxITCgtwYXlsb2FkX3JlZhgGIAEoCSIeChxQdWJsaXNoU3RyZWFtTWVzc2FnZVJlc3BvbnNlIloKFlN1YnNjcmliZVN0cmVhbVJlcXVlc3QSEQoJbmFtZXNwYWNlGAEgASgJEg0KBXRvcGljGAIgASgJEhMKBmN1cnNvchgDIAEoCUgAiAEBQgkKB19jdXJzb3IiUQoNU3RyZWFtTWVzc2FnZRIgCgdlbnRyaWVzGAEgAygLMg8udjEuU3RyZWFtRW50cnkSDgoGaGFuZ3VwGAIgASgIEg4KBmN1cnNvchgDIAEoCSJzCgtTdHJlYW1FbnRyeRIPCgdwYXlsb2FkGAEgASgMEg4KBmN1cnNvchgCIAEoCRIuCgpjcmVhdGVkX2F0GAMgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBITCgtwYXlsb2FkX3JlZhgEIAEoCSJBCh1HZXRTdHJlYW1Ub3BpY01ldGFkYXRhUmVxdWVzdBIRCgluYW1lc3BhY2UYASABKAkSDQoFdG9waWMYAiABKAkixgEKE1N0cmVhbVRvcGljTWV0YWRhdGESEQoJbmFtZXNwYWNlGAEgASgJEg0KBXRvcGljGAIgASgJEhEKCXRlbmFudF9pZBgDIAEoCRIaCg1sYXRlc3RfY3Vyc29yGAQgASgJSACIAQESFQoNbWVzc2FnZV9jb3VudBgFIAEoAxI1ChFsYXN0X3B1Ymxpc2hlZF9hdBgGIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXBCEAoOX2xhdGVzdF9jdXJzb3Iy7QEKCVYxU3RyZWFtcxJOCgdQdWJsaXNoEh8udjEuUHVibGlzaFN0cmVhbU1lc3NhZ2VSZXF1ZXN0GiAudjEuUHVibGlzaFN0cmVhbU1lc3NhZ2VSZXNwb25zZSIAEj4KCVN1YnNjcmliZRIaLnYxLlN1YnNjcmliZVN0cmVhbVJlcXVlc3QaES52MS5TdHJlYW1NZXNzYWdlIgAwARJQChBHZXRUb3BpY01ldGFkYXRhEiEudjEuR2V0U3RyZWFtVG9waWNNZXRhZGF0YVJlcXVlc3QaFy52MS5TdHJlYW1Ub3BpY01ldGFkYXRhIgBCQlpAZ2l0aHViLmNvbS9oYXRjaGV0LWRldi9oYXRjaGV0L2ludGVybmFsL3NlcnZpY2VzL3NoYXJlZC9wcm90by92MWIGcHJvdG8z", [wkt_1.file_google_protobuf_timestamp]);
+exports.file_v1_streams = (0, codegenv2_1.fileDesc)("ChB2MS9zdHJlYW1zLnByb3RvEgJ2MSKQAQobUHVibGlzaFN0cmVhbU1lc3NhZ2VSZXF1ZXN0EhEKCW5hbWVzcGFjZRgBIAEoCRINCgV0b3BpYxgCIAEoCRIPCgdwYXlsb2FkGAMgASgMEhMKC3Byb2R1Y2VyX2lkGAQgASgJEhQKDHByb2R1Y2VyX3NlcRgFIAEoAxITCgtwYXlsb2FkX3JlZhgGIAEoCSIeChxQdWJsaXNoU3RyZWFtTWVzc2FnZVJlc3BvbnNlIloKFlN1YnNjcmliZVN0cmVhbVJlcXVlc3QSEQoJbmFtZXNwYWNlGAEgASgJEg0KBXRvcGljGAIgASgJEhMKBmN1cnNvchgDIAEoCUgAiAEBQgkKB19jdXJzb3IiUQoNU3RyZWFtTWVzc2FnZRIgCgdlbnRyaWVzGAEgAygLMg8udjEuU3RyZWFtRW50cnkSDgoGaGFuZ3VwGAIgASgIEg4KBmN1cnNvchgDIAEoCSJzCgtTdHJlYW1FbnRyeRIPCgdwYXlsb2FkGAEgASgMEg4KBmN1cnNvchgCIAEoCRIuCgpjcmVhdGVkX2F0GAMgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBITCgtwYXlsb2FkX3JlZhgEIAEoCSJBCh1HZXRTdHJlYW1Ub3BpY01ldGFkYXRhUmVxdWVzdBIRCgluYW1lc3BhY2UYASABKAkSDQoFdG9waWMYAiABKAkixgEKE1N0cmVhbVRvcGljTWV0YWRhdGESEQoJbmFtZXNwYWNlGAEgASgJEg0KBXRvcGljGAIgASgJEhEKCXRlbmFudF9pZBgDIAEoCRIaCg1sYXRlc3RfY3Vyc29yGAQgASgJSACIAQESFQoNbWVzc2FnZV9jb3VudBgFIAEoAxI1ChFsYXN0X3B1Ymxpc2hlZF9hdBgGIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXBCEAoOX2xhdGVzdF9jdXJzb3IiOwoXUmVzZXRTdHJlYW1Ub3BpY1JlcXVlc3QSEQoJbmFtZXNwYWNlGAEgASgJEg0KBXRvcGljGAIgASgJIhoKGFJlc2V0U3RyZWFtVG9waWNSZXNwb25zZTKzAgoJVjFTdHJlYW1zEk4KB1B1Ymxpc2gSHy52MS5QdWJsaXNoU3RyZWFtTWVzc2FnZVJlcXVlc3QaIC52MS5QdWJsaXNoU3RyZWFtTWVzc2FnZVJlc3BvbnNlIgASPgoJU3Vic2NyaWJlEhoudjEuU3Vic2NyaWJlU3RyZWFtUmVxdWVzdBoRLnYxLlN0cmVhbU1lc3NhZ2UiADABElAKEEdldFRvcGljTWV0YWRhdGESIS52MS5HZXRTdHJlYW1Ub3BpY01ldGFkYXRhUmVxdWVzdBoXLnYxLlN0cmVhbVRvcGljTWV0YWRhdGEiABJECgVSZXNldBIbLnYxLlJlc2V0U3RyZWFtVG9waWNSZXF1ZXN0GhwudjEuUmVzZXRTdHJlYW1Ub3BpY1Jlc3BvbnNlIgBCQlpAZ2l0aHViLmNvbS9oYXRjaGV0LWRldi9oYXRjaGV0L2ludGVybmFsL3NlcnZpY2VzL3NoYXJlZC9wcm90by92MWIGcHJvdG8z", [wkt_1.file_google_protobuf_timestamp]);
 /**
  * Describes the message v1.PublishStreamMessageRequest.
  * Use `create(PublishStreamMessageRequestSchema)` to create a new message.
@@ -45,6 +45,16 @@ exports.GetStreamTopicMetadataRequestSchema = (0, codegenv2_1.messageDesc)(expor
  * Use `create(StreamTopicMetadataSchema)` to create a new message.
  */
 exports.StreamTopicMetadataSchema = (0, codegenv2_1.messageDesc)(exports.file_v1_streams, 6);
+/**
+ * Describes the message v1.ResetStreamTopicRequest.
+ * Use `create(ResetStreamTopicRequestSchema)` to create a new message.
+ */
+exports.ResetStreamTopicRequestSchema = (0, codegenv2_1.messageDesc)(exports.file_v1_streams, 7);
+/**
+ * Describes the message v1.ResetStreamTopicResponse.
+ * Use `create(ResetStreamTopicResponseSchema)` to create a new message.
+ */
+exports.ResetStreamTopicResponseSchema = (0, codegenv2_1.messageDesc)(exports.file_v1_streams, 8);
 /**
  * @generated from service v1.V1Streams
  */

package/v1/client/features/streams.d.ts

@@ -57,7 +57,16 @@ export declare class StreamsClient {
      */
     topicMetadata(topic: string, options?: Pick<StreamCallOptions, 'namespace'>): Promise<StreamTopicMetadata>;
     /**
-     * Yields topic's messages after options.cursor, or from the oldest retained.
+     * Makes events() calls without a cursor start after the topic's latest
+     * message. Readers already iterating, and any call with a cursor, are
+     * unaffected.
+     * @param topic - the topic to reset
+     * @param options - optional namespace override
+     */
+    reset(topic: string, options?: Pick<StreamCallOptions, 'namespace'>): Promise<void>;
+    /**
+     * Yields topic's messages after options.cursor, or from the oldest retained
+     * (or, once the topic is reset, after the reset).
      * If the connection drops, it resubscribes from the last message yielded, so
      * nothing is skipped or repeated. Ends when the server hangs up an idle
      * subscription, options.signal aborts, or the caller stops iterating; throws

package/v1/client/features/streams.js

@@ -216,7 +216,21 @@ class StreamsClient {
         });
     }
     /**
-     * Yields topic's messages after options.cursor, or from the oldest retained.
+     * Makes events() calls without a cursor start after the topic's latest
+     * message. Readers already iterating, and any call with a cursor, are
+     * unaffected.
+     * @param topic - the topic to reset
+     * @param options - optional namespace override
+     */
+    reset(topic, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            yield this.grpc.reset({ namespace: (_a = options === null || options === void 0 ? void 0 : options.namespace) !== null && _a !== void 0 ? _a : '', topic });
+        });
+    }
+    /**
+     * Yields topic's messages after options.cursor, or from the oldest retained
+     * (or, once the topic is reset, after the reset).
      * If the connection drops, it resubscribes from the last message yielded, so
      * nothing is skipped or repeated. Ends when the server hangs up an idle
      * subscription, options.signal aborts, or the caller stops iterating; throws

package/v1/examples/durable-streams/run.d.ts

@@ -0,0 +1,6 @@
+export declare function consume(): Promise<void>;
+export declare function publishFromAnywhere(): Promise<void>;
+export declare function resumeFromCursor(topic: string): Promise<void>;
+export declare function stopWithSignal(topic: string): Promise<void>;
+export declare function namespaces(): Promise<void>;
+export declare function resetTopic(): Promise<void>;

package/v1/examples/durable-streams/run.js

@@ -0,0 +1,192 @@
+"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 __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.consume = consume;
+exports.publishFromAnywhere = publishFromAnywhere;
+exports.resumeFromCursor = resumeFromCursor;
+exports.stopWithSignal = stopWithSignal;
+exports.namespaces = namespaces;
+exports.resetTopic = resetTopic;
+const crypto_1 = require("crypto");
+const hatchet_client_1 = require("../hatchet-client");
+const workflow_1 = require("./workflow");
+const decode = (payload) => new TextDecoder().decode(payload);
+function consume() {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, e_1, _b, _c;
+        // > Consume
+        const topic = `progress-${(0, crypto_1.randomUUID)()}`;
+        yield workflow_1.progressTask.runNoWait({ topic });
+        try {
+            for (var _d = true, _e = __asyncValues(hatchet_client_1.hatchet.streams.events(topic)), _f; _f = yield _e.next(), _a = _f.done, !_a; _d = true) {
+                _c = _f.value;
+                _d = false;
+                const event = _c;
+                const { step, total } = JSON.parse(decode(event.payload));
+                console.log(`step ${step} of ${total}`);
+                // the stream outlives the run, so the reader decides when it's done
+                if (step === total) {
+                    break;
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (!_d && !_a && (_b = _e.return)) yield _b.call(_e);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        // !!
+    });
+}
+function publishFromAnywhere() {
+    return __awaiter(this, void 0, void 0, function* () {
+        // > Publish from anywhere
+        yield hatchet_client_1.hatchet.streams.publish('orders', JSON.stringify({ orderId: 'ord_123', status: 'shipped' }));
+        // !!
+    });
+}
+function resumeFromCursor(topic) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, e_2, _b, _c, _d, e_3, _e, _f;
+        // > Resume from a cursor
+        let cursor;
+        try {
+            for (var _g = true, _h = __asyncValues(hatchet_client_1.hatchet.streams.events(topic)), _j; _j = yield _h.next(), _a = _j.done, !_a; _g = true) {
+                _c = _j.value;
+                _g = false;
+                const event = _c;
+                console.log(decode(event.payload));
+                ({ cursor } = event);
+                break;
+            }
+        }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        finally {
+            try {
+                if (!_g && !_a && (_b = _h.return)) yield _b.call(_h);
+            }
+            finally { if (e_2) throw e_2.error; }
+        }
+        try {
+            // picks up right after the last event read, even from another process
+            for (var _k = true, _l = __asyncValues(hatchet_client_1.hatchet.streams.events(topic, { cursor })), _m; _m = yield _l.next(), _d = _m.done, !_d; _k = true) {
+                _f = _m.value;
+                _k = false;
+                const event = _f;
+                console.log(decode(event.payload));
+            }
+        }
+        catch (e_3_1) { e_3 = { error: e_3_1 }; }
+        finally {
+            try {
+                if (!_k && !_d && (_e = _l.return)) yield _e.call(_l);
+            }
+            finally { if (e_3) throw e_3.error; }
+        }
+        // !!
+    });
+}
+function stopWithSignal(topic) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, e_4, _b, _c;
+        // > Stop reading
+        const controller = new AbortController();
+        setTimeout(() => controller.abort(), 10000);
+        try {
+            for (var _d = true, _e = __asyncValues(hatchet_client_1.hatchet.streams.events(topic, { signal: controller.signal })), _f; _f = yield _e.next(), _a = _f.done, !_a; _d = true) {
+                _c = _f.value;
+                _d = false;
+                const event = _c;
+                console.log(decode(event.payload));
+            }
+        }
+        catch (e_4_1) { e_4 = { error: e_4_1 }; }
+        finally {
+            try {
+                if (!_d && !_a && (_b = _e.return)) yield _b.call(_e);
+            }
+            finally { if (e_4) throw e_4.error; }
+        }
+        // !!
+    });
+}
+function namespaces() {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, e_5, _b, _c;
+        // > Namespaces
+        yield hatchet_client_1.hatchet.streams.publish('updates', 'hello', { namespace: 'customer-a' });
+        try {
+            for (var _d = true, _e = __asyncValues(hatchet_client_1.hatchet.streams.events('updates', { namespace: 'customer-a' })), _f; _f = yield _e.next(), _a = _f.done, !_a; _d = true) {
+                _c = _f.value;
+                _d = false;
+                const event = _c;
+                console.log(decode(event.payload));
+                break;
+            }
+        }
+        catch (e_5_1) { e_5 = { error: e_5_1 }; }
+        finally {
+            try {
+                if (!_d && !_a && (_b = _e.return)) yield _b.call(_e);
+            }
+            finally { if (e_5) throw e_5.error; }
+        }
+        // !!
+    });
+}
+function resetTopic() {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, e_6, _b, _c;
+        // > Reset a topic
+        yield hatchet_client_1.hatchet.streams.reset('orders');
+        try {
+            // starts after the reset; readers that were already iterating aren't affected
+            for (var _d = true, _e = __asyncValues(hatchet_client_1.hatchet.streams.events('orders')), _f; _f = yield _e.next(), _a = _f.done, !_a; _d = true) {
+                _c = _f.value;
+                _d = false;
+                const event = _c;
+                console.log(decode(event.payload));
+            }
+        }
+        catch (e_6_1) { e_6 = { error: e_6_1 }; }
+        finally {
+            try {
+                if (!_d && !_a && (_b = _e.return)) yield _b.call(_e);
+            }
+            finally { if (e_6) throw e_6.error; }
+        }
+        // !!
+    });
+}
+function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield consume();
+        yield publishFromAnywhere();
+        yield stopWithSignal('orders');
+        yield namespaces();
+    });
+}
+if (require.main === module) {
+    main()
+        .catch(console.error)
+        .finally(() => {
+        process.exit(0);
+    });
+}

package/v1/examples/durable-streams/worker.d.ts

@@ -0,0 +1 @@
+export {};

package/v1/examples/durable-streams/worker.js

@@ -0,0 +1,24 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const hatchet_client_1 = require("../hatchet-client");
+const workflow_1 = require("./workflow");
+function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const worker = yield hatchet_client_1.hatchet.worker('durable-streams-worker', {
+            workflows: [workflow_1.progressTask, workflow_1.retryingProgressTask],
+        });
+        yield worker.start();
+    });
+}
+if (require.main === module) {
+    main();
+}

package/v1/examples/durable-streams/workflow.d.ts

@@ -0,0 +1,9 @@
+export type ProgressInput = {
+    topic: string;
+};
+export declare const progressTask: import("../..").TaskWorkflowDeclaration<ProgressInput, {
+    steps: number;
+}, {}, {}, {}, {}>;
+export declare const retryingProgressTask: import("../..").TaskWorkflowDeclaration<ProgressInput, {
+    chunks: number;
+}, {}, {}, {}, {}>;

package/v1/examples/durable-streams/workflow.js

@@ -0,0 +1,47 @@
+"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.retryingProgressTask = exports.progressTask = void 0;
+const sleep_1 = __importDefault(require("../../../util/sleep"));
+const hatchet_client_1 = require("../hatchet-client");
+exports.progressTask = hatchet_client_1.hatchet.task({
+    name: 'durable-streams-progress',
+    fn: (input) => __awaiter(void 0, void 0, void 0, function* () {
+        const total = 5;
+        for (let step = 1; step <= total; step += 1) {
+            yield (0, sleep_1.default)(500);
+            yield hatchet_client_1.hatchet.streams.publish(input.topic, JSON.stringify({ step, total }));
+        }
+        return { steps: total };
+    }),
+});
+// !!
+// > Reset on retry
+exports.retryingProgressTask = hatchet_client_1.hatchet.task({
+    name: 'durable-streams-retrying-progress',
+    retries: 1,
+    fn: (input, ctx) => __awaiter(void 0, void 0, void 0, function* () {
+        // readers that subscribe from here on skip a failed attempt's messages
+        yield hatchet_client_1.hatchet.streams.reset(input.topic);
+        for (let chunk = 0; chunk < 3; chunk += 1) {
+            yield hatchet_client_1.hatchet.streams.publish(input.topic, JSON.stringify({ attempt: ctx.retryCount(), chunk }));
+        }
+        if (ctx.retryCount() === 0) {
+            throw new Error('intentional failure before the final message');
+        }
+        yield hatchet_client_1.hatchet.streams.publish(input.topic, JSON.stringify({ done: true }));
+        return { chunks: 3 };
+    }),
+});
+// !!

package/v1/examples/e2e-worker.js

@@ -33,24 +33,25 @@ const workflow_12 = require("./durable_event/workflow");
 const workflow_13 = require("./durable_eviction/workflow");
 const workflow_14 = require("./durable_callback_ordering/workflow");
 const workflow_15 = require("./durable_sleep/workflow");
-const workflow_16 = require("./logger/workflow");
-const workflow_17 = require("./non_retryable/workflow");
-const workflow_18 = require("./retry_after/workflow");
-const workflow_19 = require("./on_failure/workflow");
-const workflow_20 = require("./idempotency/workflow");
-const workflow_21 = require("./on_event/workflow");
-const workflow_22 = require("./return_exceptions/workflow");
-const workflow_23 = require("./run_details/workflow");
+const workflow_16 = require("./durable-streams/workflow");
+const workflow_17 = require("./logger/workflow");
+const workflow_18 = require("./non_retryable/workflow");
+const workflow_19 = require("./retry_after/workflow");
+const workflow_20 = require("./on_failure/workflow");
+const workflow_21 = require("./idempotency/workflow");
+const workflow_22 = require("./on_event/workflow");
+const workflow_23 = require("./return_exceptions/workflow");
+const workflow_24 = require("./run_details/workflow");
 const e2e_workflows_1 = require("./simple/e2e-workflows");
-const workflow_24 = require("./batch_assign/workflow");
-const workflow_25 = require("./streaming/workflow");
-const workflow_26 = require("./subscribe_to_stream/workflow");
-const workflow_27 = require("./timeout/workflow");
-const workflow_28 = require("./webhooks/workflow");
-const workflow_29 = require("./child_index/workflow");
-const workflow_30 = require("./support_agent/workflow");
-const workflow_31 = require("./welcome_email/workflow");
-const workflow_32 = require("./pdf_pipeline/workflow");
+const workflow_25 = require("./batch_assign/workflow");
+const workflow_26 = require("./streaming/workflow");
+const workflow_27 = require("./subscribe_to_stream/workflow");
+const workflow_28 = require("./timeout/workflow");
+const workflow_29 = require("./webhooks/workflow");
+const workflow_30 = require("./child_index/workflow");
+const workflow_31 = require("./support_agent/workflow");
+const workflow_32 = require("./welcome_email/workflow");
+const workflow_33 = require("./pdf_pipeline/workflow");
 const workflows = [
     workflow_1.bulkChild,
     workflow_1.bulkParentWorkflow,
@@ -91,6 +92,8 @@ const workflows = [
     workflow_14.callbackOrderingMid,
     workflow_14.callbackOrderingRoot,
     workflow_15.durableSleep,
+    workflow_16.progressTask,
+    workflow_16.retryingProgressTask,
     workflow_13.evictableSleep,
     workflow_13.evictableWaitForEvent,
     workflow_13.evictableMemoThenWaitForEvent,
@@ -100,47 +103,47 @@ const workflows = [
     workflow_13.childTask,
     workflow_13.bulkChildTask,
     workflow_13.evictableChildBulkSpawn,
-    (0, workflow_16.createLoggingWorkflow)(hatchet_client_1.hatchet),
-    workflow_17.nonRetryableWorkflow,
-    workflow_18.retryAfterUpstreamDelay,
-    workflow_18.retryAfterExponentialBackoff,
-    workflow_19.failureWorkflow,
-    workflow_20.idempotentTask,
-    workflow_20.idempotentTaskShortWindow,
-    workflow_21.lower,
-    workflow_22.returnExceptionsTask,
-    workflow_23.runDetailTestWorkflow,
+    (0, workflow_17.createLoggingWorkflow)(hatchet_client_1.hatchet),
+    workflow_18.nonRetryableWorkflow,
+    workflow_19.retryAfterUpstreamDelay,
+    workflow_19.retryAfterExponentialBackoff,
+    workflow_20.failureWorkflow,
+    workflow_21.idempotentTask,
+    workflow_21.idempotentTaskShortWindow,
+    workflow_22.lower,
+    workflow_23.returnExceptionsTask,
+    workflow_24.runDetailTestWorkflow,
     e2e_workflows_1.helloWorld,
     e2e_workflows_1.helloWorldDurable,
-    workflow_25.streamingTask,
-    workflow_26.dagStream,
-    workflow_26.longStream,
-    workflow_27.timeoutTask,
-    workflow_27.refreshTimeoutTask,
-    workflow_28.webhookWorkflow,
-    workflow_29.childIndexChild,
-    workflow_29.childIndexParent,
-    workflow_29.scenarioTask,
-    workflow_29.orchestratorTask,
-    workflow_30.supportAgent,
-    workflow_30.triageTicket,
-    workflow_30.generateReply,
-    workflow_30.escalateTicket,
-    workflow_31.welcomeEmail,
-    workflow_32.pdfPipeline,
-    workflow_24.batchSimple,
-    workflow_24.batchKeyed,
-    workflow_24.batchKeyedFailable,
-    workflow_24.batchKeyedInterval,
-    workflow_24.batchLarge,
-    workflow_24.batchSingle,
-    workflow_24.batchOrdered,
-    workflow_24.batchBroadcast,
-    workflow_24.batchCancel,
-    workflow_24.child,
-    workflow_24.childBatch,
-    workflow_24.batchChildSpawn,
-    workflow_24.batchChildBatchSpawn,
+    workflow_26.streamingTask,
+    workflow_27.dagStream,
+    workflow_27.longStream,
+    workflow_28.timeoutTask,
+    workflow_28.refreshTimeoutTask,
+    workflow_29.webhookWorkflow,
+    workflow_30.childIndexChild,
+    workflow_30.childIndexParent,
+    workflow_30.scenarioTask,
+    workflow_30.orchestratorTask,
+    workflow_31.supportAgent,
+    workflow_31.triageTicket,
+    workflow_31.generateReply,
+    workflow_31.escalateTicket,
+    workflow_32.welcomeEmail,
+    workflow_33.pdfPipeline,
+    workflow_25.batchSimple,
+    workflow_25.batchKeyed,
+    workflow_25.batchKeyedFailable,
+    workflow_25.batchKeyedInterval,
+    workflow_25.batchLarge,
+    workflow_25.batchSingle,
+    workflow_25.batchOrdered,
+    workflow_25.batchBroadcast,
+    workflow_25.batchCancel,
+    workflow_25.child,
+    workflow_25.childBatch,
+    workflow_25.batchChildSpawn,
+    workflow_25.batchChildBatchSpawn,
 ];
 function main() {
     return __awaiter(this, void 0, void 0, function* () {

package/version.d.ts

@@ -1 +1 @@
-export declare const HATCHET_VERSION = "1.37.0";
+export declare const HATCHET_VERSION = "1.38.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.37.0';
+exports.HATCHET_VERSION = '1.38.0';