Adds node utils

Author: danieldelcore

packages/utils/src/index.ts

@@ -1,4 +1,5 @@
 export * from './imports';
+export * from './nodes';
 export * from './jsx';
 export * from './motions';
 export * from './comments';

packages/utils/src/nodes.ts

@@ -0,0 +1,16 @@
+import { ASTNode } from 'jscodeshift';
+
+/**
+ * The isNodeOfType function uses generics to check if a node of type ASTNode is of a specified type.
+ * If the check passes, the type of node is narrowed to the expected type, ensuring that the returned type of the function is always correct.
+ *
+ * Example:
+ *
+ * ```ts
+ * const isImportSpecifier = isNodeOfType(node, 'ImportSpecifier');
+ * ```
+ */
+export const isNodeOfType = <Expected extends ASTNode>(
+  node: ASTNode,
+  type: Expected['type'],
+): node is Expected => node.type === type;

website/docs/api/codeshift-utils.mdx

@@ -15,6 +15,25 @@ However, it is also available for use outside of this project and compatible wit
 
 `npm install --save-dev @codeshift/utils` or `yarn add -D @codeshift/utils`
 
+## Nodes
+
+### `isNodeOfType`
+
+`isNodeOfType(node, type)`
+
+The `isNodeOfType` function uses generics to check if a node of type `ASTNode` is of a specified type.
+If the check passes, the type of node is narrowed to the expected type, ensuring that the returned type of the function is always correct.
+
+**Returns**
+
+`boolean`
+
+**Example**
+
+```jsx
+const isImportSpecifier = isNodeOfType(node, 'ImportSpecifier');
+```
+
 ## Imports
 
 ### `hasImportDeclaration`