@hatchet-dev/typescript-sdk 0.13.1 → 0.15.0

package/clients/admin/admin-client.d.ts

@@ -12,6 +12,17 @@ type WorkflowMetricsQuery = {
     status?: WorkflowRunStatus;
     groupKey?: string;
 };
+export type WorkflowRun<T = object> = {
+    workflowName: string;
+    input: T;
+    options?: {
+        parentId?: string | undefined;
+        parentStepRunId?: string | undefined;
+        childIndex?: number | undefined;
+        childKey?: string | undefined;
+        additionalMetadata?: Record<string, string> | undefined;
+    };
+};
 /**
  * AdminClient is a client for interacting with the Hatchet Admin API. This allows you to configure, trigger,
  * and monitor workflows.
@@ -78,6 +89,24 @@ export declare class AdminClient {
         additionalMetadata?: Record<string, string> | undefined;
         desiredWorkerId?: string | undefined;
     }): WorkflowRunRef<P>;
+    /**
+     * Run multiple workflows runs with the given input and options. This will create new workflow runs and return their IDs.
+     * Order is preserved in the response.
+     * @param workflowRuns an array of objects containing the workflow name, input, and options for each workflow run
+     * @returns an array of workflow run references
+     */
+    runWorkflows<Q = object, P = object>(workflowRuns: Array<{
+        workflowName: string;
+        input: Q;
+        options?: {
+            parentId?: string | undefined;
+            parentStepRunId?: string | undefined;
+            childIndex?: number | undefined;
+            childKey?: string | undefined;
+            additionalMetadata?: Record<string, string> | undefined;
+            desiredWorkerId?: string | undefined;
+        };
+    }>): Promise<WorkflowRunRef<P>[]>;
     /**
      * @deprecated use listWorkflows instead
      */

package/clients/admin/admin-client.js

@@ -127,6 +127,40 @@ class AdminClient {
             throw new hatchet_error_1.default(e.message);
         }
     }
+    /**
+     * Run multiple workflows runs with the given input and options. This will create new workflow runs and return their IDs.
+     * Order is preserved in the response.
+     * @param workflowRuns an array of objects containing the workflow name, input, and options for each workflow run
+     * @returns an array of workflow run references
+     */
+    runWorkflows(workflowRuns) {
+        // Prepare workflows to be triggered in bulk
+        const workflowRequests = workflowRuns.map(({ workflowName, input, options }) => {
+            let computedName = workflowName;
+            if (this.config.namespace && !workflowName.startsWith(this.config.namespace)) {
+                computedName = this.config.namespace + workflowName;
+            }
+            const inputStr = JSON.stringify(input);
+            return Object.assign(Object.assign({ name: computedName, input: inputStr }, options), { additionalMetadata: (options === null || options === void 0 ? void 0 : options.additionalMetadata)
+                    ? JSON.stringify(options.additionalMetadata)
+                    : undefined });
+        });
+        try {
+            // Call the bulk trigger workflow method
+            const bulkTriggerWorkflowResponse = this.client.bulkTriggerWorkflow(workflows_1.BulkTriggerWorkflowRequest.create({
+                workflows: workflowRequests,
+            }));
+            return bulkTriggerWorkflowResponse.then((res) => {
+                return res.workflowRunIds.map((resp, index) => {
+                    const { options } = workflowRuns[index];
+                    return new workflow_run_ref_1.default(resp, this.listenerClient, options === null || options === void 0 ? void 0 : options.parentId);
+                });
+            });
+        }
+        catch (e) {
+            throw new hatchet_error_1.default(e.message);
+        }
+    }
     /**
      * @deprecated use listWorkflows instead
      */

package/clients/rest/generated/Api.d.ts

