@hatchet-dev/typescript-sdk 1.13.1 → 1.15.0

package/{v1 → src/v1}/client/admin.js

@@ -24,23 +24,51 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AdminClient = void 0;
-const hatchet_error_1 = __importDefault(require("../../util/errors/hatchet-error"));
-const workflow_run_ref_1 = __importDefault(require("../../util/workflow-run-ref"));
-const grpc_helpers_1 = require("../../util/grpc-helpers");
-const child_listener_client_1 = require("../../clients/listeners/run-listener/child-listener-client");
-const workflows_1 = require("../../protoc/workflows");
-const retrier_1 = require("../../util/retrier");
-const batch_1 = require("../../util/batch");
-const apply_namespace_1 = require("../../util/apply-namespace");
+const hatchet_error_1 = __importDefault(require("../../../util/errors/hatchet-error"));
+const workflow_run_ref_1 = __importDefault(require("../../../util/workflow-run-ref"));
+const grpc_helpers_1 = require("../../../util/grpc-helpers");
+const child_listener_client_1 = require("../../../clients/listeners/run-listener/child-listener-client");
+const workflows_1 = require("../../../protoc/workflows");
+const workflows_2 = require("../../../protoc/v1/workflows");
+const retrier_1 = require("../../../util/retrier");
+const batch_1 = require("../../../util/batch");
+const apply_namespace_1 = require("../../../util/apply-namespace");
+function convertDesiredWorkerLabels(labels) {
+    return Object.fromEntries(Object.entries(labels).map(([key, label]) => [
+        key,
+        {
+            strValue: typeof label.value === 'string' ? label.value : undefined,
+            intValue: typeof label.value === 'number' ? label.value : undefined,
+            required: label.required,
+            weight: label.weight,
+            comparator: label.comparator,
+        },
+    ]));
+}
 class AdminClient {
     constructor(config, api, runs) {
         this.config = config;
         this.logger = config.logger(`Admin`, config.log_level);
         const { client, channel, factory } = (0, grpc_helpers_1.createGrpcClient)(config, workflows_1.WorkflowServiceDefinition);
-        this.grpc = client;
+        this.workflowsGrpc = client;
+        this.adminGrpc = factory.create(workflows_2.AdminServiceDefinition, channel);
         this.listenerClient = new child_listener_client_1.RunListenerClient(config, channel, factory, api);
         this.runs = runs;
     }
+    /**
+     * Creates a new workflow or updates an existing workflow via the v1 admin service.
+     * @param workflow a workflow definition to create
+     */
+    putWorkflow(workflow) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                return yield (0, retrier_1.retrier)(() => __awaiter(this, void 0, void 0, function* () { return this.adminGrpc.putWorkflow(workflow); }), this.logger);
+            }
+            catch (e) {
+                throw new hatchet_error_1.default(e.message);
+            }
+        });
+    }
     /**
      * Run a new instance of a workflow with the given input. This will create a new workflow run and return the ID of the
      * new run.
@@ -52,14 +80,16 @@ class AdminClient {
     runWorkflow(workflowName, input, options) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const computedName = (0, apply_namespace_1.applyNamespace)(workflowName, this.config.namespace);
+                const computedName = (0, apply_namespace_1.applyNamespace)(workflowName, this.config.namespace).toLowerCase();
                 const inputStr = JSON.stringify(input);
                 const opts = options !== null && options !== void 0 ? options : {};
-                const { additionalMetadata, parentStepRunId, parentTaskRunExternalId } = opts, rest = __rest(opts, ["additionalMetadata", "parentStepRunId", "parentTaskRunExternalId"]);
+                const { additionalMetadata, parentStepRunId, parentTaskRunExternalId, desiredWorkerLabels } = opts, rest = __rest(opts, ["additionalMetadata", "parentStepRunId", "parentTaskRunExternalId", "desiredWorkerLabels"]);
                 const request = Object.assign(Object.assign({ name: computedName, input: inputStr }, rest), { 
                     // API expects `parentTaskRunExternalId`; accept old names as aliases.
-                    parentTaskRunExternalId: parentTaskRunExternalId !== null && parentTaskRunExternalId !== void 0 ? parentTaskRunExternalId : parentStepRunId, additionalMetadata: additionalMetadata ? JSON.stringify(additionalMetadata) : undefined, priority: opts.priority });
-                const resp = yield (0, retrier_1.retrier)(() => __awaiter(this, void 0, void 0, function* () { return this.grpc.triggerWorkflow(request); }), this.logger);
+                    parentTaskRunExternalId: parentTaskRunExternalId !== null && parentTaskRunExternalId !== void 0 ? parentTaskRunExternalId : parentStepRunId, additionalMetadata: additionalMetadata ? JSON.stringify(additionalMetadata) : undefined, priority: opts.priority, desiredWorkerLabels: desiredWorkerLabels
+                        ? convertDesiredWorkerLabels(desiredWorkerLabels)
+                        : {} });
+                const resp = yield (0, retrier_1.retrier)(() => __awaiter(this, void 0, void 0, function* () { return this.workflowsGrpc.triggerWorkflow(request); }), this.logger);
                 const id = resp.workflowRunId;
                 const ref = new workflow_run_ref_1.default(id, this.listenerClient, this.runs, options === null || options === void 0 ? void 0 : options.parentId, 
                 // eslint-disable-next-line no-underscore-dangle
@@ -82,13 +112,15 @@ class AdminClient {
         return __awaiter(this, arguments, void 0, function* (workflowRuns, batchSize = 500) {
             // Prepare workflows to be triggered in bulk
             const workflowRequests = workflowRuns.map(({ workflowName, input, options }) => {
-                const computedName = (0, apply_namespace_1.applyNamespace)(workflowName, this.config.namespace);
+                const computedName = (0, apply_namespace_1.applyNamespace)(workflowName, this.config.namespace).toLowerCase();
                 const inputStr = JSON.stringify(input);
                 const opts = options !== null && options !== void 0 ? options : {};
-                const { additionalMetadata, parentStepRunId, parentTaskRunExternalId } = opts, rest = __rest(opts, ["additionalMetadata", "parentStepRunId", "parentTaskRunExternalId"]);
+                const { additionalMetadata, parentStepRunId, parentTaskRunExternalId, desiredWorkerLabels } = opts, rest = __rest(opts, ["additionalMetadata", "parentStepRunId", "parentTaskRunExternalId", "desiredWorkerLabels"]);
                 return Object.assign(Object.assign({ name: computedName, input: inputStr }, rest), { 
                     // API expects `parentTaskRunExternalId`; accept old names as aliases.
-                    parentTaskRunExternalId: parentTaskRunExternalId !== null && parentTaskRunExternalId !== void 0 ? parentTaskRunExternalId : parentStepRunId, additionalMetadata: additionalMetadata ? JSON.stringify(additionalMetadata) : undefined });
+                    parentTaskRunExternalId: parentTaskRunExternalId !== null && parentTaskRunExternalId !== void 0 ? parentTaskRunExternalId : parentStepRunId, additionalMetadata: additionalMetadata ? JSON.stringify(additionalMetadata) : undefined, desiredWorkerLabels: desiredWorkerLabels
+                        ? convertDesiredWorkerLabels(desiredWorkerLabels)
+                        : {} });
             });
             const limit = 4 * 1024 * 1024; // FIXME configurable GRPC limit
             const batches = (0, batch_1.batch)(workflowRequests, batchSize, limit);
@@ -101,7 +133,7 @@ class AdminClient {
                         workflows: payloads,
                     });
                     // Call the bulk trigger workflow method for this batch
-                    const bulkTriggerWorkflowResponse = yield (0, retrier_1.retrier)(() => __awaiter(this, void 0, void 0, function* () { return this.grpc.bulkTriggerWorkflow(request); }), this.logger);
+                    const bulkTriggerWorkflowResponse = yield (0, retrier_1.retrier)(() => __awaiter(this, void 0, void 0, function* () { return this.workflowsGrpc.bulkTriggerWorkflow(request); }), this.logger);
                     this.logger.debug(`batch ${batchIndex + 1} of ${batches.length}`);
                     // Map the results back to their original indices
                     const batchResults = bulkTriggerWorkflowResponse.workflowRunIds.map((resp, index) => {
@@ -127,7 +159,7 @@ class AdminClient {
                 limit,
                 duration,
             };
-            yield (0, retrier_1.retrier)(() => __awaiter(this, void 0, void 0, function* () { return this.grpc.putRateLimit(request); }), this.logger);
+            yield (0, retrier_1.retrier)(() => __awaiter(this, void 0, void 0, function* () { return this.workflowsGrpc.putRateLimit(request); }), this.logger);
         });
     }
 }

package/{v1 → src/v1}/client/client.d.ts

@@ -1,11 +1,20 @@
-import { ClientConfig, HatchetClientOptions, LegacyHatchetClient, TaskMiddleware, InferMiddlewareBefore, InferMiddlewareAfter } from '../../clients/hatchet-client';
+/**
+ * This is the TypeScript SDK reference, documenting methods available for interacting with Hatchet resources.
+ * Check out the [user guide](https://docs.hatchet.run/home/) for an introduction to getting your first tasks running.
+ *
+ * @module Hatchet TypeScript SDK Reference
+ */
+import { ClientConfig, HatchetClientOptions, LegacyHatchetClient, TaskMiddleware, InferMiddlewareBefore, InferMiddlewareAfter } from '../../../clients/hatchet-client';
 import { AxiosRequestConfig } from 'axios';
