fix(plugins/plugin-client-common): adopt jq syntax for guidebook json filters

i.e. `.foo` instead of what we had before `foo`.

This PR also allows for a deeper path project `.foo.bar`.

This PR also allows exclusion after filtering, so that you can project out a subtree, and then exclude fields from that subtree.

Author: starpit

plugins/plugin-client-common/src/components/Content/Markdown/components/code/filter.ts

@@ -28,39 +28,50 @@ function dump(field: any, language: string): string {
   }
 }
 
-function filterIn(json: Record<string, any>, include: string, language: string) {
-  return dump(json[include], language)
+function project(json: Record<string, any>, path: string[], idx = 0) {
+  const field = json[path[idx]]
+  if (idx === path.length - 1) {
+    return field
+  } else {
+    return project(field, path, idx + 1)
+  }
+}
+
+function asFilter(filter: string | string[]): string[][] {
+  return (typeof filter === 'string' ? [filter] : filter).map(filt => filt.split(/\./).slice(1))
 }
 
-function filterOut(json: Record<string, any>, exclude: string[], language: string) {
-  exclude.forEach(key => {
-    delete json[key]
-  })
-  return dump(json, language)
+function filterIn(json: Record<string, any>, include: string[]) {
+  return project(json, asFilter(include)[0])
 }
 
-function asFilter(filter: string | string[]): string[] {
-  if (typeof filter === 'string') {
-    return [filter]
+function remove(json: Record<string, any>, path: string[], idx = 0) {
+  if (idx === path.length - 1) {
+    delete json[path[idx]]
   } else {
-    return filter
+    return remove(json[path[idx]], path, idx + 1)
   }
 }
 
+function filterOut(json: Record<string, any>, exclude: string[][]) {
+  exclude.forEach(path => remove(json, path))
+  return json
+}
+
 export default function bodyAndLanguage(body: string, language: string, attributes: Record<string, any>) {
   if (language === 'json' && (attributes.include || attributes.exclude || attributes.language)) {
     try {
       const json = JSON.parse(body)
 
       const languageForView =
-        attributes.language || (attributes.languageFrom && json[attributes.languageFrom]) || language
+        attributes.language ||
+        (attributes.languageFrom && project(json, asFilter(attributes.languageFrom)[0])) ||
+        language
+
+      const json2 = attributes.include ? filterIn(json, attributes.include) : json
+      const json3 = attributes.exclude ? filterOut(json2, asFilter(attributes.exclude)) : json2
 
-      const bodyForView =
-        (attributes.include
-          ? filterIn(json, attributes.include, languageForView)
-          : attributes.exclude
-          ? filterOut(json, asFilter(attributes.exclude), languageForView)
-          : body) || ''
+      const bodyForView = dump(json3, languageForView)
 
       return { bodyForView, languageForView }
     } catch (err) {