@abinnovision/nestjs-hatchet 0.5.0 → 0.6.0-beta.1

package/dist/events/event-definition.cjs

@@ -24,6 +24,24 @@
 		} });
 	}
 	/**
+	* Type guard: casts the context input to this event's schema output type
+	* without requiring the event marker to be present.
+	*
+	* Use this for externally sourced events that arrive without the marker
+	* injected by Client.emit(). Schema validation still runs and throws if
+	* the payload is malformed.
+	*
+	* @param ctx The context to check (TaskCtx, WorkflowCtx, HelperCtx, or SDK Context).
+	* @returns True if the context input is a non-null object that passes schema validation.
+	* @throws Error if the payload fails schema validation.
+	*/ cast(ctx) {
+		if (typeof ctx.input !== "object" || ctx.input === null) return false;
+		const result = this.schema["~standard"].validate(ctx.input);
+		if (result instanceof Promise) throw new Error(`Event '${this.name}' schema validation must be synchronous. Use a sync schema.`);
+		if ("issues" in result && result.issues) throw new Error(`Event '${this.name}' payload is malformed: ${JSON.stringify(result.issues)}`);
+		return true;
+	}
+	/**
 	* Type guard: checks if the context was triggered by this event.
 	* Validates the input against the event schema and throws if malformed.
 	*
@@ -32,10 +50,7 @@
 	* @throws Error if the event marker matches but the payload fails schema validation.
 	*/ isCtx(ctx) {
 		if (typeof ctx.input !== "object" || ctx.input === null || !("__event_name" in ctx.input) || ctx.input["__event_name"] !== this.name) return false;
-		const result = this.schema["~standard"].validate(ctx.input);
-		if (result instanceof Promise) throw new Error(`Event '${this.name}' schema validation must be synchronous. Use a sync schema.`);
-		if ("issues" in result && result.issues) throw new Error(`Event '${this.name}' payload is malformed: ${JSON.stringify(result.issues)}`);
-		return true;
+		return this.cast(ctx);
 	}
 };
 /**

package/dist/events/event-definition.d.ts

@@ -23,6 +23,23 @@ export declare class EventDefinition<TName extends string, TSchema extends Stand
         output: StandardSchemaV1.InferOutput<TSchema>;
     };
     constructor(name: TName, schema: TSchema);
+    /**
+     * Type guard: casts the context input to this event's schema output type
+     * without requiring the event marker to be present.
+     *
+     * Use this for externally sourced events that arrive without the marker
+     * injected by Client.emit(). Schema validation still runs and throws if
+     * the payload is malformed.
+     *
+     * @param ctx The context to check (TaskCtx, WorkflowCtx, HelperCtx, or SDK Context).
+     * @returns True if the context input is a non-null object that passes schema validation.
+     * @throws Error if the payload fails schema validation.
+     */
+    cast<C extends {
+        input: unknown;
+    }>(ctx: C): ctx is C & {
+        input: StandardSchemaV1.InferOutput<TSchema>;
+    };
     /**
      * Type guard: checks if the context was triggered by this event.
      * Validates the input against the event schema and throws if malformed.

package/dist/events/event-definition.mjs

@@ -24,6 +24,24 @@
 		} });
 	}
 	/**
+	* Type guard: casts the context input to this event's schema output type
+	* without requiring the event marker to be present.
+	*
+	* Use this for externally sourced events that arrive without the marker
+	* injected by Client.emit(). Schema validation still runs and throws if
+	* the payload is malformed.
+	*
+	* @param ctx The context to check (TaskCtx, WorkflowCtx, HelperCtx, or SDK Context).
+	* @returns True if the context input is a non-null object that passes schema validation.
+	* @throws Error if the payload fails schema validation.
+	*/ cast(ctx) {
+		if (typeof ctx.input !== "object" || ctx.input === null) return false;
+		const result = this.schema["~standard"].validate(ctx.input);
+		if (result instanceof Promise) throw new Error(`Event '${this.name}' schema validation must be synchronous. Use a sync schema.`);
+		if ("issues" in result && result.issues) throw new Error(`Event '${this.name}' payload is malformed: ${JSON.stringify(result.issues)}`);
+		return true;
+	}
+	/**
 	* Type guard: checks if the context was triggered by this event.
 	* Validates the input against the event schema and throws if malformed.
 	*
@@ -32,10 +50,7 @@
 	* @throws Error if the event marker matches but the payload fails schema validation.
 	*/ isCtx(ctx) {
 		if (typeof ctx.input !== "object" || ctx.input === null || !("__event_name" in ctx.input) || ctx.input["__event_name"] !== this.name) return false;
-		const result = this.schema["~standard"].validate(ctx.input);
-		if (result instanceof Promise) throw new Error(`Event '${this.name}' schema validation must be synchronous. Use a sync schema.`);
-		if ("issues" in result && result.issues) throw new Error(`Event '${this.name}' payload is malformed: ${JSON.stringify(result.issues)}`);
-		return true;
+		return this.cast(ctx);
 	}
 };
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@abinnovision/nestjs-hatchet",
-  "version": "0.5.0",
+  "version": "0.6.0-beta.1",
   "keywords": [
     "nestjs",
     "hatchet"