rclnodejs 1.7.0 → 1.8.0

package/types/errors.d.ts

@@ -149,6 +149,55 @@ declare module 'rclnodejs' {
     );
   }
 
+  /**
+   * A single validation issue found during message validation
+   */
+  export interface MessageValidationIssue {
+    /** Field path where issue occurred (e.g., 'linear.x' or 'data') */
+    field: string;
+    /** Problem type (UNKNOWN_FIELD, TYPE_MISMATCH, etc.) */
+    problem: string;
+    /** Expected type or value */
+    expected?: string;
+    /** Actual value received */
+    received?: any;
+  }
+
+  /**
+   * Message validation error for ROS message structure/type issues
+   */
+  export class MessageValidationError extends ValidationError {
+    /** The ROS message type (e.g., 'std_msgs/msg/String') */
+    messageType: string;
+    /** Array of validation issues found */
+    issues: MessageValidationIssue[];
+
+    /**
+     * @param messageType - The ROS message type
+     * @param issues - Array of validation issues
+     * @param options - Additional options
+     */
+    constructor(
+      messageType: string,
+      issues: MessageValidationIssue[],
+      options?: RclNodeErrorOptions
+    );
+
+    /**
+     * Get issues filtered by problem type
+     * @param problemType - Problem type to filter by
+     * @returns Filtered issues
+     */
+    getIssuesByType(problemType: string): MessageValidationIssue[];
+
+    /**
+     * Check if a specific field has validation issues
+     * @param fieldPath - Field path to check
+     * @returns True if field has issues
+     */
+    hasFieldIssue(fieldPath: string): boolean;
+  }
+
   /**
    * ROS name validation error (topics, nodes, services)
    */

package/types/index.d.ts

@@ -1,4 +1,7 @@
 /// <reference path="./base.d.ts" />
+/// <reference path="./clock_event.d.ts" />
+/// <reference path="./clock_change.d.ts" />
+/// <reference path="./message_validation.d.ts" />
 
 import { ChildProcess } from 'child_process';
 
@@ -58,6 +61,13 @@ declare module 'rclnodejs' {
    */
   function init(context?: Context, argv?: string[]): Promise<void>;
 
+  /**
+   * Remove ROS-specific arguments from the given argument list.
+   * @param argv - The argument list to process.
+   * @returns The argument list with ROS arguments removed.
+   */
+  function removeROSArgs(argv: string[]): string[];
+
   /**
    * Start detection and processing of units of work.
    *