@hatchet-dev/typescript-sdk 1.15.2 → 1.16.0

package/legacy/workflow.d.ts

@@ -17,16 +17,16 @@ declare const StepsSchema: z.ZodArray<z.ZodObject<{
         units: string | number;
         key?: string | undefined;
         duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+        limit?: string | number | undefined;
         staticKey?: string | undefined;
         dynamicKey?: string | undefined;
-        limit?: string | number | undefined;
     }, {
         units: string | number;
         key?: string | undefined;
         duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+        limit?: string | number | undefined;
         staticKey?: string | undefined;
         dynamicKey?: string | undefined;
-        limit?: string | number | undefined;
     }>, "many">>;
     worker_labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodLazy<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodObject<{
         value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
@@ -59,13 +59,17 @@ declare const StepsSchema: z.ZodArray<z.ZodObject<{
     timeout?: string | undefined;
     parents?: string[] | undefined;
     retries?: number | undefined;
+    backoff?: {
+        factor?: number | undefined;
+        maxSeconds?: number | undefined;
+    } | undefined;
     rate_limits?: {
         units: string | number;
         key?: string | undefined;
         duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+        limit?: string | number | undefined;
         staticKey?: string | undefined;
         dynamicKey?: string | undefined;
-        limit?: string | number | undefined;
     }[] | undefined;
     worker_labels?: Record<string, string | number | {
         value: string | number;
@@ -73,22 +77,22 @@ declare const StepsSchema: z.ZodArray<z.ZodObject<{
         comparator?: import("../protoc/workflows").WorkerLabelComparator | undefined;
         weight?: number | undefined;
     } | undefined> | undefined;
-    backoff?: {
-        factor?: number | undefined;
-        maxSeconds?: number | undefined;
-    } | undefined;
 }, {
     name: string;
     timeout?: string | undefined;
     parents?: string[] | undefined;
     retries?: number | undefined;
+    backoff?: {
+        factor?: number | undefined;
+        maxSeconds?: number | undefined;
+    } | undefined;
     rate_limits?: {
         units: string | number;
         key?: string | undefined;
         duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+        limit?: string | number | undefined;
         staticKey?: string | undefined;
         dynamicKey?: string | undefined;
-        limit?: string | number | undefined;
     }[] | undefined;
     worker_labels?: Record<string, string | number | {
         value: string | number;
@@ -96,10 +100,6 @@ declare const StepsSchema: z.ZodArray<z.ZodObject<{
         comparator?: import("../protoc/workflows").WorkerLabelComparator | undefined;
         weight?: number | undefined;
     } | undefined> | undefined;
-    backoff?: {
-        factor?: number | undefined;
-        maxSeconds?: number | undefined;
-    } | undefined;
 }>, "many">;
 export type Steps = z.infer<typeof StepsSchema>;
 export declare const ConcurrencyLimitStrategy: typeof PbConcurrencyLimitStrategy;
@@ -166,16 +166,16 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
             units: string | number;
             key?: string | undefined;
             duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+            limit?: string | number | undefined;
             staticKey?: string | undefined;
             dynamicKey?: string | undefined;
-            limit?: string | number | undefined;
         }, {
             units: string | number;
             key?: string | undefined;
             duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+            limit?: string | number | undefined;
             staticKey?: string | undefined;
             dynamicKey?: string | undefined;
-            limit?: string | number | undefined;
         }>, "many">>;
         worker_labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodLazy<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodObject<{
             value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
@@ -208,13 +208,17 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
         timeout?: string | undefined;
         parents?: string[] | undefined;
         retries?: number | undefined;
+        backoff?: {
+            factor?: number | undefined;
+            maxSeconds?: number | undefined;
+        } | undefined;
         rate_limits?: {
             units: string | number;
             key?: string | undefined;
             duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+            limit?: string | number | undefined;
             staticKey?: string | undefined;
             dynamicKey?: string | undefined;
-            limit?: string | number | undefined;
         }[] | undefined;
         worker_labels?: Record<string, string | number | {
             value: string | number;
@@ -222,22 +226,22 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
             comparator?: import("../protoc/workflows").WorkerLabelComparator | undefined;
             weight?: number | undefined;
         } | undefined> | undefined;
-        backoff?: {
-            factor?: number | undefined;
-            maxSeconds?: number | undefined;
-        } | undefined;
     }, {
         name: string;
         timeout?: string | undefined;
         parents?: string[] | undefined;
         retries?: number | undefined;
+        backoff?: {
+            factor?: number | undefined;
+            maxSeconds?: number | undefined;
+        } | undefined;
         rate_limits?: {
             units: string | number;
             key?: string | undefined;
             duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+            limit?: string | number | undefined;
             staticKey?: string | undefined;
             dynamicKey?: string | undefined;
-            limit?: string | number | undefined;
         }[] | undefined;
         worker_labels?: Record<string, string | number | {
             value: string | number;
@@ -245,10 +249,6 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
             comparator?: import("../protoc/workflows").WorkerLabelComparator | undefined;
             weight?: number | undefined;
         } | undefined> | undefined;
-        backoff?: {
-            factor?: number | undefined;
-            maxSeconds?: number | undefined;
-        } | undefined;
     }>, "many">;
     onFailure: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
@@ -266,16 +266,16 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
             units: string | number;
             key?: string | undefined;
             duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+            limit?: string | number | undefined;
             staticKey?: string | undefined;
             dynamicKey?: string | undefined;
-            limit?: string | number | undefined;
         }, {
             units: string | number;
             key?: string | undefined;
             duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+            limit?: string | number | undefined;
             staticKey?: string | undefined;
             dynamicKey?: string | undefined;
-            limit?: string | number | undefined;
         }>, "many">>;
         worker_labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodLazy<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodObject<{
             value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
@@ -308,13 +308,17 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
         timeout?: string | undefined;
         parents?: string[] | undefined;
         retries?: number | undefined;
+        backoff?: {
+            factor?: number | undefined;
+            maxSeconds?: number | undefined;
+        } | undefined;
         rate_limits?: {
             units: string | number;
             key?: string | undefined;
             duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+            limit?: string | number | undefined;
             staticKey?: string | undefined;
             dynamicKey?: string | undefined;
-            limit?: string | number | undefined;
         }[] | undefined;
         worker_labels?: Record<string, string | number | {
             value: string | number;
@@ -322,22 +326,22 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
             comparator?: import("../protoc/workflows").WorkerLabelComparator | undefined;
             weight?: number | undefined;
         } | undefined> | undefined;
-        backoff?: {
-            factor?: number | undefined;
-            maxSeconds?: number | undefined;
-        } | undefined;
     }, {
         name: string;
         timeout?: string | undefined;
         parents?: string[] | undefined;
         retries?: number | undefined;
+        backoff?: {
+            factor?: number | undefined;
+            maxSeconds?: number | undefined;
+        } | undefined;
         rate_limits?: {
             units: string | number;
             key?: string | undefined;
             duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+            limit?: string | number | undefined;
             staticKey?: string | undefined;
             dynamicKey?: string | undefined;
-            limit?: string | number | undefined;
         }[] | undefined;
         worker_labels?: Record<string, string | number | {
             value: string | number;
@@ -345,10 +349,6 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
             comparator?: import("../protoc/workflows").WorkerLabelComparator | undefined;
             weight?: number | undefined;
         } | undefined> | undefined;
-        backoff?: {
-            factor?: number | undefined;
-            maxSeconds?: number | undefined;
-        } | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     description: string;
@@ -358,13 +358,17 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
         timeout?: string | undefined;
         parents?: string[] | undefined;
         retries?: number | undefined;
+        backoff?: {
+            factor?: number | undefined;
+            maxSeconds?: number | undefined;
+        } | undefined;
         rate_limits?: {
             units: string | number;
             key?: string | undefined;
             duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+            limit?: string | number | undefined;
             staticKey?: string | undefined;
             dynamicKey?: string | undefined;
-            limit?: string | number | undefined;
         }[] | undefined;
         worker_labels?: Record<string, string | number | {
             value: string | number;
@@ -372,10 +376,6 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
             comparator?: import("../protoc/workflows").WorkerLabelComparator | undefined;
             weight?: number | undefined;
         } | undefined> | undefined;
-        backoff?: {
-            factor?: number | undefined;
-            maxSeconds?: number | undefined;
-        } | undefined;
     }[];
     version?: string | undefined;
     timeout?: string | undefined;
@@ -393,13 +393,17 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
         timeout?: string | undefined;
         parents?: string[] | undefined;
         retries?: number | undefined;
+        backoff?: {
+            factor?: number | undefined;
+            maxSeconds?: number | undefined;
+        } | undefined;
         rate_limits?: {
             units: string | number;
             key?: string | undefined;
             duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+            limit?: string | number | undefined;
             staticKey?: string | undefined;
             dynamicKey?: string | undefined;
-            limit?: string | number | undefined;
         }[] | undefined;
         worker_labels?: Record<string, string | number | {
             value: string | number;
@@ -407,10 +411,6 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
             comparator?: import("../protoc/workflows").WorkerLabelComparator | undefined;
             weight?: number | undefined;
         } | undefined> | undefined;
-        backoff?: {
-            factor?: number | undefined;
-            maxSeconds?: number | undefined;
-        } | undefined;
     } | undefined;
 }, {
     description: string;
@@ -420,13 +420,17 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
         timeout?: string | undefined;
         parents?: string[] | undefined;
         retries?: number | undefined;
+        backoff?: {
+            factor?: number | undefined;
+            maxSeconds?: number | undefined;
+        } | undefined;
         rate_limits?: {
             units: string | number;
             key?: string | undefined;
             duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+            limit?: string | number | undefined;
             staticKey?: string | undefined;
             dynamicKey?: string | undefined;
-            limit?: string | number | undefined;
         }[] | undefined;
         worker_labels?: Record<string, string | number | {
             value: string | number;
@@ -434,10 +438,6 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
             comparator?: import("../protoc/workflows").WorkerLabelComparator | undefined;
             weight?: number | undefined;
         } | undefined> | undefined;
-        backoff?: {
-            factor?: number | undefined;
-            maxSeconds?: number | undefined;
-        } | undefined;
     }[];
     version?: string | undefined;
     timeout?: string | undefined;
