@wooksjs/event-wf 0.7.16 → 0.7.17

package/dist/index.cjs

@@ -451,6 +451,11 @@ var WooksWf = class extends wooks.WooksAdapterBase {
 	/** Registers a workflow step with the given id and handler. */
 	step(id, opts) {
 		const step = (0, _prostojs_wf.createStep)(id, opts);
+		const stepIdNorm = `/${id}`.replace(/^\/+/u, "/");
+		if (this.wooks.getRouter().lookup("WF_STEP", stepIdNorm)?.route?.handlers.length) {
+			if (this.opts?.strictStepIds) throw new Error(`WF step "${id}" already registered. Step ids must be unique (strictStepIds enabled).`);
+			this.logger.warn(`WF step "${id}" registered more than once — the first registration wins. In tests, reset the shared router with clearGlobalWooks() in beforeEach().`);
+		}
 		return this.on("WF_STEP", id, () => step);
 	}
 	/** Registers a workflow flow schema with the given id. */

package/dist/index.d.ts

@@ -323,6 +323,17 @@ interface TWooksWfOptions {
     logger?: TConsoleBase;
     eventOptions?: EventContextOptions;
     router?: TWooksOptions['router'];
+    /**
+     * When `true`, registering a `WF_STEP` id that is already registered throws
+     * instead of warning. Useful in CI to fail loudly on step-id collisions.
+     * Mirrors the router's `disableDuplicatePath`.
+     *
+     * Default (`false`) keeps the permissive behavior — a duplicate id logs a
+     * warning and the **first** registration wins — so HMR / dev-restart flows
+     * that re-register steps (and reset the shared router via `clearGlobalWooks()`)
+     * are not broken.
+     */
+    strictStepIds?: boolean;
 }
 /** Options for {@link WooksWf.start} and {@link WooksWf.resume}. */
 interface TWfRunOptions<I = unknown, T = unknown, IR = unknown> {

package/dist/index.mjs

@@ -450,6 +450,11 @@ var WooksWf = class extends WooksAdapterBase {
 	/** Registers a workflow step with the given id and handler. */
 	step(id, opts) {
 		const step = createStep(id, opts);
+		const stepIdNorm = `/${id}`.replace(/^\/+/u, "/");
+		if (this.wooks.getRouter().lookup("WF_STEP", stepIdNorm)?.route?.handlers.length) {
+			if (this.opts?.strictStepIds) throw new Error(`WF step "${id}" already registered. Step ids must be unique (strictStepIds enabled).`);
+			this.logger.warn(`WF step "${id}" registered more than once — the first registration wins. In tests, reset the shared router with clearGlobalWooks() in beforeEach().`);
+		}
 		return this.on("WF_STEP", id, () => step);
 	}
 	/** Registers a workflow flow schema with the given id. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wooksjs/event-wf",
-  "version": "0.7.16",
+  "version": "0.7.17",
   "description": "@wooksjs/event-wf",
   "keywords": [
     "app",
@@ -42,17 +42,17 @@
   "devDependencies": {
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@wooksjs/event-core": "^0.7.16",
-    "@wooksjs/event-http": "^0.7.16",
-    "wooks": "^0.7.16",
-    "@wooksjs/http-body": "^0.7.16"
+    "@wooksjs/event-core": "^0.7.17",
+    "wooks": "^0.7.17",
+    "@wooksjs/http-body": "^0.7.17",
+    "@wooksjs/event-http": "^0.7.17"
   },
   "peerDependencies": {
     "@prostojs/logger": "^0.4.3",
-    "@wooksjs/event-core": "^0.7.16",
-    "@wooksjs/http-body": "^0.7.16",
-    "wooks": "^0.7.16",
-    "@wooksjs/event-http": "^0.7.16"
+    "@wooksjs/event-http": "^0.7.17",
+    "@wooksjs/http-body": "^0.7.17",
+    "@wooksjs/event-core": "^0.7.17",
+    "wooks": "^0.7.17"
   },
   "peerDependenciesMeta": {
     "@wooksjs/event-http": {