feat: provide the filledDataToObject util function

src/__tests__/parser.test.ts

@@ -4,7 +4,11 @@ import { JWT } from 'google-auth-library';
 import { GoogleSpreadsheet } from 'google-spreadsheet';
 import PublicGoogleSheetsParser from 'public-google-sheets-parser';
 
-import { publicGoogleSheetsParser, googleSpreadsheet } from '../parser';
+import {
+  publicGoogleSheetsParser,
+  googleSpreadsheet,
+  filledDataToObject,
+} from '../parser';
 
 const expected = {
   click_conversation_data: {
@@ -100,3 +104,63 @@ describe.skip('GoogleSpreadsheet', () => {
     expect(parsed).toEqual(expected);
   });
 });
+
+describe('filledDataToObject', () => {
+  it('Common forms', () => {
+    const filledData = [
+      {
+        Key: 'click_conversation_data',
+        Property: 'conversation_id',
+        Type: 'string',
+      },
+      {
+        Key: 'click_conversation_data',
+        Property: 'created_at',
+        Type: 'Date',
+      },
+      {
+        Key: 'click_conversation_data',
+        Property: 'agent_type',
+        Type: 'string',
+      },
+      {
+        Key: 'click_conversation_data',
+        Property: 'status',
+        Type: 'StatusEnum',
+      },
+      {
+        Key: 'click_conversation_data',
+        Property: 'generate_position',
+        Type: "conversation' | 'playground'",
+      },
+      {
+        Key: 'click_message_feedback_button',
+        Property: 'conversation_id',
+        Type: 'string',
+      },
+      {
+        Key: 'click_message_feedback_button',
+        Property: 'message_id',
+        Type: 'string',
+      },
+      {
+        Key: 'click_message_feedback_button',
+        Property: 'generate_position',
+        Type: '"conversation" | "playground"',
+      },
+      {
+        Key: 'click_message_feedback_button',
+        Property: 'my_test',
+        Type: "string | 'string'",
+      },
+    ];
+
+    const transformed = filledDataToObject(
+      filledData,
+      ['Key', 'Property'],
+      'Type',
+    );
+
+    expect(transformed).toEqual(expected);
+  });
+});

src/parser/README.md

@@ -201,3 +201,49 @@ declare global {
   }
 }
 ```
+
+### `parser/filledDataToObject` Utility function
+
+This utility function takes `FilledData` type data and converts it to an `object` type. It can be useful when creating parsers.
+
+```ts
+import { filledDataToObject } from 'google-spreadsheet-dts/parser';
+
+filledDataToObject(
+  [
+    { Key: 'key1', Property: 'property1', Type: 'type1' },
+    { Key: 'key2', Property: 'property2', Type: 'type2', Other: 'other' },
+    { Key: 'key3', Property: 'property3', Type: 'MyType' },
+  ],
+  ['Key', 'Property'],
+  'Type',
+);
+
+// Returns
+({
+  key1: {
+    property1: 'type1',
+  }
+  key2: {
+    property2: 'type2',
+  }
+  key3: {
+    property3: 'MyType',
+  }
+})
+```
+
+**Type definition:**
+
+```ts
+type FilledData = Record<string, string>[];
+type Result = {
+  [key: string]: string | Result;
+};
+
+function filledDataToObject(
+  filledData: FilledData,
+  path: string[],
+  typeName: string,
+): Result;
+```

src/parser/index.ts

@@ -1,2 +1,5 @@
 export { publicGoogleSheetsParser } from './publicGoogleSheetsParser';
 export { googleSpreadsheet } from './googleSpreadsheet';
+
+// Utils
+export { filledDataToObject } from './utils/filledDataToObject';