feat: add multisheet extraction to JSON extractor (#698)

.changeset/slow-bottles-roll.md

@@ -0,0 +1,5 @@
+---
+'@flatfile/plugin-json-extractor': minor
+---
+
+This release introduces multi-sheet extraction to the JSON extractor plugin.

flatfilers/sandbox/src/index.ts

@@ -1,8 +1,10 @@
 import type { FlatfileListener } from '@flatfile/listener'
 import { exportDelimitedZip } from '@flatfile/plugin-export-delimited-zip'
+import { JSONExtractor } from '@flatfile/plugin-json-extractor'
 import { configureSpace } from '@flatfile/plugin-space-configure'
 
 export default async function (listener: FlatfileListener) {
+  listener.use(JSONExtractor())
   listener.use(
     exportDelimitedZip({
       job: 'export-delimited-zip',

plugins/json-extractor/ref/test-multisheet.json

@@ -0,0 +1,59 @@
+{
+  "contacts": [
+    {
+      "First Name": "Tony",
+      "Last Name": "Lamb",
+      "Email": "[email protected]",
+      "Address": {
+        "Street": "123 Main Street",
+        "City": "Springfield",
+        "State": "ST",
+        "Zip": "12345",
+        "Coordinates": {
+          "Latitude": "40.7128° N",
+          "Longitude": "74.0060° W"
+        }
+      }
+    },
+    {
+      "First Name": "Christian",
+      "Last Name": "Ramos",
+      "Email": "[email protected]",
+      "Address": {
+        "Street": "456 Elm Street",
+        "City": "Greenville",
+        "State": "GT",
+        "Zip": "67890",
+        "Coordinates": {
+          "Latitude": "40.7128° N",
+          "Longitude": "74.0060° W"
+        }
+      }
+    },
+    {
+      "First Name": "Frederick",
+      "Last Name": "Boyd",
+      "Email": "[email protected]",
+      "Address": {
+        "Street": "789 Oak Street",
+        "City": "Rivertown",
+        "State": "RT",
+        "Zip": "10112",
+        "Coordinates": {
+          "Latitude": "40.7128° N",
+          "Longitude": "74.0060° W"
+        }
+      }
+    }
+  ],
+  "orders": [
+    {
+      "ID": "1234",
+      "Amount": 5678
+    },
+    {
+      "ID": "9876",
+      "Amount": 5432
+    }
+  ]
+}

plugins/json-extractor/src/index.ts

@@ -1,11 +1,13 @@
 import { Extractor } from '@flatfile/util-extractor'
 import { parseBuffer } from './parser'
 
-export const JSONExtractor = (options?: {
+export interface PluginOptions {
   chunkSize?: number
   parallel?: number
   debug?: boolean
-}) => {
+}
+
+export const JSONExtractor = (options?: PluginOptions) => {
   return Extractor('.json', 'json', parseBuffer, options)
 }