@@ -1,4 +1,4 @@
-import { AcceptInviteRequest, APIErrors, APIMeta, BulkCreateEventRequest, BulkCreateEventResponse, CancelEventRequest, CreateAPITokenRequest, CreateAPITokenResponse, CreateEventRequest, CreateSNSIntegrationRequest, CreateTenantAlertEmailGroupRequest, CreateTenantInviteRequest, CreateTenantRequest, Event, EventData, EventKey, EventKeyList, EventList, EventOrderByDirection, EventOrderByField, EventSearch, ListAPIMetaIntegration, ListAPITokensResponse, ListSlackWebhooks, ListSNSIntegrations, LogLineLevelField, LogLineList, LogLineOrderByDirection, LogLineOrderByField, LogLineSearch, RejectInviteRequest, ReplayEventRequest, ReplayWorkflowRunsRequest, ReplayWorkflowRunsResponse, RerunStepRunRequest, SNSIntegration, StepRun, StepRunArchiveList, StepRunEventList, Tenant, TenantAlertEmailGroup, TenantAlertEmailGroupList, TenantAlertingSettings, TenantInvite, TenantInviteList, TenantMember, TenantMemberList, TenantQueueMetrics, TenantResourcePolicy, TriggerWorkflowRunRequest, UpdateTenantAlertEmailGroupRequest, UpdateTenantInviteRequest, UpdateTenantRequest, UpdateWorkerRequest, User, UserChangePasswordRequest, UserLoginRequest, UserRegisterRequest, UserTenantMembershipsList, WebhookWorkerCreated, WebhookWorkerCreateRequest, WebhookWorkerListResponse, WebhookWorkerRequestListResponse, Worker, WorkerList, Workflow, WorkflowID, WorkflowKindList, WorkflowList, WorkflowMetrics, WorkflowRun, WorkflowRunList, WorkflowRunOrderByDirection, WorkflowRunOrderByField, WorkflowRunsCancelRequest, WorkflowRunShape, WorkflowRunsMetrics, WorkflowRunStatus, WorkflowRunStatusList, WorkflowVersion, WorkflowWorkersCount } from './data-contracts';
+import { AcceptInviteRequest, APIErrors, APIMeta, BulkCreateEventRequest, BulkCreateEventResponse, CancelEventRequest, CreateAPITokenRequest, CreateAPITokenResponse, CreateEventRequest, CreateSNSIntegrationRequest, CreateTenantAlertEmailGroupRequest, CreateTenantInviteRequest, CreateTenantRequest, Event, EventData, EventKey, EventKeyList, EventList, EventOrderByDirection, EventOrderByField, EventSearch, ListAPIMetaIntegration, ListAPITokensResponse, ListSlackWebhooks, ListSNSIntegrations, LogLineLevelField, LogLineList, LogLineOrderByDirection, LogLineOrderByField, LogLineSearch, RateLimitList, RateLimitOrderByDirection, RateLimitOrderByField, RejectInviteRequest, ReplayEventRequest, ReplayWorkflowRunsRequest, ReplayWorkflowRunsResponse, RerunStepRunRequest, SNSIntegration, StepRun, StepRunArchiveList, StepRunEventList, Tenant, TenantAlertEmailGroup, TenantAlertEmailGroupList, TenantAlertingSettings, TenantInvite, TenantInviteList, TenantMember, TenantMemberList, TenantQueueMetrics, TenantResourcePolicy, TenantStepRunQueueMetrics, TriggerWorkflowRunRequest, UpdateTenantAlertEmailGroupRequest, UpdateTenantInviteRequest, UpdateTenantRequest, UpdateWorkerRequest, User, UserChangePasswordRequest, UserLoginRequest, UserRegisterRequest, UserTenantMembershipsList, WebhookWorkerCreated, WebhookWorkerCreateRequest, WebhookWorkerListResponse, WebhookWorkerRequestListResponse, Worker, WorkerList, Workflow, WorkflowID, WorkflowKindList, WorkflowList, WorkflowMetrics, WorkflowRun, WorkflowRunList, WorkflowRunOrderByDirection, WorkflowRunOrderByField, WorkflowRunsCancelRequest, WorkflowRunShape, WorkflowRunsMetrics, WorkflowRunStatus, WorkflowRunStatusList, WorkflowUpdateRequest, WorkflowVersion, WorkflowWorkersCount } from './data-contracts';
 import { HttpClient, RequestParams } from './http-client';
 export declare class Api<SecurityDataType = unknown> extends HttpClient<SecurityDataType> {
     /**
@@ -416,6 +416,16 @@ export declare class Api<SecurityDataType = unknown> extends HttpClient<Security
          */
         additionalMetadata?: string[];
     }, params?: RequestParams) => Promise<import("axios").AxiosResponse<TenantQueueMetrics, any>>;