-import WorkflowRunRef from '../../util/workflow-run-ref';
-import { Workflow as V0Workflow } from '../../workflow';
-import { V0DurableContext } from '../../step';
-import { Api } from '../../clients/rest';
-import { RunListenerClient } from '../../clients/listeners/run-listener/child-listener-client';
+import WorkflowRunRef from '../../../util/workflow-run-ref';
+import { Api } from '../../../clients/rest';
+import { EventClient } from '../../../clients/event/event-client';
+import { DispatcherClient } from '../../../clients/dispatcher/dispatcher-client';
+import { Logger } from '../../../util/logger';
+import { RunListenerClient } from '../../../clients/listeners/run-listener/child-listener-client';
+import { DurableListenerClient } from '../../../clients/listeners/durable-listener/durable-listener-client';
 import { CreateTaskWorkflowOpts, CreateWorkflowOpts, RunOpts, BaseWorkflowDeclaration, WorkflowDeclaration, TaskWorkflowDeclaration, CreateDurableTaskWorkflowOpts } from '../declaration';
+import type { LegacyWorkflow } from '../../legacy/legacy-transformer';
 import { IHatchetClient } from './client.interface';
 import { CreateWorkerOpts, Worker } from './worker/worker';
 import { MetricsClient } from './features/metrics';
