@real-router/validation-plugin 0.6.1 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-router/validation-plugin",
-  "version": "0.6.1",
+  "version": "0.7.1",
   "type": "commonjs",
   "description": "Route validation plugin with type guards and parameter validation",
   "main": "./dist/cjs/index.js",
@@ -44,15 +44,15 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@real-router/core": "^0.50.0",
+    "@real-router/core": "^0.52.0",
     "@real-router/logger": "^0.3.0"
   },
   "peerDependencies": {
-    "@real-router/core": "^0.50.0"
+    "@real-router/core": "^0.52.0"
   },
   "devDependencies": {
     "route-tree": "^0.3.4",
-    "type-guards": "^0.4.8"
+    "type-guards": "^0.4.9"
   },
   "scripts": {
     "test": "vitest",

package/src/validationPlugin.ts

@@ -32,6 +32,7 @@ import {
 import {
   validateNavigateArgs,
   validateNavigateToDefaultArgs,
+  validateNavigateToStateArgs,
   validateNavigationOptions,
   validateNavigateParams,
   validateStartArgs,
@@ -253,6 +254,7 @@ function buildValidatorObject(ctx: RouterInternals): RouterValidator {
     navigation: {
       validateNavigateArgs,
       validateNavigateToDefaultArgs,
+      validateNavigateToStateArgs,
       validateNavigationOptions,
       validateParams: validateNavigateParams,
       validateStartArgs,

package/src/validators/navigation.ts

@@ -1,6 +1,11 @@
 // packages/validation-plugin/src/validators/navigation.ts
 
-import { getTypeDescription, isNavigationOptions, isParams } from "type-guards";
+import {
+  getTypeDescription,
+  isNavigationOptions,
+  isParams,
+  isString,
+} from "type-guards";
 
 import type { NavigationOptions } from "@real-router/core";
 
@@ -20,6 +25,32 @@ export function validateNavigateToDefaultArgs(opts: unknown): void {
   }
 }
 
+export function validateNavigateToStateArgs(state: unknown): void {
+  if (typeof state !== "object" || state === null) {
+    throw new TypeError(
+      `[router.navigateToState] Invalid state: ${getTypeDescription(state)}. Expected State object.`,
+    );
+  }
+
+  const candidate = state as { name: unknown; params: unknown; path: unknown };
+
+  if (!isString(candidate.name)) {
+    throw new TypeError(
+      `[router.navigateToState] Invalid state.name: ${getTypeDescription(candidate.name)}. Expected string.`,
+    );
+  }
+  if (!isParams(candidate.params)) {
+    throw new TypeError(
+      `[router.navigateToState] Invalid state.params: ${getTypeDescription(candidate.params)}. Expected plain object.`,
+    );
+  }
+  if (!isString(candidate.path)) {
+    throw new TypeError(
+      `[router.navigateToState] Invalid state.path: ${getTypeDescription(candidate.path)}. Expected string.`,
+    );
+  }
+}
+
 export function validateNavigationOptions(
   opts: unknown,
   methodName: string,