+    /**
+     * @description Get the queue metrics for the tenant
+     *
+     * @tags Tenant
+     * @name TenantGetStepRunQueueMetrics
+     * @summary Get step run metrics
+     * @request GET:/api/v1/tenants/{tenant}/step-run-queue-metrics
+     * @secure
+     */
+    tenantGetStepRunQueueMetrics: (tenant: string, params?: RequestParams) => Promise<import("axios").AxiosResponse<TenantStepRunQueueMetrics, any>>;
     /**
      * @description Lists all events for a tenant.
      *
@@ -498,6 +508,33 @@ export declare class Api<SecurityDataType = unknown> extends HttpClient<Security
     eventUpdateCancel: (tenant: string, data: CancelEventRequest, params?: RequestParams) => Promise<import("axios").AxiosResponse<{
         workflowRunIds?: string[];
     }, any>>;
+    /**
+     * @description Lists all rate limits for a tenant.
+     *
+     * @tags Rate Limits
+     * @name RateLimitList
+     * @summary List rate limits
+     * @request GET:/api/v1/tenants/{tenant}/rate-limits
+     * @secure
+     */
+    rateLimitList: (tenant: string, query?: {
+        /**
+         * The number to skip
+         * @format int64
+         */
+        offset?: number;
+        /**
+         * The number to limit by
+         * @format int64
+         */
+        limit?: number;
+        /** The search query to filter for */
+        search?: string;
+        /** What to order by */
+        orderByField?: RateLimitOrderByField;
+        /** The order direction */
+        orderByDirection?: RateLimitOrderByDirection;
+    }, params?: RequestParams) => Promise<import("axios").AxiosResponse<RateLimitList, any>>;
     /**
      * @description Gets a list of tenant members
      *
@@ -590,6 +627,16 @@ export declare class Api<SecurityDataType = unknown> extends HttpClient<Security
      * @secure
      */
     workflowDelete: (workflow: string, params?: RequestParams) => Promise<import("axios").AxiosResponse<void, any>>;
+    /**
+     * @description Update a workflow for a tenant
+     *
+     * @tags Workflow
+     * @name WorkflowUpdate
+     * @summary Update workflow
+     * @request PATCH:/api/v1/workflows/{workflow}
+     * @secure
+     */
+    workflowUpdate: (workflow: string, data: WorkflowUpdateRequest, params?: RequestParams) => Promise<import("axios").AxiosResponse<Workflow, any>>;
     /**
      * @description Get a workflow version for a tenant
      *
@@ -807,6 +854,18 @@ export declare class Api<SecurityDataType = unknown> extends HttpClient<Security
          * @example "2021-01-01T00:00:00Z"
          */
         createdBefore?: string;
+        /**
+         * The time after the workflow run was finished
+         * @format date-time
+         * @example "2021-01-01T00:00:00Z"
+         */
+        finishedAfter?: string;
+        /**
+         * The time before the workflow run was finished
+         * @format date-time
+         * @example "2021-01-01T00:00:00Z"
+         */
+        finishedBefore?: string;
         /** The order by field */
         orderByField?: WorkflowRunOrderByField;
         /** The order by direction */

package/clients/rest/generated/Api.js

