@epilot/app-client 0.6.1 → 0.6.3

package/dist/definition.js

@@ -1 +1 @@
-(()=>{"use strict";var e={466:e=>{e.exports=JSON.parse('{"openapi":"3.1.0","info":{"title":"","version":""},"servers":[{"url":"https://app.sls.epilot.io"}],"paths":{"/v1/public/.well-known/public-key":{"get":{"operationId":"getPublicKey","responses":{}}},"/v1/app-configurations":{"get":{"operationId":"listConfigurations","parameters":[{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}},"post":{"operationId":"createConfiguration","requestBody":{"$ref":"#/components/requestBodies/CreateConfigRequest"},"responses":{}}},"/v1/app-configurations/public/{appId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration to install"}],"get":{"operationId":"getPublicConfiguration","parameters":[{"name":"version","in":"query"}],"responses":{}}},"/v1/app-configurations/{appId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration"}],"get":{"operationId":"getConfiguration","parameters":[{"name":"version","in":"query"}],"responses":{}},"patch":{"operationId":"patchMetadata","requestBody":{"$ref":"#/components/requestBodies/PatchConfigMetadataRequest"},"responses":{}},"delete":{"operationId":"deleteConfiguration","responses":{}}},"/v1/app-configurations/{appId}/bundle":{"post":{"operationId":"createBundleUploadUrl","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/CreateBundlePresignedRequest"},"responses":{}}},"/v1/app-configurations/{appId}/zip":{"post":{"operationId":"createZipUploadUrl","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/app-configurations/{appId}/logo":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration"}],"post":{"operationId":"createLogoUploadUrl","requestBody":{"$ref":"#/components/requestBodies/CreateLogoPresignedRequest"},"responses":{}},"delete":{"operationId":"deleteLogo","responses":{}}},"/v1/app-configurations/{appId}/versions":{"get":{"operationId":"listVersions","parameters":[{"name":"appId","in":"path","required":true},{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}":{"get":{"operationId":"getVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"delete":{"operationId":"deleteVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"patch":{"operationId":"patchVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/PatchVersionRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/components":{"post":{"operationId":"createComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/UpsertComponentRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/components/{componentId}":{"patch":{"operationId":"patchComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true},{"name":"componentId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/UpsertComponentRequest"},"responses":{}},"delete":{"operationId":"deleteComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true},{"name":"componentId","in":"path","required":true}],"responses":{}}},"/v1/app-configurations/{appId}/versions/{sourceVersion}/clone-to/{targetVersion}":{"post":{"operationId":"cloneVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"sourceVersion","in":"path","required":true},{"name":"targetVersion","in":"path","required":true}],"responses":{}}},"/v1/app":{"get":{"operationId":"listInstallations","parameters":[{"name":"componentType","in":"query"},{"name":"enabled","in":"query"},{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}}},"/v1/app/{appId}":{"get":{"operationId":"getInstallation","parameters":[{"name":"appId","in":"path","required":true}],"responses":{}},"post":{"operationId":"install","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/InstallRequest"},"responses":{}},"patch":{"operationId":"patchInstallation","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/InstallRequest"},"responses":{}},"delete":{"operationId":"uninstall","parameters":[{"name":"appId","in":"path","required":true}],"responses":{}}},"/v1/app/{appId}/promote-to/{version}":{"post":{"operationId":"promoteVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}}},"/v1/app-events":{"post":{"operationId":"ingestEvent","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}}},"components":{"requestBodies":{"CreateLogoPresignedRequest":{"required":true,"content":{"application/json":{}}},"CreateBundlePresignedRequest":{"required":true,"content":{"application/json":{}}},"PatchConfigMetadataRequest":{"required":true,"content":{"application/json":{}}},"PatchVersionRequest":{"required":true,"content":{"application/json":{}}},"UpsertComponentRequest":{"required":true,"content":{"application/json":{}}},"CreateConfigRequest":{"required":true,"content":{"application/json":{}}},"InstallRequest":{"content":{"application/json":{}}}}}}')},757:function(e,r,t){var n=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(r,"__esModule",{value:!0});var o=n(t(466));r.default=o.default}},r={},t=function t(n){var o=r[n];if(void 0!==o)return o.exports;var p=r[n]={exports:{}};return e[n].call(p.exports,p,p.exports,t),p.exports}(757),n=exports;for(var o in t)n[o]=t[o];t.__esModule&&Object.defineProperty(n,"__esModule",{value:!0})})();
+(()=>{"use strict";var e={466:e=>{e.exports=JSON.parse('{"openapi":"3.1.0","info":{"title":"","version":""},"servers":[{"url":"https://app.sls.epilot.io"}],"paths":{"/v1/public/.well-known/public-key":{"get":{"operationId":"getPublicKey","responses":{}}},"/v1/app-configurations":{"get":{"operationId":"listConfigurations","parameters":[{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}},"post":{"operationId":"createConfiguration","requestBody":{"$ref":"#/components/requestBodies/CreateConfigRequest"},"responses":{}}},"/v1/app-configurations/public/{appId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration to install"}],"get":{"operationId":"getPublicConfiguration","parameters":[{"name":"version","in":"query"}],"responses":{}}},"/v1/app-configurations/{appId}":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration"}],"get":{"operationId":"getConfiguration","parameters":[{"name":"version","in":"query"}],"responses":{}},"patch":{"operationId":"patchMetadata","requestBody":{"$ref":"#/components/requestBodies/PatchConfigMetadataRequest"},"responses":{}},"delete":{"operationId":"deleteConfiguration","responses":{}}},"/v1/app-configurations/{appId}/events":{"post":{"operationId":"queryEvents","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/app-configurations/{appId}/bundle":{"post":{"operationId":"createBundleUploadUrl","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/CreateBundlePresignedRequest"},"responses":{}}},"/v1/app-configurations/{appId}/zip":{"post":{"operationId":"createZipUploadUrl","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/app-configurations/{appId}/logo":{"parameters":[{"name":"appId","in":"path","required":true,"description":"ID of the app configuration"}],"post":{"operationId":"createLogoUploadUrl","requestBody":{"$ref":"#/components/requestBodies/CreateLogoPresignedRequest"},"responses":{}},"delete":{"operationId":"deleteLogo","responses":{}}},"/v1/app-configurations/{appId}/versions":{"get":{"operationId":"listVersions","parameters":[{"name":"appId","in":"path","required":true},{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}":{"get":{"operationId":"getVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"delete":{"operationId":"deleteVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}},"patch":{"operationId":"patchVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/PatchVersionRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/components":{"post":{"operationId":"createComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/UpsertComponentRequest"},"responses":{}}},"/v1/app-configurations/{appId}/versions/{version}/components/{componentId}":{"patch":{"operationId":"patchComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true},{"name":"componentId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/UpsertComponentRequest"},"responses":{}},"delete":{"operationId":"deleteComponent","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true},{"name":"componentId","in":"path","required":true}],"responses":{}}},"/v1/app-configurations/{appId}/versions/{sourceVersion}/clone-to/{targetVersion}":{"post":{"operationId":"cloneVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"sourceVersion","in":"path","required":true},{"name":"targetVersion","in":"path","required":true}],"responses":{}}},"/v1/app":{"get":{"operationId":"listInstallations","parameters":[{"name":"componentType","in":"query"},{"name":"enabled","in":"query"},{"name":"page","in":"query"},{"name":"pageSize","in":"query"}],"responses":{}}},"/v1/app/{appId}":{"get":{"operationId":"getInstallation","parameters":[{"name":"appId","in":"path","required":true}],"responses":{}},"post":{"operationId":"install","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/InstallRequest"},"responses":{}},"patch":{"operationId":"patchInstallation","parameters":[{"name":"appId","in":"path","required":true}],"requestBody":{"$ref":"#/components/requestBodies/InstallRequest"},"responses":{}},"delete":{"operationId":"uninstall","parameters":[{"name":"appId","in":"path","required":true}],"responses":{}}},"/v1/app/{appId}/promote-to/{version}":{"post":{"operationId":"promoteVersion","parameters":[{"name":"appId","in":"path","required":true},{"name":"version","in":"path","required":true}],"responses":{}}},"/v1/app-events":{"post":{"operationId":"ingestEvent","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}}},"components":{"requestBodies":{"CreateLogoPresignedRequest":{"required":true,"content":{"application/json":{}}},"CreateBundlePresignedRequest":{"required":true,"content":{"application/json":{}}},"PatchConfigMetadataRequest":{"required":true,"content":{"application/json":{}}},"PatchVersionRequest":{"required":true,"content":{"application/json":{}}},"UpsertComponentRequest":{"required":true,"content":{"application/json":{}}},"CreateConfigRequest":{"required":true,"content":{"application/json":{}}},"InstallRequest":{"content":{"application/json":{}}}}}}')},757:function(e,r,t){var n=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(r,"__esModule",{value:!0});var o=n(t(466));r.default=o.default}},r={},t=function t(n){var o=r[n];if(void 0!==o)return o.exports;var p=r[n]={exports:{}};return e[n].call(p.exports,p,p.exports,t),p.exports}(757),n=exports;for(var o in t)n[o]=t[o];t.__esModule&&Object.defineProperty(n,"__esModule",{value:!0})})();