@@ -21,6 +30,7 @@ import { CronClient } from './features/crons';
 import { CELClient } from './features/cel';
 import { TenantClient } from './features/tenant';
 import { WebhooksClient } from './features/webhooks';
+import { DurableContext } from './worker/context';
 type MergeIfNonEmpty<Base, Extra extends Record<string, any>> = keyof Extra extends never ? Base : Base & Extra;
 /**
  * HatchetV1 implements the main client interface for interacting with the Hatchet workflow engine.
@@ -31,16 +41,21 @@ type MergeIfNonEmpty<Base, Extra extends Record<string, any>> = keyof Extra exte
  * @template MiddlewareAfter - Extra fields merged into task output by post-middleware hooks. Inferred from middleware config.
  */
 export declare class HatchetClient<GlobalInput extends Record<string, any> = {}, GlobalOutput extends Record<string, any> = {}, MiddlewareBefore extends Record<string, any> = {}, MiddlewareAfter extends Record<string, any> = {}> implements IHatchetClient {
-    /** The underlying v0 client instance */
-    _v0: LegacyHatchetClient;
+    private _v0;
     _api: Api;
     _listener: RunListenerClient;
+    private _options;
+    private _axiosConfig;
+    private _clientFactory;
+    private _credentials;
     /**
      * @deprecated v0 client will be removed in a future release, please upgrade to v1
+     * @hidden
      */
     get v0(): LegacyHatchetClient;
     /** The tenant ID for the Hatchet client */
     tenantId: string;
+    logger: Logger;
     _isV1: boolean | undefined;
     get isV1(): boolean;
     /**
@@ -48,6 +63,7 @@ export declare class HatchetClient<GlobalInput extends Record<string, any> = {},
      * @param config - Optional configuration for the client
      * @param options - Optional client options
      * @param axiosConfig - Optional Axios configuration for HTTP requests
+     * @internal
      */
     constructor(config?: Partial<ClientConfig>, options?: HatchetClientOptions, axiosConfig?: AxiosRequestConfig);
     /**
@@ -58,6 +74,7 @@ export declare class HatchetClient<GlobalInput extends Record<string, any> = {},
      * @param options - Optional client options.
      * @param axiosConfig - Optional Axios configuration for HTTP requests.
      * @returns A new Hatchet client instance. Chain `.withMiddleware()` to attach typed middleware.
+     * @internal
      */
     static init<T extends Record<string, any> = {}, U extends Record<string, any> = {}>(config?: Omit<Partial<ClientConfig>, 'middleware'>, options?: HatchetClientOptions, axiosConfig?: AxiosRequestConfig): HatchetClient<T, U>;
     /**
@@ -66,6 +83,7 @@ export declare class HatchetClient<GlobalInput extends Record<string, any> = {},
      *
      * Use this after `init<T, U>()` to get full middleware return-type inference
      * that TypeScript can't provide when global types are explicitly set on `init`.
+     * @internal
      */
     withMiddleware<const M extends TaskMiddleware<Resolved<GlobalInput, MiddlewareBefore>, Resolved<GlobalOutput, MiddlewareAfter>>>(middleware: M): HatchetClient<GlobalInput, GlobalOutput, MiddlewareBefore & InferMiddlewareBefore<M>, MiddlewareAfter & InferMiddlewareAfter<M>>;
     private _config;
@@ -112,7 +130,7 @@ export declare class HatchetClient<GlobalInput extends Record<string, any> = {},
      * @param options Durable task configuration options with function that defines types
      * @returns A TaskWorkflowDeclaration instance with inferred types
      */
-    durableTask<Fn extends (input: I, ctx: V0DurableContext<I>) => O | Promise<O>, I extends InputType = Parameters<Fn>[0], O extends OutputType = ReturnType<Fn> extends Promise<infer P> ? P extends OutputType ? P : void : ReturnType<Fn> extends OutputType ? ReturnType<Fn> : void>(options: {
+    durableTask<Fn extends (input: I, ctx: DurableContext<I>) => O | Promise<O>, I extends InputType = Parameters<Fn>[0], O extends OutputType = ReturnType<Fn> extends Promise<infer P> ? P extends OutputType ? P : void : ReturnType<Fn> extends OutputType ? ReturnType<Fn> : void>(options: {
         fn: Fn;
     } & Omit<CreateDurableTaskWorkflowOpts<I, O>, 'fn'>): TaskWorkflowDeclaration<I, O, GlobalInput, GlobalOutput, MiddlewareBefore, MiddlewareAfter>;
     /**
@@ -124,18 +142,18 @@ export declare class HatchetClient<GlobalInput extends Record<string, any> = {},
      * @param options - Configuration options for the workflow run
      * @returns A WorkflowRunRef containing the run ID and methods to interact with the run
      */
-    runNoWait<I extends InputType = UnknownInputType, O extends OutputType = void>(workflow: BaseWorkflowDeclaration<I, O> | string | V0Workflow, input: I, options: RunOpts): Promise<WorkflowRunRef<O>>;
+    runNoWait<I extends InputType = UnknownInputType, O extends OutputType = void>(workflow: BaseWorkflowDeclaration<I, O> | LegacyWorkflow | string, input: I, options: RunOpts): Promise<WorkflowRunRef<O>>;
     /**
-     * @alias run
      * Triggers a workflow run and waits for the result.
      * @template I - The input type for the workflow
      * @template O - The return type of the workflow
      * @param workflow - The workflow to run, either as a Workflow instance or workflow name
      * @param input - The input data for the workflow
+     * @alias run
      * @param options - Configuration options for the workflow run
      * @returns A promise that resolves with the workflow result
      */
-    runAndWait<I extends InputType = UnknownInputType, O extends OutputType = void>(workflow: BaseWorkflowDeclaration<I, O> | string | V0Workflow, input: I, options?: RunOpts): Promise<O>;
+    runAndWait<I extends InputType = UnknownInputType, O extends OutputType = void>(workflow: BaseWorkflowDeclaration<I, O> | LegacyWorkflow | string, input: I, options?: RunOpts): Promise<O>;
     /**
      * Triggers a workflow run and waits for the result.
      * @template I - The input type for the workflow
@@ -145,11 +163,12 @@ export declare class HatchetClient<GlobalInput extends Record<string, any> = {},
      * @param options - Configuration options for the workflow run
      * @returns A promise that resolves with the workflow result
      */
-    run<I extends InputType = UnknownInputType, O extends OutputType = void>(workflow: BaseWorkflowDeclaration<I, O> | string | V0Workflow, input: I, options?: RunOpts): Promise<O>;
+    run<I extends InputType = UnknownInputType, O extends OutputType = void>(workflow: BaseWorkflowDeclaration<I, O> | LegacyWorkflow | string, input: I, options?: RunOpts): Promise<O>;
     private _cel;
     /**
      * Get the CEL client for debugging CEL expressions
      * @returns A CEL client instance
+     * @internal
      */
     get cel(): CELClient;
     private _crons;
@@ -162,6 +181,7 @@ export declare class HatchetClient<GlobalInput extends Record<string, any> = {},
      * Get the cron client for creating and managing cron workflow runs
      * @returns A cron client instance
      * @deprecated use client.crons instead
+     * @hidden
      */
     get cron(): CronClient;
     private _scheduled;
@@ -174,23 +194,44 @@ export declare class HatchetClient<GlobalInput extends Record<string, any> = {},
      * Get the schedule client for creating and managing scheduled workflow runs
      * @returns A schedule client instance
      * @deprecated use client.scheduled instead
+     * @hidden
      */
     get schedule(): ScheduleClient;
     /**
      * @alias scheduled
      */
     get schedules(): ScheduleClient;
+    private _dispatcher;
     /**
-     * Get the event client for creating and managing event workflow runs
-     * @returns A event client instance
+     * Get the dispatcher client for sending action events and managing worker registration
+     * @returns A dispatcher client instance
+     * @internal
      */
-    get events(): import("../../clients/event/event-client").EventClient;
+    get dispatcher(): DispatcherClient;
+    private _event;
     /**
      * Get the event client for creating and managing event workflow runs
      * @returns A event client instance
+     */
+    get events(): EventClient;
+    private _durableListener;
+    /**
+     * Get the durable listener client for managing durable event subscriptions
+     * @returns A durable listener client instance
+     * @internal
+     */
+    get durableListener(): DurableListenerClient;
+    /**
+     * Get the run listener client for streaming workflow run results
+     * @returns A run listener client instance
+     * @internal
+     */
+    get listener(): RunListenerClient;
+    /**
      * @deprecated use client.events instead
+     * @hidden
      */
-    get event(): import("../../clients/event/event-client").EventClient;
+    get event(): EventClient;
     private _metrics;
     /**
      * Get the metrics client for creating and managing metrics
@@ -254,6 +295,7 @@ export declare class HatchetClient<GlobalInput extends Record<string, any> = {},
     /**
      * Get the admin client for creating and managing workflows
      * @returns A admin client instance
+     * @internal
      */
     get admin(): AdminClient;
     /**
@@ -262,12 +304,6 @@ export declare class HatchetClient<GlobalInput extends Record<string, any> = {},
      * @returns A promise that resolves with a new HatchetWorker instance
      */
     worker(name: string, options?: CreateWorkerOpts | number): Promise<Worker>;
-    /**
-     * Register a webhook with the worker
-     * @param workflows - The workflows to register on the webhooks
-     * @returns A promise that resolves when the webhook is registered
-     */
-    v0webhooks(workflows: V0Workflow[]): import("../../clients/worker/handler").WebhookHandler;
     runRef<T extends Record<string, any> = any>(id: string): WorkflowRunRef<T>;
 }
 export {};

package/{v1 → src/v1}/client/client.interface.d.ts

@@ -1,4 +1,7 @@
-import { LegacyHatchetClient } from '../../clients/hatchet-client';
+import { EventClient } from '../../../clients/event/event-client';
+import { DispatcherClient } from '../../../clients/dispatcher/dispatcher-client';
+import { Logger } from '../../../util/logger';
+import { LegacyHatchetClient } from '../../legacy/legacy-client';
 import { MetricsClient } from './features/metrics';
 import { RunsClient } from './features/runs';
 import { WorkersClient } from './features/workers';
@@ -8,8 +11,12 @@ import { ScheduleClient } from './features/schedules';
 import { CronClient } from './features/crons';
 import { CELClient } from './features/cel';
 export interface IHatchetClient {
-    _v0: LegacyHatchetClient;
+    /** @deprecated v0 client will be removed in a future release, please upgrade to v1 */
+    v0: LegacyHatchetClient;
     cel: CELClient;
+    dispatcher: DispatcherClient;
+    events: EventClient;
+    logger: Logger;
     metrics: MetricsClient;
     runs: RunsClient;
     workflows: WorkflowsClient;

package/{v1 → src/v1}/client/client.js

@@ -13,18 +13,27 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HatchetClient = void 0;
+/**
+ * This is the TypeScript SDK reference, documenting methods available for interacting with Hatchet resources.
+ * Check out the [user guide](https://docs.hatchet.run/home/) for an introduction to getting your first tasks running.
+ *
+ * @module Hatchet TypeScript SDK Reference
+ */
 /* eslint-disable no-dupe-class-members */
 /* eslint-disable no-underscore-dangle */
-const hatchet_client_1 = require("../../clients/hatchet-client");
-const rest_1 = __importDefault(require("../../clients/rest"));
-const config_loader_1 = require("../../util/config-loader");
-const hatchet_logger_1 = require("../../clients/hatchet-client/hatchet-logger");
+const hatchet_client_1 = require("../../../clients/hatchet-client");
+const rest_1 = __importDefault(require("../../../clients/rest"));
+const config_loader_1 = require("../../../util/config-loader");
+const hatchet_logger_1 = require("../../../clients/hatchet-client/hatchet-logger");
 const zod_1 = require("zod");
-const event_client_1 = require("../../clients/event/event-client");
-const child_listener_client_1 = require("../../clients/listeners/run-listener/child-listener-client");
-const grpc_helpers_1 = require("../../util/grpc-helpers");
+const event_client_1 = require("../../../clients/event/event-client");
+const dispatcher_client_1 = require("../../../clients/dispatcher/dispatcher-client");
+const child_listener_client_1 = require("../../../clients/listeners/run-listener/child-listener-client");
+const durable_listener_client_1 = require("../../../clients/listeners/durable-listener/durable-listener-client");
+const grpc_helpers_1 = require("../../../util/grpc-helpers");
 const nice_grpc_1 = require("nice-grpc");
 const declaration_1 = require("../declaration");
+const legacy_transformer_1 = require("../../legacy/legacy-transformer");
 const worker_1 = require("./worker/worker");
 const metrics_1 = require("./features/metrics");
 const workers_1 = require("./features/workers");
@@ -49,8 +58,12 @@ const webhooks_1 = require("./features/webhooks");
 class HatchetClient {
     /**
      * @deprecated v0 client will be removed in a future release, please upgrade to v1
+     * @hidden
      */
     get v0() {
+        if (!this._v0) {
+            this._v0 = new hatchet_client_1.LegacyHatchetClient(this._config, this._options, this._axiosConfig, this.runs, this._listener, this.events, this.dispatcher, this.logger, this.durableListener);
+        }
         return this._v0;
     }
     get isV1() {
@@ -61,6 +74,7 @@ class HatchetClient {
      * @param config - Optional configuration for the client
      * @param options - Optional client options
      * @param axiosConfig - Optional Axios configuration for HTTP requests
+     * @internal
      */
     constructor(config, options, axiosConfig) {
         var _a;
@@ -77,11 +91,14 @@ class HatchetClient {
             const clientConfig = Object.assign(Object.assign({}, valid), { logger: logConstructor });
             this._config = clientConfig;
             this.tenantId = clientConfig.tenant_id;
+            this.logger = clientConfig.logger('HatchetClient', clientConfig.log_level);
             this._api = (0, rest_1.default)(clientConfig.api_url, clientConfig.token, axiosConfig);
-            const clientFactory = (0, nice_grpc_1.createClientFactory)().use((0, grpc_helpers_1.addTokenMiddleware)(this.config.token));
-            const credentials = (_a = options === null || options === void 0 ? void 0 : options.credentials) !== null && _a !== void 0 ? _a : config_loader_1.ConfigLoader.createCredentials(this.config.tls_config);
-            this._listener = new child_listener_client_1.RunListenerClient(this.config, (0, grpc_helpers_1.channelFactory)(this.config, credentials), clientFactory, this.api);
-            this._v0 = new hatchet_client_1.LegacyHatchetClient(clientConfig, options, axiosConfig, this.runs, this._listener);
+            this._clientFactory = (0, nice_grpc_1.createClientFactory)().use((0, grpc_helpers_1.addTokenMiddleware)(this.config.token));
+            this._credentials =
+                (_a = options === null || options === void 0 ? void 0 : options.credentials) !== null && _a !== void 0 ? _a : config_loader_1.ConfigLoader.createCredentials(this.config.tls_config);
+            this._listener = new child_listener_client_1.RunListenerClient(this.config, (0, grpc_helpers_1.channelFactory)(this.config, this._credentials), this._clientFactory, this.api);
+            this._options = options;
+            this._axiosConfig = axiosConfig;
         }
         catch (e) {
             if (e instanceof zod_1.z.ZodError) {
@@ -115,6 +132,7 @@ class HatchetClient {
      * @param options - Optional client options.
      * @param axiosConfig - Optional Axios configuration for HTTP requests.
      * @returns A new Hatchet client instance. Chain `.withMiddleware()` to attach typed middleware.
+     * @internal
      */
     static init(config, options, axiosConfig) {
         return new HatchetClient(config, options, axiosConfig);
@@ -125,6 +143,7 @@ class HatchetClient {
      *
      * Use this after `init<T, U>()` to get full middleware return-type inference
      * that TypeScript can't provide when global types are explicitly set on `init`.
+     * @internal
      */
     withMiddleware(middleware) {
         const existing = this._config.middleware || {};
@@ -178,26 +197,17 @@ class HatchetClient {
      */
     runNoWait(workflow, input, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            let name;
-            if (typeof workflow === 'string') {
-                name = workflow;
-            }
-            else if ('id' in workflow) {
-                name = workflow.id;
-            }
-            else {
-                throw new Error('unable to identify workflow');
-            }
+            const name = (0, legacy_transformer_1.getWorkflowName)(workflow);
             return this.admin.runWorkflow(name, input, options);
         });
     }
     /**
-     * @alias run
      * Triggers a workflow run and waits for the result.
      * @template I - The input type for the workflow
      * @template O - The return type of the workflow
      * @param workflow - The workflow to run, either as a Workflow instance or workflow name
      * @param input - The input data for the workflow
+     * @alias run
      * @param options - Configuration options for the workflow run
      * @returns A promise that resolves with the workflow result
      */
@@ -224,6 +234,7 @@ class HatchetClient {
     /**
      * Get the CEL client for debugging CEL expressions
      * @returns A CEL client instance
+     * @internal
      */
     get cel() {
         if (!this._cel) {
@@ -245,6 +256,7 @@ class HatchetClient {
      * Get the cron client for creating and managing cron workflow runs
      * @returns A cron client instance
      * @deprecated use client.crons instead
+     * @hidden
      */
     get cron() {
         return this.crons;
@@ -263,6 +275,7 @@ class HatchetClient {
      * Get the schedule client for creating and managing scheduled workflow runs
      * @returns A schedule client instance
      * @deprecated use client.scheduled instead
+     * @hidden
      */
     get schedule() {
         return this.scheduled;
@@ -273,17 +286,49 @@ class HatchetClient {
     get schedules() {
         return this.scheduled;
     }
+    /**
+     * Get the dispatcher client for sending action events and managing worker registration
+     * @returns A dispatcher client instance
+     * @internal
+     */
+    get dispatcher() {
+        if (!this._dispatcher) {
+            this._dispatcher = new dispatcher_client_1.DispatcherClient(this._config, (0, grpc_helpers_1.channelFactory)(this._config, this._credentials), this._clientFactory);
+        }
+        return this._dispatcher;
+    }
     /**
      * Get the event client for creating and managing event workflow runs
      * @returns A event client instance
      */
     get events() {
-        return this._v0.event;
+        if (!this._event) {
+            this._event = new event_client_1.EventClient(this._config, (0, grpc_helpers_1.channelFactory)(this._config, this._credentials), this._clientFactory, this.api);
+        }
+        return this._event;
+    }
+    /**
+     * Get the durable listener client for managing durable event subscriptions
+     * @returns A durable listener client instance
+     * @internal
+     */
+    get durableListener() {
+        if (!this._durableListener) {
+            this._durableListener = new durable_listener_client_1.DurableListenerClient(this._config, (0, grpc_helpers_1.channelFactory)(this._config, this._credentials), this._clientFactory, this.api);
+        }
+        return this._durableListener;
+    }
+    /**
+     * Get the run listener client for streaming workflow run results
+     * @returns A run listener client instance
+     * @internal
+     */
+    get listener() {
+        return this._listener;
     }
     /**
-     * Get the event client for creating and managing event workflow runs
-     * @returns A event client instance
      * @deprecated use client.events instead
+     * @hidden
      */
     get event() {
         return this.events;
@@ -386,10 +431,11 @@ class HatchetClient {
     /**
      * Get the admin client for creating and managing workflows
      * @returns A admin client instance
+     * @internal
      */
     get admin() {
         if (!this._admin) {
-            this._admin = new admin_1.AdminClient(this._v0.config, this.api, this.runs);
+            this._admin = new admin_1.AdminClient(this._config, this.api, this.runs);
         }
         return this._admin;
     }
@@ -406,15 +452,7 @@ class HatchetClient {
         else {
             opts = options || {};
         }
-        return worker_1.Worker.create(this, this._v0, name, opts);
-    }
-    /**
-     * Register a webhook with the worker
-     * @param workflows - The workflows to register on the webhooks
-     * @returns A promise that resolves when the webhook is registered
-     */
-    v0webhooks(workflows) {
-        return this._v0.webhooks(workflows);
+        return worker_1.Worker.create(this, name, opts);
     }
     runRef(id) {
         return this.runs.runRef(id);

package/{v1 → src/v1}/client/features/cel.d.ts

@@ -1,4 +1,4 @@
-import { V1CELDebugResponseStatus } from '../../../clients/rest/generated/data-contracts';
+import { V1CELDebugResponseStatus } from '../../../../clients/rest/generated/data-contracts';
 import { HatchetClient } from '../client';
 export type DebugCELInput = {
     expression: string;

package/{v1 → src/v1}/client/features/cel.js

@@ -11,7 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CELClient = void 0;
 const axios_1 = require("axios");
-const data_contracts_1 = require("../../../clients/rest/generated/data-contracts");
+const data_contracts_1 = require("../../../../clients/rest/generated/data-contracts");
 /**
  * Client for debugging CEL expressions.
  */

package/{v1 → src/v1}/client/features/crons.d.ts

@@ -1,11 +1,12 @@
-import { CronWorkflows, CronWorkflowsList } from '../../../clients/rest/generated/data-contracts';
+import { CronWorkflows, CronWorkflowsList } from '../../../../clients/rest/generated/data-contracts';
 import { z } from 'zod';
-import { Workflow } from '../../../workflow';
-import { BaseWorkflowDeclaration } from '../..';
+import { BaseWorkflowDeclaration } from '../../../../v1';
+import type { LegacyWorkflow } from '../../../../legacy/legacy-transformer';
 import { HatchetClient } from '../client';
 import { WorkflowsClient } from './workflows';
 /**
  * Schema for creating a Cron Trigger.
+ * @internal
  */
 export declare const CreateCronTriggerSchema: z.ZodObject<{
     name: z.ZodString;
@@ -28,10 +29,11 @@ export declare const CreateCronTriggerSchema: z.ZodObject<{
 }>;
 /**
  * Type representing the input for creating a Cron.
+ * @internal
  */
 export type CreateCronInput = z.infer<typeof CreateCronTriggerSchema>;
 /**
- * Client for managing Cron Triggers.
+ * The cron client is a client for managing cron workflows within Hatchet.
  */
 export declare class CronClient {
     api: HatchetClient['api'];
@@ -52,7 +54,7 @@ export declare class CronClient {
      * @returns A promise that resolves to the created CronWorkflows object.
      * @throws Will throw an error if the input is invalid or the API call fails.
      */
-    create(workflow: string | Workflow | BaseWorkflowDeclaration<any, any>, cron: CreateCronInput): Promise<CronWorkflows>;
+    create(workflow: string | BaseWorkflowDeclaration<any, any> | LegacyWorkflow, cron: CreateCronInput): Promise<CronWorkflows>;
     /**
      * Deletes an existing Cron Trigger.
      * @param cron - The Cron Trigger ID as a string or CronWorkflows object.
@@ -65,7 +67,7 @@ export declare class CronClient {
      * @returns A promise that resolves to a CronWorkflowsList object.
      */
     list(query: Parameters<typeof this.api.cronWorkflowList>[1] & {
-        workflow?: string | Workflow | BaseWorkflowDeclaration<any, any>;
+        workflow?: string | BaseWorkflowDeclaration<any, any> | LegacyWorkflow;
     }): Promise<CronWorkflowsList>;
     /**
      * Retrieves a specific Cron Trigger by its ID.