@@ -455,13 +455,17 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
         timeout?: string | undefined;
         parents?: string[] | undefined;
         retries?: number | undefined;
+        backoff?: {
+            factor?: number | undefined;
+            maxSeconds?: number | undefined;
+        } | undefined;
         rate_limits?: {
             units: string | number;
             key?: string | undefined;
             duration?: import("../protoc/workflows").RateLimitDuration | undefined;
+            limit?: string | number | undefined;
             staticKey?: string | undefined;
             dynamicKey?: string | undefined;
-            limit?: string | number | undefined;
         }[] | undefined;
         worker_labels?: Record<string, string | number | {
             value: string | number;
@@ -469,10 +473,6 @@ export declare const CreateWorkflowSchema: z.ZodObject<{
             comparator?: import("../protoc/workflows").WorkerLabelComparator | undefined;
             weight?: number | undefined;
         } | undefined> | undefined;
-        backoff?: {
-            factor?: number | undefined;
-            maxSeconds?: number | undefined;
-        } | undefined;
     } | undefined;
 }>;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hatchet-dev/typescript-sdk",
-  "version": "1.15.2",
+  "version": "1.16.0",
   "description": "Background task orchestration & visibility for developers",
   "types": "dist/index.d.ts",
   "files": [
@@ -19,53 +19,44 @@
   "author": "",
   "license": "MIT",
   "devDependencies": {
-    "@tsd/typescript": "^5.8.2",
+    "@eslint/js": "^10.0.1",
+    "@tsd/typescript": "^5.9.3",
     "@types/jest": "^29.5.14",
     "@types/node": "^22.13.14",
-    "@typescript-eslint/eslint-plugin": "^7.0.0",
-    "@typescript-eslint/parser": "^7.0.0",
-    "autoprefixer": "^10.4.21",
+    "autoprefixer": "^10.4.27",
     "dotenv-cli": "^7.4.4",
-    "eslint": "^8.56.0",
-    "eslint-config-airbnb-typescript": "^18.0.0",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-config-standard": "^17.1.0",
+    "eslint": "^10.0.3",
+    "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^3.10.0",
-    "eslint-plugin-import": "^2.31.0",
-    "eslint-plugin-jest": "^28.11.0",
-    "eslint-plugin-n": "^16.6.2",
-    "eslint-plugin-prettier": "^5.2.5",
-    "eslint-plugin-promise": "^6.6.0",
-    "eslint-plugin-react": "^7.37.4",
-    "eslint-plugin-react-hooks": "^4.6.2",
-    "eslint-plugin-react-refresh": "^0.4.19",
-    "eslint-plugin-unused-imports": "^4.1.4",
-    "grpc-tools": "^1.13.0",
+    "eslint-plugin-prettier": "^5.5.5",
+    "eslint-plugin-unused-imports": "^4.4.1",
+    "grpc-tools": "^1.13.1",
     "jest": "^29.7.0",
     "jest-tsd": "^0.2.2",
     "pino": "^9.12.0",
-    "prettier": "^3.5.3",
+    "prettier": "^3.8.1",
     "resolve-tspaths": "^0.8.23",
-    "ts-jest": "^29.3.1",
+    "ts-jest": "^29.4.6",
     "ts-node": "^10.9.2",
-    "ts-proto": "^2.7.0",
+    "ts-proto": "^2.11.4",
     "typedoc": "^0.28.17",
-    "typedoc-plugin-markdown": "^4.6.0",
+    "typedoc-plugin-markdown": "^4.10.0",
     "typedoc-plugin-no-inherit": "^1.6.1",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.2",
+    "typescript-eslint": "^8.56.1"
   },
   "dependencies": {
-    "@bufbuild/protobuf": "^2.2.5",
-    "@types/qs": "^6.9.18",
+    "@bufbuild/protobuf": "^2.11.0",
+    "@types/qs": "^6.15.0",
     "abort-controller-x": "^0.4.3",
     "axios": "^1.13.5",
     "long": "^5.3.1",
-    "nice-grpc": "^2.1.12",
+    "nice-grpc": "^2.1.14",
     "nice-grpc-common": "^2.0.2",
     "protobufjs": "^7.4.0",
     "qs": "^6.14.2",
-    "semver": "^7.7.1",
-    "yaml": "^2.7.1",
+    "semver": "^7.7.4",
+    "yaml": "^2.8.2",
     "zod": "^3.24.2",
     "zod-to-json-schema": "^3.24.1"
   },

package/util/abort-error.d.ts

@@ -1,4 +1,8 @@
-export declare function createAbortError(message?: string): Error;
+export declare class AbortError extends Error {
+    readonly code = "ABORT_ERR";
+    constructor(message?: string);
+}
+export declare function createAbortError(message?: string): AbortError;
 export declare function isAbortError(err: unknown): err is Error;
 /**
  * Helper to be used inside broad `catch` blocks so cancellation isn't accidentally swallowed.

package/util/abort-error.js

@@ -1,17 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbortError = void 0;
 exports.createAbortError = createAbortError;
 exports.isAbortError = isAbortError;
 exports.rethrowIfAborted = rethrowIfAborted;
 exports.throwIfAborted = throwIfAborted;
+class AbortError extends Error {
+    constructor(message = 'Operation aborted') {
+        super(message);
+        this.code = 'ABORT_ERR';
+        this.name = 'AbortError';
+    }
+}
+exports.AbortError = AbortError;
 function createAbortError(message = 'Operation aborted') {
-    const err = new Error(message);
-    err.name = 'AbortError';
-    err.code = 'ABORT_ERR';
-    return err;
+    return new AbortError(message);
 }
 function isAbortError(err) {
-    return err instanceof Error && (err.name === 'AbortError' || err.code === 'ABORT_ERR');
+    if (err instanceof AbortError) {
+        return true;
+    }
+    return (err instanceof Error &&
+        (err.name === 'AbortError' || err.code === 'ABORT_ERR'));
 }
 /**
  * Helper to be used inside broad `catch` blocks so cancellation isn't accidentally swallowed.

package/util/config-loader/config-loader.js

@@ -74,7 +74,7 @@ class ConfigLoader {
             apiUrl =
                 (_x = (_w = (_v = override === null || override === void 0 ? void 0 : override.api_url) !== null && _v !== void 0 ? _v : yaml === null || yaml === void 0 ? void 0 : yaml.api_url) !== null && _w !== void 0 ? _w : this.env('HATCHET_CLIENT_API_URL')) !== null && _x !== void 0 ? _x : addresses.serverUrl;
         }
-        catch (e) {
+        catch (_9) {
             grpcBroadcastAddress =
                 (_z = (_y = override === null || override === void 0 ? void 0 : override.host_port) !== null && _y !== void 0 ? _y : yaml === null || yaml === void 0 ? void 0 : yaml.host_port) !== null && _z !== void 0 ? _z : this.env('HATCHET_CLIENT_HOST_PORT');
             apiUrl = (_1 = (_0 = override === null || override === void 0 ? void 0 : override.api_url) !== null && _0 !== void 0 ? _0 : yaml === null || yaml === void 0 ? void 0 : yaml.api_url) !== null && _1 !== void 0 ? _1 : this.env('HATCHET_CLIENT_API_URL');
@@ -119,10 +119,11 @@ class ConfigLoader {
             return config;
         }
         catch (e) {
-            if (!path)
+            if (!path) {
                 return undefined;
+            }
             if (e instanceof zod_1.z.ZodError) {
-                throw new Error(`Invalid yaml config: ${e.message}`);
+                throw new Error(`Invalid yaml config: ${e.message}`, { cause: e });
             }
             throw e;
         }

package/util/config-loader/token.js

@@ -2,12 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTenantIdFromJWT = getTenantIdFromJWT;
 exports.getAddressesFromJWT = getAddressesFromJWT;
+const parse_1 = require("../parse");
 function getTenantIdFromJWT(token) {
     const claims = extractClaimsFromJWT(token);
+    if (claims.sub === undefined) {
+        throw new Error('Invalid token: missing sub');
+    }
     return claims.sub;
 }
 function getAddressesFromJWT(token) {
     const claims = extractClaimsFromJWT(token);
+    if (claims.server_url === undefined || claims.grpc_broadcast_address === undefined) {
+        throw new Error('Invalid token: missing server_url or grpc_broadcast_address');
+    }
     return {
         serverUrl: claims.server_url,
         grpcBroadcastAddress: claims.grpc_broadcast_address,
@@ -18,8 +25,8 @@ function extractClaimsFromJWT(token) {
     if (parts.length !== 3) {
         throw new Error('Invalid token format');
     }
-    const claimsPart = parts[1];
+    const [_, claimsPart] = parts;
     const claimsData = atob(claimsPart.replace(/-/g, '+').replace(/_/g, '/'));
-    const claims = JSON.parse(claimsData);
+    const claims = (0, parse_1.parseJSON)(claimsData);
     return claims;
 }

package/util/errors/hatchet-error.d.ts

@@ -1,4 +1,12 @@
+/** Returns a string message from an unknown value (e.g. from a catch block). */
+export declare function getErrorMessage(e: unknown): string;
 declare class HatchetError extends Error {
-    constructor(message: string);
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
 }
+export declare function toHatchetError(e: unknown, defaultMessageOrOptions?: string | {
+    defaultMessage?: string;
+    prefix?: string;
+}): HatchetError;
 export default HatchetError;

package/util/errors/hatchet-error.js

@@ -1,9 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getErrorMessage = getErrorMessage;
+exports.toHatchetError = toHatchetError;
+/** Returns a string message from an unknown value (e.g. from a catch block). */
+function getErrorMessage(e) {
+    return e instanceof Error ? e.message : String(e);
+}
 class HatchetError extends Error {
-    constructor(message) {
-        super(message);
+    constructor(message, options) {
+        super(message, options);
         this.name = 'HatchetError';
     }
 }
+function toHatchetError(e, defaultMessageOrOptions = 'An error occurred') {
+    var _a;
+    if (e instanceof HatchetError) {
+        return e;
+    }
+    const opts = typeof defaultMessageOrOptions === 'string'
+        ? { defaultMessage: defaultMessageOrOptions }
+        : defaultMessageOrOptions;
+    const defaultMessage = (_a = opts.defaultMessage) !== null && _a !== void 0 ? _a : 'An error occurred';
+    let message = getErrorMessage(e) || defaultMessage;
+    if (opts.prefix) {
+        message = opts.prefix + message;
+    }
+    return new HatchetError(message, { cause: e });
+}
 exports.default = HatchetError;

package/util/grpc-error.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns the gRPC status code from an unknown value (e.g. from a catch block).
+ * Used for checking Status.CANCELLED, Status.UNAVAILABLE, etc.
+ */
+export declare function getGrpcErrorCode(e: unknown): number | undefined;
+/**
+ * Returns the gRPC error details string from an unknown value (e.g. from a catch block).
+ */
+export declare function getGrpcErrorDetails(e: unknown): string | undefined;

package/util/grpc-error.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGrpcErrorCode = getGrpcErrorCode;
+exports.getGrpcErrorDetails = getGrpcErrorDetails;
+/**
+ * Returns the gRPC status code from an unknown value (e.g. from a catch block).
+ * Used for checking Status.CANCELLED, Status.UNAVAILABLE, etc.
+ */
+function getGrpcErrorCode(e) {
+    if (e != null && typeof e === 'object' && 'code' in e) {
+        const { code } = e;
+        return typeof code === 'number' ? code : undefined;
+    }
+    return undefined;
+}
+/**
+ * Returns the gRPC error details string from an unknown value (e.g. from a catch block).
+ */
+function getGrpcErrorDetails(e) {
+    if (e != null && typeof e === 'object' && 'details' in e) {
+        const { details } = e;
+        return typeof details === 'string' ? details : undefined;
+    }
+    return undefined;
+}

package/util/hatchet-promise/hatchet-promise.d.ts

@@ -1,5 +1,9 @@
+/** Canonical reasons when cancelling a HatchetPromise (e.g. worker shutdown). */
+export declare enum CancellationReason {
+    CANCELLED_BY_WORKER = "Cancelled by worker"
+}
 declare class HatchetPromise<T> {
-    cancel: (reason?: any) => void;
+    cancel: (reason?: CancellationReason) => void;
     promise: Promise<T>;
     /**
      * The original (non-cancelable) promise passed to the constructor.

package/util/hatchet-promise/hatchet-promise.js

@@ -1,8 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancellationReason = void 0;
+/** Canonical reasons when cancelling a HatchetPromise (e.g. worker shutdown). */
+var CancellationReason;
+(function (CancellationReason) {
+    CancellationReason["CANCELLED_BY_WORKER"] = "Cancelled by worker";
+})(CancellationReason || (exports.CancellationReason = CancellationReason = {}));
 class HatchetPromise {
     constructor(promise) {
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
         this.cancel = (_reason) => { };
         this.inner = Promise.resolve(promise);
         this.promise = new Promise((resolve, reject) => {

package/util/logger/logger.js

@@ -4,7 +4,6 @@ exports.LogLevelEnum = exports.Logger = void 0;
 class Logger {
 }
 exports.Logger = Logger;
-// eslint-disable-next-line no-shadow
 var LogLevelEnum;
 (function (LogLevelEnum) {
     LogLevelEnum[LogLevelEnum["OFF"] = -1] = "OFF";

package/util/parse.d.ts

@@ -1 +1 @@
-export declare function parseJSON(json: string): any;
+export declare function parseJSON<T = any>(json: string): T;