package/dist/openapi-runtime.json

@@ -90,6 +90,25 @@
         "responses": {}
       }
     },
+    "/v1/app-configurations/{appId}/events": {
+      "post": {
+        "operationId": "queryEvents",
+        "parameters": [
+          {
+            "name": "appId",
+            "in": "path",
+            "required": true
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {}
+          }
+        },
+        "responses": {}
+      }
+    },
     "/v1/app-configurations/{appId}/bundle": {
       "post": {
         "operationId": "createBundleUploadUrl",

package/dist/openapi.d.ts

@@ -103,6 +103,21 @@ declare namespace Components {
              */
             type: "user" | "system";
         }
+        export interface AggregatedEvents {
+            type?: "aggregated";
+            groups?: {
+                /**
+                 * The grouped dimensions e.g., "source": "CUSTOM_JOURNEY_BLOCK", "event_type": "ERROR"
+                 */
+                dimensions?: {
+                    [name: string]: any;
+                };
+                metrics?: {
+                    count?: number;
+                    error_rate?: number;
+                };
+            }[];
+        }
         export interface AppBridgeSurfaceConfig {
             /**
              * URL of the uploaded App Bridge App. This is the entrypoint for the app
@@ -210,7 +225,7 @@ declare namespace Components {
             surfaces?: {
                 [key: string]: any;
             };
-        } & (JourneyBlockComponent | PortalExtensionComponent | CustomFlowActionComponent);
+        } & (JourneyBlockComponent | PortalExtensionComponent | CustomFlowActionComponent | ErpInformToolkitComponent);
         export interface BaseComponentCommon {
             /**
              * Unique identifier for the component
@@ -400,7 +415,7 @@ declare namespace Components {
         /**
          * Type of app component
          */
-        export type ComponentType = "CUSTOM_JOURNEY_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION";
+        export type ComponentType = "CUSTOM_JOURNEY_BLOCK" | "PORTAL_EXTENSION" | "CUSTOM_FLOW_ACTION" | "ERP_INFORM_TOOLKIT";
         /**
          * Configuration of the published app
          */
@@ -795,6 +810,77 @@ declare namespace Components {
                 }[]
             ];
         }
+        export interface ErpInformToolkitComponent {
+            component_type: "ERP_INFORM_TOOLKIT";
+            configuration: {
+                type: "inbound" | "outbound";
+            };
+        }
+        export interface EventsQuery {
+            /**
+             * Either use preset OR start+end
+             */
+            time_range?: {
+                /**
+                 * Start time (ISO 8601)
+                 */
+                start?: string; // date-time
+                /**
+                 * End time (ISO 8601)
+                 */
+                end?: string; // date-time
+                /**
+                 * Predefined time range (alternative to start/end)
+                 */
+                preset?: "1h" | "6h" | "24h" | "7d" | "30d";
+            };
+            filters?: {
+                /**
+                 * Filter by component types
+                 */
+                source?: /* Type of app component */ ComponentType[];
+                /**
+                 * Filter by specific component IDs
+                 */
+                component_id?: string[];
+                /**
+                 * Filter by event types
+                 */
+                event_type?: ("ERROR" | "WARNING" | "INFO")[];
+                /**
+                 * Filter by correlation ID for tracing
+                 */
+                correlation_id?: string;
+            };
+            aggregation?: {
+                /**
+                 * Group results by specified fields
+                 */
+                group_by?: ("source" | "component_id" | "event_type" | "hour" | "day")[];
+                /**
+                 * Metrics to calculate
+                 */
+                metrics?: ("count" | "error_rate" | "unique_users")[];
+            };
+            pagination?: {
+                page?: number;
+                page_size?: number;
+            };
+            sort?: {
+                field?: "timestamp" | "event_type" | "component_id";
+                order?: "asc" | "desc";
+            };
+        }
+        export interface EventsQueryResponse {
+            query?: EventsQuery;
+            results?: RawEvents | AggregatedEvents;
+            pagination?: {
+                page?: number;
+                page_size?: number;
+                total_items?: number;
+                has_next?: boolean;
+            };
+        }
         export interface ExternalIntegrationCustomActionConfig {
             /**
              * Name of the custom action
@@ -1163,6 +1249,10 @@ declare namespace Components {
              */
             versions?: /* Configuration data about your app which is versionable */ ConfigurationVersion[];
         }
+        export interface RawEvents {
+            type?: "raw";
+            events?: AppEventData[];
+        }
         export interface Role {
             /**
              * Name of the role
@@ -1637,6 +1727,22 @@ declare namespace Paths {
             }
         }
     }
+    namespace QueryEvents {
+        namespace Parameters {
+            export type AppId = string;
+        }
+        export interface PathParameters {
+            appId: Parameters.AppId;
+        }
+        export type RequestBody = Components.Schemas.EventsQuery;
+        namespace Responses {
+            export type $200 = Components.Schemas.EventsQueryResponse;
+            export interface $400 {
+            }
+            export interface $404 {
+            }
+        }
+    }
     namespace Uninstall {
         namespace Parameters {
             export type AppId = string;
@@ -1749,6 +1855,16 @@ export interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.DeleteConfiguration.Responses.$204>
+  /**
+   * queryEvents - queryEvents
+   * 
+   * Query analytics events for a specific app with flexible filtering
+   */
+  'queryEvents'(
+    parameters?: Parameters<Paths.QueryEvents.PathParameters> | null,
+    data?: Paths.QueryEvents.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.QueryEvents.Responses.$200>
   /**
    * createBundleUploadUrl - createBundleUploadUrl
    * 
@@ -2021,6 +2137,18 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.DeleteConfiguration.Responses.$204>
   }
+  ['/v1/app-configurations/{appId}/events']: {
+    /**
+     * queryEvents - queryEvents
+     * 
+     * Query analytics events for a specific app with flexible filtering
+     */
+    'post'(
+      parameters?: Parameters<Paths.QueryEvents.PathParameters> | null,
+      data?: Paths.QueryEvents.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.QueryEvents.Responses.$200>
+  }
   ['/v1/app-configurations/{appId}/bundle']: {
     /**
      * createBundleUploadUrl - createBundleUploadUrl
@@ -2242,6 +2370,7 @@ export type Client = OpenAPIClient<OperationMethods, PathsDictionary>
 
 
 export type Actor = Components.Schemas.Actor;
+export type AggregatedEvents = Components.Schemas.AggregatedEvents;
 export type AppBridgeSurfaceConfig = Components.Schemas.AppBridgeSurfaceConfig;
 export type AppEventData = Components.Schemas.AppEventData;
 export type Audit = Components.Schemas.Audit;
@@ -2260,6 +2389,9 @@ export type ConfigurationVersion = Components.Schemas.ConfigurationVersion;
 export type CustomFlowActionComponent = Components.Schemas.CustomFlowActionComponent;
 export type CustomFlowConfig = Components.Schemas.CustomFlowConfig;
 export type EnumArg = Components.Schemas.EnumArg;
+export type ErpInformToolkitComponent = Components.Schemas.ErpInformToolkitComponent;
+export type EventsQuery = Components.Schemas.EventsQuery;
+export type EventsQueryResponse = Components.Schemas.EventsQueryResponse;
 export type ExternalIntegrationCustomActionConfig = Components.Schemas.ExternalIntegrationCustomActionConfig;
 export type Grants = Components.Schemas.Grants;
 export type Installation = Components.Schemas.Installation;
@@ -2277,6 +2409,7 @@ export type PortalExtensionComponent = Components.Schemas.PortalExtensionCompone
 export type PortalExtensionConfig = Components.Schemas.PortalExtensionConfig;
 export type Pricing = Components.Schemas.Pricing;
 export type PublicConfiguration = Components.Schemas.PublicConfiguration;
+export type RawEvents = Components.Schemas.RawEvents;
 export type Role = Components.Schemas.Role;
 export type S3Reference = Components.Schemas.S3Reference;
 export type TextArg = Components.Schemas.TextArg;

package/dist/openapi.json

@@ -295,6 +295,55 @@
         }
       }
     },
+    "/v1/app-configurations/{appId}/events": {
+      "post": {
+        "summary": "queryEvents",
+        "description": "Query analytics events for a specific app with flexible filtering",
+        "operationId": "queryEvents",
+        "tags": [
+          "App Analytics"
+        ],
+        "parameters": [
+          {
+            "name": "appId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "ID of the app configuration"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/EventsQuery"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Analytics events",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/EventsQueryResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid query parameters"
+          },
+          "404": {
+            "description": "App configuration not found"
+          }
+        }
+      }
+    },
     "/v1/app-configurations/{appId}/bundle": {
       "post": {
         "summary": "createBundleUploadUrl",
@@ -1541,7 +1590,8 @@
         "enum": [
           "CUSTOM_JOURNEY_BLOCK",
           "PORTAL_EXTENSION",
-          "CUSTOM_FLOW_ACTION"
+          "CUSTOM_FLOW_ACTION",
+          "ERP_INFORM_TOOLKIT"
         ],
         "description": "Type of app component"
       },
@@ -1648,7 +1698,8 @@
               "mapping": {
                 "CUSTOM_JOURNEY_BLOCK": "#/components/schemas/JourneyBlockComponent",
                 "PORTAL_EXTENSION": "#/components/schemas/PortalExtensionComponent",
-                "CUSTOM_FLOW_ACTION": "#/components/schemas/CustomFlowActionComponent"
+                "CUSTOM_FLOW_ACTION": "#/components/schemas/CustomFlowActionComponent",
+                "ERP_INFORM_TOOLKIT": "#/components/schemas/ErpInformToolkitComponent"
               }
             },
             "oneOf": [
@@ -1660,6 +1711,9 @@
               },
               {
                 "$ref": "#/components/schemas/CustomFlowActionComponent"
+              },
+              {
+                "$ref": "#/components/schemas/ErpInformToolkitComponent"
               }
             ]
           }
@@ -1683,6 +1737,36 @@
           }
         }
       },
+      "ErpInformToolkitComponent": {
+        "type": "object",
+        "required": [
+          "component_type",
+          "configuration"
+        ],
+        "properties": {
+          "component_type": {
+            "type": "string",
+            "enum": [
+              "ERP_INFORM_TOOLKIT"
+            ]
+          },
+          "configuration": {
+            "type": "object",
+            "required": [
+              "type"
+            ],
+            "properties": {
+              "type": {
+                "type": "string",
+                "enum": [
+                  "inbound",
+                  "outbound"
+                ]
+              }
+            }
+          }
+        }
+      },
       "CustomFlowActionComponent": {
         "type": "object",
         "required": [
@@ -2759,6 +2843,232 @@
             "additionalProperties": true
           }
         }
+      },
+      "EventsQuery": {
+        "type": "object",
+        "properties": {
+          "time_range": {
+            "type": "object",
+            "properties": {
+              "start": {
+                "type": "string",
+                "format": "date-time",
+                "description": "Start time (ISO 8601)"
+              },
+              "end": {
+                "type": "string",
+                "format": "date-time",
+                "description": "End time (ISO 8601)"
+              },
+              "preset": {
+                "type": "string",
+                "enum": [
+                  "1h",
+                  "6h",
+                  "24h",
+                  "7d",
+                  "30d"
+                ],
+                "description": "Predefined time range (alternative to start/end)"
+              }
+            },
+            "description": "Either use preset OR start+end"
+          },
+          "filters": {
+            "type": "object",
+            "properties": {
+              "source": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/ComponentType"
+                },
+                "description": "Filter by component types"
+              },
+              "component_id": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Filter by specific component IDs"
+              },
+              "event_type": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "ERROR",
+                    "WARNING",
+                    "INFO"
+                  ]
+                },
+                "description": "Filter by event types"
+              },
+              "correlation_id": {
+                "type": "string",
+                "description": "Filter by correlation ID for tracing"
+              }
+            }
+          },
+          "aggregation": {
+            "type": "object",
+            "properties": {
+              "group_by": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "source",
+                    "component_id",
+                    "event_type",
+                    "hour",
+                    "day"
+                  ]
+                },
+                "description": "Group results by specified fields"
+              },
+              "metrics": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "count",
+                    "error_rate",
+                    "unique_users"
+                  ]
+                },
+                "default": [
+                  "count"
+                ],
+                "description": "Metrics to calculate"
+              }
+            }
+          },
+          "pagination": {
+            "type": "object",
+            "properties": {
+              "page": {
+                "type": "integer",
+                "minimum": 1,
+                "default": 1
+              },
+              "page_size": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 1000,
+                "default": 100
+              }
+            }
+          },
+          "sort": {
+            "type": "object",
+            "properties": {
+              "field": {
+                "type": "string",
+                "enum": [
+                  "timestamp",
+                  "event_type",
+                  "component_id"
+                ],
+                "default": "timestamp"
+              },
+              "order": {
+                "type": "string",
+                "enum": [
+                  "asc",
+                  "desc"
+                ],
+                "default": "desc"
+              }
+            }
+          }
+        }
+      },
+      "EventsQueryResponse": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "$ref": "#/components/schemas/EventsQuery"
+          },
+          "results": {
+            "oneOf": [
+              {
+                "$ref": "#/components/schemas/RawEvents"
+              },
+              {
+                "$ref": "#/components/schemas/AggregatedEvents"
+              }
+            ]
+          },
+          "pagination": {
+            "type": "object",
+            "properties": {
+              "page": {
+                "type": "integer"
+              },
+              "page_size": {
+                "type": "integer"
+              },
+              "total_items": {
+                "type": "integer"
+              },
+              "has_next": {
+                "type": "boolean"
+              }
+            }
+          }
+        }
+      },
+      "RawEvents": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "raw"
+            ]
+          },
+          "events": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AppEventData"
+            }
+          }
+        }
+      },
+      "AggregatedEvents": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "aggregated"
+            ]
+          },
+          "groups": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "dimensions": {
+                  "type": "object",
+                  "description": "The grouped dimensions e.g., \"source\": \"CUSTOM_JOURNEY_BLOCK\", \"event_type\": \"ERROR\"",
+                  "additionalProperties": true
+                },
+                "metrics": {
+                  "type": "object",
+                  "properties": {
+                    "count": {
+                      "type": "integer"
+                    },
+                    "error_rate": {
+                      "type": "number"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/app-client",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "JavaScript client library for the epilot App API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",