@@ -422,6 +422,16 @@ class Api extends http_client_1.HttpClient {
          * @secure
          */
         this.tenantGetQueueMetrics = (tenant, query, params = {}) => this.request(Object.assign({ path: `/api/v1/tenants/${tenant}/queue-metrics`, method: 'GET', query: query, secure: true, format: 'json' }, params));
+        /**
+         * @description Get the queue metrics for the tenant
+         *
+         * @tags Tenant
+         * @name TenantGetStepRunQueueMetrics
+         * @summary Get step run metrics
+         * @request GET:/api/v1/tenants/{tenant}/step-run-queue-metrics
+         * @secure
+         */
+        this.tenantGetStepRunQueueMetrics = (tenant, params = {}) => this.request(Object.assign({ path: `/api/v1/tenants/${tenant}/step-run-queue-metrics`, method: 'GET', secure: true, format: 'json' }, params));
         /**
          * @description Lists all events for a tenant.
          *
@@ -472,6 +482,16 @@ class Api extends http_client_1.HttpClient {
          * @secure
          */
         this.eventUpdateCancel = (tenant, data, params = {}) => this.request(Object.assign({ path: `/api/v1/tenants/${tenant}/events/cancel`, method: 'POST', body: data, secure: true, type: http_client_1.ContentType.Json, format: 'json' }, params));
+        /**
+         * @description Lists all rate limits for a tenant.
+         *
+         * @tags Rate Limits
+         * @name RateLimitList
+         * @summary List rate limits
+         * @request GET:/api/v1/tenants/{tenant}/rate-limits
+         * @secure
+         */
+        this.rateLimitList = (tenant, query, params = {}) => this.request(Object.assign({ path: `/api/v1/tenants/${tenant}/rate-limits`, method: 'GET', query: query, secure: true, format: 'json' }, params));
         /**
          * @description Gets a list of tenant members
          *
@@ -562,6 +582,16 @@ class Api extends http_client_1.HttpClient {
          * @secure
          */
         this.workflowDelete = (workflow, params = {}) => this.request(Object.assign({ path: `/api/v1/workflows/${workflow}`, method: 'DELETE', secure: true }, params));
+        /**
+         * @description Update a workflow for a tenant
+         *
+         * @tags Workflow
+         * @name WorkflowUpdate
+         * @summary Update workflow
+         * @request PATCH:/api/v1/workflows/{workflow}
+         * @secure
+         */
+        this.workflowUpdate = (workflow, data, params = {}) => this.request(Object.assign({ path: `/api/v1/workflows/${workflow}`, method: 'PATCH', body: data, secure: true, type: http_client_1.ContentType.Json, format: 'json' }, params));
         /**
          * @description Get a workflow version for a tenant
          *

package/clients/rest/generated/data-contracts.d.ts

@@ -314,6 +314,10 @@ export interface TenantQueueMetrics {
     /** The total queue metrics. */
     total?: QueueMetrics;
     workflow?: Record<string, QueueMetrics>;
+    queues?: Record<string, number>;
+}
+export interface TenantStepRunQueueMetrics {
+    queues?: Record<string, number>;
 }
 export interface AcceptInviteRequest {
     /**
@@ -437,6 +441,37 @@ export interface EventList {
     pagination?: PaginationResponse;
     rows?: Event[];
 }
+export interface RateLimit {
+    /** The key for the rate limit. */
+    key: string;
+    /** The ID of the tenant associated with this rate limit. */
+    tenantId: string;
+    /** The maximum number of requests allowed within the window. */
+    limitValue: number;
+    /** The current number of requests made within the window. */
+    value: number;
+    /** The window of time in which the limitValue is enforced. */
+    window: string;
+    /**
+     * The last time the rate limit was refilled.
+     * @format date-time
+     * @example "2022-12-13T20:06:48.888Z"
+     */
+    lastRefill: string;
+}
+export interface RateLimitList {
+    pagination?: PaginationResponse;
+    rows?: RateLimit[];
+}
+export declare enum RateLimitOrderByField {
+    Key = "key",
+    Value = "value",
+    LimitValue = "limitValue"
+}
+export declare enum RateLimitOrderByDirection {
+    Asc = "asc",
+    Desc = "desc"
+}
 export interface ReplayEventRequest {
     eventIds: string[];
 }
@@ -449,12 +484,18 @@ export interface Workflow {
     name: string;
     /** The description of the workflow. */
     description?: string;
+    /** Whether the workflow is paused. */
+    isPaused?: boolean;
     versions?: WorkflowVersionMeta[];
     /** The tags of the workflow. */
     tags?: WorkflowTag[];
     /** The jobs of the workflow. */
     jobs?: Job[];
 }
