[DONT MERGE] POC: add filtering functionality to LlmoController.

docs/openapi/llmo-api.yaml

@@ -33,6 +33,39 @@ llmo-sheet-data:
         $ref: './responses.yaml#/500'
     security:
       - api_key: [ ]
+  post:
+    tags:
+      - llmo
+    summary: Query LLMO sheet data with filters, exclusions, and grouping
+    description: |
+      Retrieves and processes data from the external LLMO data endpoint for a specific site with advanced querying capabilities.
+      This endpoint allows filtering data with case-insensitive exact matching, excluding specific fields from the response,
+      and grouping data by specified attributes. The endpoint fetches all available data (up to 1M records) to apply
+      the query operations effectively.
+    operationId: queryLlmoSheetData
+    requestBody:
+      required: false
+      content:
+        application/json:
+          schema:
+            $ref: './schemas.yaml#/LlmoSheetDataQuery'
+    responses:
+      '200':
+        description: LLMO sheet data queried and processed successfully
+        content:
+          application/json:
+            schema:
+              type: object
+              description: The processed data returned from the external LLMO endpoint after applying filters, exclusions, and grouping
+              additionalProperties: true
+      '400':
+        $ref: './responses.yaml#/400'
+      '401':
+        $ref: './responses.yaml#/401'
+      '500':
+        $ref: './responses.yaml#/500'
+    security:
+      - api_key: [ ]
 
 llmo-sheet-data-with-type:
   parameters:
@@ -77,6 +110,40 @@ llmo-sheet-data-with-type:
         $ref: './responses.yaml#/500'
     security:
       - api_key: [ ]
+  post:
+    tags:
+      - llmo
+    summary: Query LLMO sheet data with sheet type using filters, exclusions, and grouping
+    description: |
+      Retrieves and processes data from the external LLMO data endpoint for a specific site with a specified sheet type
+      and advanced querying capabilities. This endpoint allows filtering data with case-insensitive exact matching,
+      excluding specific fields from the response, and grouping data by specified attributes.
+      The data is fetched from the path: {dataFolder}/{sheetType}/{dataSource}.json
+      The endpoint fetches all available data (up to 1M records) to apply the query operations effectively.
+    operationId: queryLlmoSheetDataWithType
+    requestBody:
+      required: false
+      content:
+        application/json:
+          schema:
+            $ref: './schemas.yaml#/LlmoSheetDataQuery'
+    responses:
+      '200':
+        description: LLMO sheet data queried and processed successfully
+        content:
+          application/json:
+            schema:
+              type: object
+              description: The processed data returned from the external LLMO endpoint after applying filters, exclusions, and grouping
+              additionalProperties: true
+      '400':
+        $ref: './responses.yaml#/400'
+      '401':
+        $ref: './responses.yaml#/401'
+      '500':
+        $ref: './responses.yaml#/500'
+    security:
+      - api_key: [ ]
 
 llmo-global-sheet-data:
   parameters:

docs/openapi/schemas.yaml

@@ -3571,6 +3571,33 @@ LlmoConfig:
       $ref: '#/LlmoCdnBucketConfig'
   additionalProperties: false
 
+LlmoSheetDataQuery:
+  type: object
+  description: Query parameters for LLMO sheet data
+  properties:
+    sheets:
+      description: Sheets to include from the data
+      type: object
+      additionalProperties: true
+    filters:
+      description: Filters to apply to the data
+      type: object
+    include:
+      description: Fields to include from the data
+      type: array
+      additionalProperties: true
+    exclude:
+      description: Fields to exclude from the data
+      type: array
+      items:
+        type: string
+    groupBy:
+      description: Fields to group the data by
+      type: array
+      items:
+        type: string
+  additionalProperties: false
+
 # New schemas for entitlements, trial users, and site enrollments APIs
 Entitlement:
   type: object