Add --translate-path option to fetch-entity script (#1798)

Author: cvalarida

scripts/fetch-entity/README.md

@@ -16,6 +16,12 @@ yarn fetch-entity --help
 
 ## Examples
 
+### Resolve a path to its resource type and UUID
+
+```bash
+yarn fetch-entity --translate-path /housing-assistance/home-loans/how-to-request-coe-esp/
+```
+
 ### Fetch a single resource by UUID
 
 ```bash

scripts/fetch-entity/src/index.ts

@@ -2,15 +2,20 @@
 import util from 'util'
 import { program } from 'commander'
 import { fetchEntity } from './fetchEntity'
+import { translatePath } from './translatePath'
 
 program
   .description(
     'Fetch a resource from the Drupal JSON:API. Useful for grabbing mock data.'
   )
-  .argument('<resource-type>', 'The resource type to fetch')
+  .argument('[resource-type]', 'The resource type to fetch')
   .argument(
     '[uuid]',
-    'The ID of the resource to fetch (optional if using --collection)'
+    'The ID of the resource to fetch (optional if using --collection or --translate-path)'
+  )
+  .option(
+    '--translate-path <path>',
+    'Resolve a Drupal path to its resource type and UUID via translatePath'
   )
   .option(
     '--include <includes...>',
@@ -28,6 +33,29 @@ program
     '1'
   )
   .action(async (resourceType, uuid, options) => {
+    if (options.translatePath) {
+      const pathInfo = await translatePath(options.translatePath)
+
+      if (options.json) {
+        console.log(JSON.stringify(pathInfo, null, 2))
+      } else {
+        console.log(
+          util.inspect(pathInfo, {
+            depth: null,
+            colors: process.stdout.isTTY,
+          })
+        )
+      }
+      return
+    }
+
+    if (!resourceType || !uuid) {
+      console.error(
+        'Error: [resource-type] and [uuid] are required unless --translate-path is provided'
+      )
+      process.exit(1)
+    }
+
     const data = await fetchEntity(resourceType, uuid, options)
     // NOTE: There may be a thing we can do to just _check_ for circular
     // references. console.log(util.format('%j', data)) will output just

scripts/fetch-entity/src/translatePath.ts

@@ -0,0 +1,17 @@
+import { getEnvFileVars } from './getEnvVars'
+
+process.env = {
+  ...process.env,
+  ...getEnvFileVars(),
+}
+
+const { drupalClient } = await import('../../../src/lib/drupal/drupalClient')
+
+export async function translatePath(path: string) {
+  try {
+    return await drupalClient.translatePath(path)
+  } catch (e) {
+    console.error(`Path not found: ${path}`)
+    process.exit(1)
+  }
+}