+export interface WorkflowUpdateRequest {
+    /** Whether the workflow is paused. */
+    isPaused?: boolean;
+}
 export interface WorkflowConcurrency {
     /**
      * The maximum number of concurrent workflow runs.
@@ -754,6 +795,7 @@ export declare enum StepRunEventReason {
     SCHEDULING_TIMED_OUT = "SCHEDULING_TIMED_OUT",
     ASSIGNED = "ASSIGNED",
     STARTED = "STARTED",
+    ACKNOWLEDGED = "ACKNOWLEDGED",
     FINISHED = "FINISHED",
     FAILED = "FAILED",
     RETRYING = "RETRYING",

package/clients/rest/generated/data-contracts.js

@@ -10,7 +10,7 @@
  * ---------------------------------------------------------------
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WebhookWorkerRequestMethod = exports.LogLineOrderByDirection = exports.LogLineOrderByField = exports.LogLineLevel = exports.PullRequestState = exports.StepRunEventSeverity = exports.StepRunEventReason = exports.StepRunStatus = exports.JobRunStatus = exports.WorkflowKind = exports.WorkflowRunStatus = exports.WorkflowRunOrderByDirection = exports.WorkflowRunOrderByField = exports.EventOrderByDirection = exports.EventOrderByField = exports.TenantResource = exports.TenantMemberRole = void 0;
+exports.WebhookWorkerRequestMethod = exports.LogLineOrderByDirection = exports.LogLineOrderByField = exports.LogLineLevel = exports.PullRequestState = exports.StepRunEventSeverity = exports.StepRunEventReason = exports.StepRunStatus = exports.JobRunStatus = exports.WorkflowKind = exports.WorkflowRunStatus = exports.WorkflowRunOrderByDirection = exports.WorkflowRunOrderByField = exports.RateLimitOrderByDirection = exports.RateLimitOrderByField = exports.EventOrderByDirection = exports.EventOrderByField = exports.TenantResource = exports.TenantMemberRole = void 0;
 var TenantMemberRole;
 (function (TenantMemberRole) {
     TenantMemberRole["OWNER"] = "OWNER";
@@ -34,6 +34,17 @@ var EventOrderByDirection;
     EventOrderByDirection["Asc"] = "asc";
     EventOrderByDirection["Desc"] = "desc";
 })(EventOrderByDirection || (exports.EventOrderByDirection = EventOrderByDirection = {}));
+var RateLimitOrderByField;
+(function (RateLimitOrderByField) {
+    RateLimitOrderByField["Key"] = "key";
+    RateLimitOrderByField["Value"] = "value";
+    RateLimitOrderByField["LimitValue"] = "limitValue";
+})(RateLimitOrderByField || (exports.RateLimitOrderByField = RateLimitOrderByField = {}));
+var RateLimitOrderByDirection;
+(function (RateLimitOrderByDirection) {
+    RateLimitOrderByDirection["Asc"] = "asc";
+    RateLimitOrderByDirection["Desc"] = "desc";
+})(RateLimitOrderByDirection || (exports.RateLimitOrderByDirection = RateLimitOrderByDirection = {}));
 var WorkflowRunOrderByField;
 (function (WorkflowRunOrderByField) {
     WorkflowRunOrderByField["CreatedAt"] = "createdAt";
@@ -87,6 +98,7 @@ var StepRunEventReason;
     StepRunEventReason["SCHEDULING_TIMED_OUT"] = "SCHEDULING_TIMED_OUT";
     StepRunEventReason["ASSIGNED"] = "ASSIGNED";
     StepRunEventReason["STARTED"] = "STARTED";
+    StepRunEventReason["ACKNOWLEDGED"] = "ACKNOWLEDGED";
     StepRunEventReason["FINISHED"] = "FINISHED";
     StepRunEventReason["FAILED"] = "FAILED";
     StepRunEventReason["RETRYING"] = "RETRYING";

package/clients/worker/worker.js

@@ -83,7 +83,7 @@ class Worker {
     }
     registerWorkflow(initWorkflow) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d;
+            var _a, _b, _c;
             const workflow = Object.assign(Object.assign({}, initWorkflow), { id: this.client.config.namespace + initWorkflow.id });
             try {
                 if (((_a = workflow.concurrency) === null || _a === void 0 ? void 0 : _a.key) && workflow.concurrency.expression) {
@@ -112,7 +112,7 @@ class Worker {
                                 parents: [],
                                 userData: '{}',
                                 retries: workflow.onFailure.retries || 0,
-                                rateLimits: (_d = workflow.onFailure.rate_limits) !== null && _d !== void 0 ? _d : [],
+                                rateLimits: (0, step_1.mapRateLimit)(workflow.onFailure.rate_limits),
                                 workerLabels: {}, // no worker labels for on failure steps
                             },
                         ],
@@ -136,7 +136,7 @@ class Worker {
                             name: workflow.id,
                             description: workflow.description,
                             steps: workflow.steps.map((step) => {
-                                var _a, _b;
+                                var _a;
                                 return ({
                                     readableId: step.name,
                                     action: `${workflow.id}:${step.name}`,
@@ -145,7 +145,7 @@ class Worker {
                                     parents: (_a = step.parents) !== null && _a !== void 0 ? _a : [],
                                     userData: '{}',
                                     retries: step.retries || 0,
-                                    rateLimits: (_b = step.rate_limits) !== null && _b !== void 0 ? _b : [], // Add the missing rateLimits property
+                                    rateLimits: (0, step_1.mapRateLimit)(step.rate_limits),
                                     workerLabels: toPbWorkerLabel(step.worker_labels),
                                 });
                             }),

package/examples/bulk-fanout-trigger.d.ts

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

package/examples/bulk-fanout-trigger.js

@@ -0,0 +1,74 @@
+"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); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const sdk_1 = __importDefault(require("../sdk"));
+const hatchet = sdk_1.default.init();
+function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const workflowRuns = [];
+        workflowRuns[0] = {
+            workflowName: 'bulk-parent-workflow',
+            input: {},
+            options: {
+                additionalMetadata: {
+                    key: 'value',
+                },
+            },
+        };
+        workflowRuns[1] = {
+            workflowName: 'bulk-parent-workflow',
+            input: { second: 'second' },
+            options: {
+                additionalMetadata: {
+                    key: 'value',
+                },
+            },
+        };
+        try {
+            const workflowRunResponse = hatchet.admin.runWorkflows(workflowRuns);
+            const result = yield workflowRunResponse;
+            console.log('result', result);
+            result.forEach((workflowRun) => __awaiter(this, void 0, void 0, function* () {
+                var _a, e_1, _b, _c;
+                const stream = yield workflowRun.stream();
+                try {
+                    for (var _d = true, stream_1 = __asyncValues(stream), stream_1_1; stream_1_1 = yield stream_1.next(), _a = stream_1_1.done, !_a; _d = true) {
+                        _c = stream_1_1.value;
+                        _d = false;
+                        const event = _c;
+                        console.log('event received', event);
+                    }
+                }
+                catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                finally {
+                    try {
+                        if (!_d && !_a && (_b = stream_1.return)) yield _b.call(stream_1);
+                    }
+                    finally { if (e_1) throw e_1.error; }
+                }
+            }));
+        }
+        catch (error) {
+            console.log('error', error);
+        }
+    });
+}
+main();

package/examples/bulk-fanout-worker.d.ts

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

package/examples/bulk-fanout-worker.js

@@ -0,0 +1,93 @@
+"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 });
+const sdk_1 = __importDefault(require("../sdk"));
+const hatchet = sdk_1.default.init();
+const parentWorkflow = {
+    id: 'bulk-parent-workflow',
+    description: 'simple example for spawning child workflows',
+    on: {
+        event: 'bulk:fanout:create',
+    },
+    steps: [
+        {
+            name: 'parent-spawn',
+            timeout: '70s',
+            run: (ctx) => __awaiter(void 0, void 0, void 0, function* () {
+                // Prepare the workflows to spawn
+                const workflowRequests = Array.from({ length: 300 }, (_, i) => ({
+                    workflow: 'child-workflow',
+                    input: { input: `child-input-${i}` },
+                    options: { additionalMetadata: { childKey: 'childValue' } },
+                }));
+                const spawnedWorkflows = yield ctx.spawnWorkflows(workflowRequests);
+                const results = yield Promise.all(spawnedWorkflows.map((workflowRef) => workflowRef.result().then((result) => {
+                    ctx.log('spawned workflow result:');
+                    return result;
+                })));
+                console.log('spawned workflow results:', results);
+                console.log('number of spawned workflows:', results.length);
+                return { spawned: results.length };
+            }),
+        },
+    ],
+};
+const childWorkflow = {
+    id: 'child-workflow',
+    description: 'simple example for spawning child workflows',
+    on: {
+        event: 'child:create',
+    },
+    steps: [
+        {
+            name: 'child-work',
+            run: (ctx) => __awaiter(void 0, void 0, void 0, function* () {
+                const { input } = ctx.workflowInput();
+                // throw new Error('child error');
+                return { 'child-output': 'sm' };
+            }),
+        },
+        {
+            name: 'child-work2',
+            run: (ctx) => __awaiter(void 0, void 0, void 0, function* () {
+                const { input } = ctx.workflowInput();
+                // Perform CPU-bound work
+                // throw new Error('child error');
+                console.log('child workflow input:', input);
+                // Generate a large amount of garbage data
+                const garbageData = 'garbage'; // Print a snippet of the garbage data
+                return { 'child-output': garbageData };
+            }),
+        },
+        {
+            name: 'child-work3',
+            parents: ['child-work'],
+            run: (ctx) => __awaiter(void 0, void 0, void 0, function* () {
+                const { input } = ctx.workflowInput();
+                // throw new Error('child error');
+                const garbageData = 'child garbage';
+                return { 'child-output': garbageData };
+            }),
+        },
+    ],
+};
+function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const worker = yield hatchet.worker('fanout-worker', { maxRuns: 1000 });
+        yield worker.registerWorkflow(parentWorkflow);
+        yield worker.registerWorkflow(childWorkflow);
+        worker.start();
+    });
+}
+main();

package/examples/bulk-trigger.d.ts

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

package/examples/bulk-trigger.js

@@ -0,0 +1,63 @@
+"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); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const sdk_1 = __importDefault(require("../sdk"));
+const hatchet = sdk_1.default.init();
+function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const workflowRuns = [];
+        for (let i = 0; i < 100; i += 1) {
+            workflowRuns.push({
+                workflowName: 'simple-workflow',
+                input: {},
+                options: {
+                    additionalMetadata: {
+                        key: 'value',
+                        dedupe: 'key',
+                    },
+                },
+            });
+        }
+        const workflowRunResponse = hatchet.admin.runWorkflows(workflowRuns);
+        const result = yield workflowRunResponse;
+        console.log('result', result);
+        result.forEach((workflowRun) => __awaiter(this, void 0, void 0, function* () {
+            var _a, e_1, _b, _c;
+            const stream = yield workflowRun.stream();
+            try {
+                for (var _d = true, stream_1 = __asyncValues(stream), stream_1_1; stream_1_1 = yield stream_1.next(), _a = stream_1_1.done, !_a; _d = true) {
+                    _c = stream_1_1.value;
+                    _d = false;
+                    const event = _c;
+                    console.log('event received', event);
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = stream_1.return)) yield _b.call(stream_1);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        }));
+    });
+}
+main();

package/examples/rate-limit/worker.js

@@ -23,10 +23,25 @@ const workflow = {
     },
     steps: [
         {
-            name: 'step1',
+            name: 'dynamic',
+            rate_limits: [
+                {
+                    dynamicKey: 'input.group',
+                    units: 1,
+                    limit: 10,
+                    duration: workflows_1.RateLimitDuration.DAY,
+                },
+            ],
+            run: (ctx) => __awaiter(void 0, void 0, void 0, function* () {
+                console.log('starting step1 with the following input and a dynamic rate limit', ctx.workflowInput());
+                return { step1: 'step1 results!' };
+            }),
+        },
+        {
+            name: 'static',
             rate_limits: [{ key: 'test-limit', units: 1 }],
             run: (ctx) => __awaiter(void 0, void 0, void 0, function* () {
-                console.log('starting step1 with the following input', ctx.workflowInput());
+                console.log('starting step1 with the following input and a static rate limit', ctx.workflowInput());
                 return { step1: 'step1 results!' };
             }),
         },