@epilot/erp-integration-client 0.15.2 → 0.15.4

package/dist/definition.js

@@ -1 +1 @@
-(()=>{"use strict";var e={330:function(e,t,n){var r=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0});var o=r(n(466));t.default=o.default},466:e=>{e.exports=JSON.parse('{"openapi":"3.0.3","info":{"title":"","version":""},"servers":[{"url":"https://erp-integration-api.sls.epilot.io"}],"paths":{"/v1/erp/tracking/acknowledgement":{"post":{"operationId":"acknowledgeTracking","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/erp/trigger":{"post":{"operationId":"triggerErp","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/erp/updates/events":{"post":{"operationId":"processErpUpdatesEvents","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/erp/updates/events":{"post":{"operationId":"processErpUpdatesEventsV2","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/erp/updates/mapping_simulation":{"post":{"operationId":"simulateMappingV2","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/erp/updates/mapping_simulation":{"post":{"operationId":"simulateMapping","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations":{"get":{"operationId":"listIntegrations","responses":{}},"post":{"operationId":"createIntegration","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}":{"get":{"operationId":"getIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/events":{"post":{"operationId":"queryEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/events/replay":{"post":{"operationId":"replayEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/use-cases":{"get":{"operationId":"listUseCases","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"post":{"operationId":"createUseCase","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/use-cases/{useCaseId}":{"get":{"operationId":"getUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/use-cases/{useCaseId}/history":{"get":{"operationId":"listUseCaseHistory","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true},{"name":"cursor","in":"query","required":false}],"responses":{}}},"/v2/integrations":{"get":{"operationId":"listIntegrationsV2","responses":{}},"post":{"operationId":"createIntegrationV2","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v2/integrations/{integrationId}":{"get":{"operationId":"getIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/app-mapping":{"put":{"operationId":"setIntegrationAppMapping","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegrationAppMapping","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/events":{"post":{"operationId":"queryMonitoringEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/stats":{"post":{"operationId":"getMonitoringStats","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}}},"components":{"responses":{"BadRequest":{"content":{"application/json":{}}},"NotFound":{"content":{"application/json":{}}},"Unauthorized":{"content":{"application/json":{}}},"InternalServerError":{"content":{"application/json":{}}},"QueryMonitoringEventsResponse":{"content":{"application/json":{}}},"GetMonitoringStatsResponse":{"content":{"application/json":{}}},"ReplayEventsResponse":{"content":{"application/json":{}}},"ERPUpdatesResponse":{"content":{"application/json":{}}},"TriggerWebhookResponse":{"content":{"application/json":{}}},"QueryEventsResponse":{"content":{"application/json":{}}}}}}')}},t={},n=function n(r){var o=t[r];if(void 0!==o)return o.exports;var i=t[r]={exports:{}};return e[r].call(i.exports,i,i.exports,n),i.exports}(330),r=exports;for(var o in n)r[o]=n[o];n.__esModule&&Object.defineProperty(r,"__esModule",{value:!0})})();
+(()=>{"use strict";var e={187:function(e,t,n){var r=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0});var o=r(n(466));t.default=o.default},466:e=>{e.exports=JSON.parse('{"openapi":"3.0.3","info":{"title":"","version":""},"servers":[{"url":"https://erp-integration-api.sls.epilot.io"}],"paths":{"/v1/erp/tracking/acknowledgement":{"post":{"operationId":"acknowledgeTracking","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/erp/trigger":{"post":{"operationId":"triggerErp","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/erp/updates/events":{"post":{"operationId":"processErpUpdatesEvents","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/erp/updates/events":{"post":{"operationId":"processErpUpdatesEventsV2","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/erp/updates/mapping_simulation":{"post":{"operationId":"simulateMappingV2","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/erp/updates/mapping_simulation":{"post":{"operationId":"simulateMapping","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations":{"get":{"operationId":"listIntegrations","responses":{}},"post":{"operationId":"createIntegration","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}":{"get":{"operationId":"getIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegration","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/events":{"post":{"operationId":"queryEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/events/replay":{"post":{"operationId":"replayEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/use-cases":{"get":{"operationId":"listUseCases","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"post":{"operationId":"createUseCase","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/use-cases/{useCaseId}":{"get":{"operationId":"getUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteUseCase","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/use-cases/{useCaseId}/history":{"get":{"operationId":"listUseCaseHistory","parameters":[{"name":"integrationId","in":"path","required":true},{"name":"useCaseId","in":"path","required":true},{"name":"cursor","in":"query","required":false}],"responses":{}}},"/v2/integrations":{"get":{"operationId":"listIntegrationsV2","responses":{}},"post":{"operationId":"createIntegrationV2","requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v2/integrations/{integrationId}":{"get":{"operationId":"getIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}},"put":{"operationId":"updateIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegrationV2","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/app-mapping":{"put":{"operationId":"setIntegrationAppMapping","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteIntegrationAppMapping","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/events":{"post":{"operationId":"queryMonitoringEvents","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/monitoring/stats":{"post":{"operationId":"getMonitoringStats","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/integrations/{integrationId}/outbound-status":{"get":{"operationId":"getOutboundStatus","parameters":[{"name":"integrationId","in":"path","required":true}],"responses":{}}},"/v1/integrations/{integrationId}/monitoring/access-logs":{"post":{"operationId":"queryAccessLogs","parameters":[{"name":"integrationId","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}}},"components":{"responses":{"BadRequest":{"content":{"application/json":{}}},"NotFound":{"content":{"application/json":{}}},"Unauthorized":{"content":{"application/json":{}}},"InternalServerError":{"content":{"application/json":{}}},"QueryMonitoringEventsResponse":{"content":{"application/json":{}}},"GetMonitoringStatsResponse":{"content":{"application/json":{}}},"QueryAccessLogsResponse":{"content":{"application/json":{}}},"ReplayEventsResponse":{"content":{"application/json":{}}},"ERPUpdatesResponse":{"content":{"application/json":{}}},"TriggerWebhookResponse":{"content":{"application/json":{}}},"QueryEventsResponse":{"content":{"application/json":{}}}}}}')}},t={},n=function n(r){var o=t[r];if(void 0!==o)return o.exports;var i=t[r]={exports:{}};return e[r].call(i.exports,i,i.exports,n),i.exports}(187),r=exports;for(var o in n)r[o]=n[o];n.__esModule&&Object.defineProperty(r,"__esModule",{value:!0})})();

package/dist/openapi-runtime.json

@@ -413,6 +413,38 @@
         },
         "responses": {}
       }
+    },
+    "/v1/integrations/{integrationId}/outbound-status": {
+      "get": {
+        "operationId": "getOutboundStatus",
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true
+          }
+        ],
+        "responses": {}
+      }
+    },
+    "/v1/integrations/{integrationId}/monitoring/access-logs": {
+      "post": {
+        "operationId": "queryAccessLogs",
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {}
+          }
+        },
+        "responses": {}
+      }
     }
   },
   "components": {
@@ -447,6 +479,11 @@
           "application/json": {}
         }
       },
+      "QueryAccessLogsResponse": {
+        "content": {
+          "application/json": {}
+        }
+      },
       "ReplayEventsResponse": {
         "content": {
           "application/json": {}

package/dist/openapi.d.ts

@@ -27,6 +27,23 @@ declare namespace Components {
         export type GetMonitoringStatsResponse = Schemas.MonitoringStats;
         export type InternalServerError = Schemas.ErrorResponseBase;
         export type NotFound = Schemas.ErrorResponseBase;
+        export interface QueryAccessLogsResponse {
+            /**
+             * List of access log entries
+             */
+            data?: Schemas.AccessLogEntry[];
+            /**
+             * Cursor to fetch the next page. Null if no more results.
+             */
+            next_cursor?: {
+                timestamp?: string; // date-time
+                request_id?: string;
+            } | null;
+            /**
+             * Indicates if more results are available
+             */
+            has_more?: boolean;
+        }
         export interface QueryEventsResponse {
             /**
              * List of erp events
@@ -81,6 +98,60 @@ declare namespace Components {
         export type Unauthorized = Schemas.ErrorResponseBase;
     }
     namespace Schemas {
+        export interface AccessLogEntry {
+            /**
+             * When the request was made
+             */
+            timestamp?: string; // date-time
+            /**
+             * Environment (e.g., 'dev', 'prod')
+             */
+            environment?: string;
+            /**
+             * Service name (e.g., 'entity', 'metering')
+             */
+            service?: string;
+            /**
+             * Unique request identifier
+             */
+            request_id?: string;
+            /**
+             * HTTP method
+             */
+            method?: string;
+            /**
+             * Request path
+             */
+            path?: string;
+            /**
+             * HTTP status code
+             */
+            status?: number;
+            /**
+             * Response latency in milliseconds
+             */
+            response_latency_ms?: number;
+            /**
+             * Response body length in bytes
+             */
+            response_length?: number;
+            /**
+             * Access token identifier
+             */
+            token_id?: string;
+            /**
+             * Organization ID
+             */
+            org_id?: string;
+            /**
+             * Request origin header
+             */
+            origin?: string;
+            /**
+             * Client IP address
+             */
+            source_ip?: string;
+        }
         export interface CreateInboundUseCaseRequest {
             /**
              * Use case name
@@ -119,7 +190,7 @@ declare namespace Components {
              * Use case type
              */
             type: "outbound";
-            configuration?: /* Configuration for outbound use cases (epilot to ERP). Structure TBD. */ OutboundIntegrationEventConfiguration;
+            configuration?: /* Configuration for outbound use cases. Defines the event that triggers the flow and the webhook mappings. */ OutboundIntegrationEventConfiguration;
         }
         export type CreateUseCaseRequest = CreateInboundUseCaseRequest | CreateOutboundUseCaseRequest;
         export interface CreateUseCaseRequestBase {
@@ -142,6 +213,27 @@ declare namespace Components {
              */
             component_id: string; // uuid
         }
+        /**
+         * Configuration for how the transformed event should be delivered
+         */
+        export interface DeliveryConfig {
+            /**
+             * Delivery mechanism type (currently only webhook is supported)
+             */
+            type: "webhook";
+            /**
+             * Reference to the webhook configuration in svc-webhooks
+             */
+            webhook_id: string;
+            /**
+             * Cached webhook name for display purposes
+             */
+            webhook_name?: string;
+            /**
+             * Cached webhook URL for display purposes
+             */
+            webhook_url?: string;
+        }
         export interface EmbeddedInboundUseCaseRequest {
             /**
              * Optional use case ID for update matching.
@@ -194,7 +286,7 @@ declare namespace Components {
              * Use case type
              */
             type: "outbound";
-            configuration?: /* Configuration for outbound use cases (epilot to ERP). Structure TBD. */ OutboundIntegrationEventConfiguration;
+            configuration?: /* Configuration for outbound use cases. Defines the event that triggers the flow and the webhook mappings. */ OutboundIntegrationEventConfiguration;
         }
         export type EmbeddedUseCaseRequest = EmbeddedInboundUseCaseRequest | EmbeddedOutboundUseCaseRequest;
         export interface EmbeddedUseCaseRequestBase {
@@ -774,6 +866,10 @@ declare namespace Components {
              * Total number of events in the period
              */
             total_events: number;
+            /**
+             * Total number of unique correlation IDs (a correlation_id groups multiple event_ids)
+             */
+            total_correlations: number;
             /**
              * Number of successful events
              */
@@ -801,11 +897,79 @@ declare namespace Components {
                 [name: string]: any;
             }[];
         }
+        export interface OutboundConflict {
+            /**
+             * Type of conflict:
+             * - 'event_disabled': Event catalog event is disabled while use case is enabled
+             * - 'all_webhooks_disabled': All webhooks are disabled while use case is enabled
+             * - 'event_enabled_while_disabled': Event is enabled while use case is disabled
+             * - 'webhook_enabled_while_disabled': A webhook is enabled while use case is disabled
+             *
+             */
+            type: "event_disabled" | "all_webhooks_disabled" | "event_enabled_while_disabled" | "webhook_enabled_while_disabled";
+            /**
+             * Webhook ID (only present for webhook_enabled_while_disabled conflicts)
+             */
+            webhookId?: string;
+            /**
+             * Human-readable description of the conflict
+             */
+            message: string;
+        }
         /**
-         * Configuration for outbound use cases (epilot to ERP). Structure TBD.
+         * Configuration for outbound use cases. Defines the event that triggers the flow and the webhook mappings.
          */
         export interface OutboundIntegrationEventConfiguration {
-            [name: string]: any;
+            /**
+             * The Event Catalog event name that triggers this outbound flow
+             * example:
+             * contract.created
+             */
+            event_catalog_event: string;
+            /**
+             * List of mappings that transform and deliver the event
+             */
+            mappings: [
+                /* A mapping that transforms an event and delivers it to a webhook */ OutboundMapping,
+                .../* A mapping that transforms an event and delivers it to a webhook */ OutboundMapping[]
+            ];
+        }
+        /**
+         * A mapping that transforms an event and delivers it to a webhook
+         */
+        export interface OutboundMapping {
+            /**
+             * Unique identifier for this mapping
+             */
+            id: string; // uuid
+            /**
+             * Human-readable name for this mapping
+             * example:
+             * ERP Contract Sync
+             */
+            name: string;
+            /**
+             * JSONata expression to transform the event payload
+             * example:
+             * { "id": entity._id, "customer": entity.customer_name }
+             */
+            jsonata_expression: string;
+            /**
+             * Whether this mapping is active
+             */
+            enabled: boolean;
+            delivery: /* Configuration for how the transformed event should be delivered */ DeliveryConfig;
+            /**
+             * Timestamp when the mapping was created
+             */
+            created_at?: string; // date-time
+            /**
+             * Timestamp when the mapping was last updated
+             */
+            updated_at?: string; // date-time
+        }
+        export interface OutboundStatusResponse {
+            useCases: OutboundUseCaseStatus[];
         }
         export interface OutboundUseCase {
             /**
@@ -837,7 +1001,7 @@ declare namespace Components {
              * ISO-8601 timestamp when the use case was last updated
              */
             updated_at: string; // date-time
-            configuration?: /* Configuration for outbound use cases (epilot to ERP). Structure TBD. */ OutboundIntegrationEventConfiguration;
+            configuration?: /* Configuration for outbound use cases. Defines the event that triggers the flow and the webhook mappings. */ OutboundIntegrationEventConfiguration;
         }
         export interface OutboundUseCaseHistoryEntry {
             /**
@@ -880,7 +1044,105 @@ declare namespace Components {
              * Use case type
              */
             type: "outbound";
-            configuration?: /* Configuration for outbound use cases (epilot to ERP). Structure TBD. */ OutboundIntegrationEventConfiguration;
+            configuration?: /* Configuration for outbound use cases. Defines the event that triggers the flow and the webhook mappings. */ OutboundIntegrationEventConfiguration;
+        }
+        export interface OutboundUseCaseStatus {
+            /**
+             * Unique identifier for the use case
+             */
+            useCaseId: string; // uuid
+            /**
+             * Human-readable name of the use case
+             */
+            name: string;
+            /**
+             * Whether the use case is enabled
+             */
+            useCaseEnabled: boolean;
+            /**
+             * The Event Catalog event name that triggers this outbound flow
+             * example:
+             * contract.created
+             */
+            eventCatalogEvent?: string;
+            /**
+             * Whether the event is enabled in Event Catalog. Null if the API is unreachable.
+             */
+            eventEnabled?: boolean | null;
+            webhooks?: WebhookStatus[];
+            /**
+             * Overall status of the use case:
+             * - 'ok': Use case is enabled and all dependencies are properly configured
+             * - 'conflict': Use case has configuration issues (disabled events/webhooks while enabled)
+             * - 'disabled': Use case is disabled
+             *
+             */
+            status: "ok" | "conflict" | "disabled";
+            /**
+             * List of detected conflicts, if any
+             */
+            conflicts?: OutboundConflict[];
+        }
+        export interface QueryAccessLogsRequest {
+            /**
+             * Filter by access token ID (e.g., 'api_5ZugdRXasLfWBypHi93Fk')
+             * example:
+             * api_5ZugdRXasLfWBypHi93Fk
+             */
+            token_id: string;
+            /**
+             * Filter by service name (e.g., 'entity', 'metering', 'submission-api')
+             * example:
+             * entity
+             */
+            service?: string;
+            /**
+             * Filter by HTTP method
+             */
+            method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
+            /**
+             * Filter by request path (partial match)
+             * example:
+             * /v1/entity
+             */
+            path?: string;
+            /**
+             * Filter by HTTP status code
+             * example:
+             * 200
+             */
+            status?: number;
+            /**
+             * Filter logs from this date (inclusive)
+             * example:
+             * 2025-01-01T00:00:00Z
+             */
+            from_date?: string; // date-time
+            /**
+             * Filter logs until this date (inclusive)
+             * example:
+             * 2025-01-31T23:59:59Z
+             */
+            to_date?: string; // date-time
+            /**
+             * Maximum number of results to return
+             * example:
+             * 50
+             */
+            limit?: number;
+            /**
+             * Cursor for pagination (infinite scroll)
+             */
+            cursor?: {
+                /**
+                 * Timestamp from the last log entry in the previous page
+                 */
+                timestamp?: string; // date-time
+                /**
+                 * Request ID from the last log entry in the previous page
+                 */
+                request_id?: string;
+            };
         }
         export interface QueryEventsRequest {
             /**
@@ -1346,7 +1608,7 @@ declare namespace Components {
              * Use case type
              */
             type?: "outbound";
-            configuration?: /* Configuration for outbound use cases (epilot to ERP). Structure TBD. */ OutboundIntegrationEventConfiguration;
+            configuration?: /* Configuration for outbound use cases. Defines the event that triggers the flow and the webhook mappings. */ OutboundIntegrationEventConfiguration;
         }
         export type UpdateUseCaseRequest = UpdateInboundUseCaseRequest | UpdateOutboundUseCaseRequest;
         export interface UpdateUseCaseRequestBase {
@@ -1457,6 +1719,20 @@ declare namespace Components {
              */
             history_created_at: string; // date-time
         }
+        export interface WebhookStatus {
+            /**
+             * Unique identifier for the webhook
+             */
+            webhookId: string;
+            /**
+             * Human-readable name of the webhook
+             */
+            webhookName?: string;
+            /**
+             * Whether the webhook is enabled. Null if the API is unreachable.
+             */
+            enabled?: boolean | null;
+        }
     }
 }
 declare namespace Paths {
@@ -1639,6 +1915,20 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace GetOutboundStatus {
+        namespace Parameters {
+            export type IntegrationId = string; // uuid
+        }
+        export interface PathParameters {
+            integrationId: Parameters.IntegrationId /* uuid */;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.OutboundStatusResponse;
+            export type $401 = Components.Responses.Unauthorized;
+            export type $404 = Components.Responses.NotFound;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace GetUseCase {
         namespace Parameters {
             export type IntegrationId = string; // uuid
@@ -1762,6 +2052,22 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace QueryAccessLogs {
+        namespace Parameters {
+            export type IntegrationId = string; // uuid
+        }
+        export interface PathParameters {
+            integrationId: Parameters.IntegrationId /* uuid */;
+        }
+        export type RequestBody = Components.Schemas.QueryAccessLogsRequest;
+        namespace Responses {
+            export type $200 = Components.Responses.QueryAccessLogsResponse;
+            export type $400 = Components.Responses.BadRequest;
+            export type $401 = Components.Responses.Unauthorized;
+            export type $404 = Components.Responses.NotFound;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace QueryEvents {
         namespace Parameters {
             export type IntegrationId = string; // uuid
@@ -2240,6 +2546,31 @@ export interface OperationMethods {
     data?: Paths.GetMonitoringStats.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetMonitoringStats.Responses.$200>
+  /**
+   * getOutboundStatus - getOutboundStatus
+   * 
+   * Get the status of all outbound use cases for a specific integration.
+   * Returns conflict information when events or webhooks are disabled but the use case is enabled.
+   * 
+   */
+  'getOutboundStatus'(
+    parameters?: Parameters<Paths.GetOutboundStatus.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetOutboundStatus.Responses.$200>
+  /**
+   * queryAccessLogs - queryAccessLogs
+   * 
+   * Query API access logs for a specific integration's organization.
+   * Returns access token usage analytics filtered by user_id (access token).
+   * Supports infinite scroll pagination with cursor-based navigation.
+   * 
+   */
+  'queryAccessLogs'(
+    parameters?: Parameters<Paths.QueryAccessLogs.PathParameters> | null,
+    data?: Paths.QueryAccessLogs.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.QueryAccessLogs.Responses.$200>
 }
 
 export interface PathsDictionary {
@@ -2592,17 +2923,48 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetMonitoringStats.Responses.$200>
   }
+  ['/v1/integrations/{integrationId}/outbound-status']: {
+    /**
+     * getOutboundStatus - getOutboundStatus
+     * 
+     * Get the status of all outbound use cases for a specific integration.
+     * Returns conflict information when events or webhooks are disabled but the use case is enabled.
+     * 
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetOutboundStatus.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetOutboundStatus.Responses.$200>
+  }
+  ['/v1/integrations/{integrationId}/monitoring/access-logs']: {
+    /**
+     * queryAccessLogs - queryAccessLogs
+     * 
+     * Query API access logs for a specific integration's organization.
+     * Returns access token usage analytics filtered by user_id (access token).
+     * Supports infinite scroll pagination with cursor-based navigation.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.QueryAccessLogs.PathParameters> | null,
+      data?: Paths.QueryAccessLogs.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.QueryAccessLogs.Responses.$200>
+  }
 }
 
 export type Client = OpenAPIClient<OperationMethods, PathsDictionary>
 
 
+export type AccessLogEntry = Components.Schemas.AccessLogEntry;
 export type CreateInboundUseCaseRequest = Components.Schemas.CreateInboundUseCaseRequest;
 export type CreateIntegrationRequest = Components.Schemas.CreateIntegrationRequest;
 export type CreateOutboundUseCaseRequest = Components.Schemas.CreateOutboundUseCaseRequest;
 export type CreateUseCaseRequest = Components.Schemas.CreateUseCaseRequest;
 export type CreateUseCaseRequestBase = Components.Schemas.CreateUseCaseRequestBase;
 export type DeleteIntegrationAppMappingRequest = Components.Schemas.DeleteIntegrationAppMappingRequest;
+export type DeliveryConfig = Components.Schemas.DeliveryConfig;
 export type EmbeddedInboundUseCaseRequest = Components.Schemas.EmbeddedInboundUseCaseRequest;
 export type EmbeddedOutboundUseCaseRequest = Components.Schemas.EmbeddedOutboundUseCaseRequest;
 export type EmbeddedUseCaseRequest = Components.Schemas.EmbeddedUseCaseRequest;
@@ -2632,9 +2994,14 @@ export type MeterReadingUpdate = Components.Schemas.MeterReadingUpdate;
 export type MeterUniqueIdsConfig = Components.Schemas.MeterUniqueIdsConfig;
 export type MonitoringEvent = Components.Schemas.MonitoringEvent;
 export type MonitoringStats = Components.Schemas.MonitoringStats;
+export type OutboundConflict = Components.Schemas.OutboundConflict;
 export type OutboundIntegrationEventConfiguration = Components.Schemas.OutboundIntegrationEventConfiguration;
+export type OutboundMapping = Components.Schemas.OutboundMapping;
+export type OutboundStatusResponse = Components.Schemas.OutboundStatusResponse;
 export type OutboundUseCase = Components.Schemas.OutboundUseCase;
 export type OutboundUseCaseHistoryEntry = Components.Schemas.OutboundUseCaseHistoryEntry;
+export type OutboundUseCaseStatus = Components.Schemas.OutboundUseCaseStatus;
+export type QueryAccessLogsRequest = Components.Schemas.QueryAccessLogsRequest;
 export type QueryEventsRequest = Components.Schemas.QueryEventsRequest;
 export type QueryMonitoringEventsRequest = Components.Schemas.QueryMonitoringEventsRequest;
 export type RelationConfig = Components.Schemas.RelationConfig;
@@ -2658,3 +3025,4 @@ export type UseCase = Components.Schemas.UseCase;
 export type UseCaseBase = Components.Schemas.UseCaseBase;
 export type UseCaseHistoryEntry = Components.Schemas.UseCaseHistoryEntry;
 export type UseCaseHistoryEntryBase = Components.Schemas.UseCaseHistoryEntryBase;
+export type WebhookStatus = Components.Schemas.WebhookStatus;

package/dist/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "ERP Integration API",
-    "version": "0.22.0",
+    "version": "0.25.0",
     "description": "API for integrating with ERP systems, handling tracking acknowledgments, triggering ERP processes, and processing ERP updates."
   },
   "tags": [
@@ -2006,6 +2006,99 @@
           }
         }
       }
+    },
+    "/v1/integrations/{integrationId}/outbound-status": {
+      "get": {
+        "operationId": "getOutboundStatus",
+        "summary": "getOutboundStatus",
+        "description": "Get the status of all outbound use cases for a specific integration.\nReturns conflict information when events or webhooks are disabled but the use case is enabled.\n",
+        "tags": [
+          "integrations"
+        ],
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true,
+            "description": "The integration ID",
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully retrieved outbound status",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/OutboundStatusResponse"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
+    "/v1/integrations/{integrationId}/monitoring/access-logs": {
+      "post": {
+        "operationId": "queryAccessLogs",
+        "summary": "queryAccessLogs",
+        "description": "Query API access logs for a specific integration's organization.\nReturns access token usage analytics filtered by user_id (access token).\nSupports infinite scroll pagination with cursor-based navigation.\n",
+        "tags": [
+          "monitoring",
+          "integrations"
+        ],
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true,
+            "description": "The integration ID (used for tenant authorization)",
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/QueryAccessLogsRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/QueryAccessLogsResponse"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
     }
   },
   "components": {
@@ -3065,8 +3158,219 @@
       },
       "OutboundIntegrationEventConfiguration": {
         "type": "object",
-        "description": "Configuration for outbound use cases (epilot to ERP). Structure TBD.",
-        "additionalProperties": true
+        "required": [
+          "event_catalog_event",
+          "mappings"
+        ],
+        "description": "Configuration for outbound use cases. Defines the event that triggers the flow and the webhook mappings.",
+        "properties": {
+          "event_catalog_event": {
+            "type": "string",
+            "description": "The Event Catalog event name that triggers this outbound flow",
+            "example": "contract.created"
+          },
+          "mappings": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "$ref": "#/components/schemas/OutboundMapping"
+            },
+            "description": "List of mappings that transform and deliver the event"
+          }
+        }
+      },
+      "OutboundMapping": {
+        "type": "object",
+        "required": [
+          "id",
+          "name",
+          "jsonata_expression",
+          "enabled",
+          "delivery"
+        ],
+        "description": "A mapping that transforms an event and delivers it to a webhook",
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Unique identifier for this mapping"
+          },
+          "name": {
+            "type": "string",
+            "description": "Human-readable name for this mapping",
+            "example": "ERP Contract Sync"
+          },
+          "jsonata_expression": {
+            "type": "string",
+            "description": "JSONata expression to transform the event payload",
+            "example": "{ \"id\": entity._id, \"customer\": entity.customer_name }"
+          },
+          "enabled": {
+            "type": "boolean",
+            "description": "Whether this mapping is active",
+            "default": true
+          },
+          "delivery": {
+            "$ref": "#/components/schemas/DeliveryConfig"
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Timestamp when the mapping was created"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Timestamp when the mapping was last updated"
+          }
+        }
+      },
+      "DeliveryConfig": {
+        "type": "object",
+        "required": [
+          "type",
+          "webhook_id"
+        ],
+        "description": "Configuration for how the transformed event should be delivered",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "webhook"
+            ],
+            "description": "Delivery mechanism type (currently only webhook is supported)"
+          },
+          "webhook_id": {
+            "type": "string",
+            "description": "Reference to the webhook configuration in svc-webhooks"
+          },
+          "webhook_name": {
+            "type": "string",
+            "description": "Cached webhook name for display purposes"
+          },
+          "webhook_url": {
+            "type": "string",
+            "description": "Cached webhook URL for display purposes"
+          }
+        }
+      },
+      "OutboundStatusResponse": {
+        "type": "object",
+        "required": [
+          "useCases"
+        ],
+        "properties": {
+          "useCases": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/OutboundUseCaseStatus"
+            }
+          }
+        }
+      },
+      "OutboundUseCaseStatus": {
+        "type": "object",
+        "required": [
+          "useCaseId",
+          "name",
+          "useCaseEnabled",
+          "status"
+        ],
+        "properties": {
+          "useCaseId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Unique identifier for the use case"
+          },
+          "name": {
+            "type": "string",
+            "description": "Human-readable name of the use case"
+          },
+          "useCaseEnabled": {
+            "type": "boolean",
+            "description": "Whether the use case is enabled"
+          },
+          "eventCatalogEvent": {
+            "type": "string",
+            "description": "The Event Catalog event name that triggers this outbound flow",
+            "example": "contract.created"
+          },
+          "eventEnabled": {
+            "type": "boolean",
+            "nullable": true,
+            "description": "Whether the event is enabled in Event Catalog. Null if the API is unreachable."
+          },
+          "webhooks": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/WebhookStatus"
+            }
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "ok",
+              "conflict",
+              "disabled"
+            ],
+            "description": "Overall status of the use case:\n- 'ok': Use case is enabled and all dependencies are properly configured\n- 'conflict': Use case has configuration issues (disabled events/webhooks while enabled)\n- 'disabled': Use case is disabled\n"
+          },
+          "conflicts": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/OutboundConflict"
+            },
+            "description": "List of detected conflicts, if any"
+          }
+        }
+      },
+      "WebhookStatus": {
+        "type": "object",
+        "required": [
+          "webhookId"
+        ],
+        "properties": {
+          "webhookId": {
+            "type": "string",
+            "description": "Unique identifier for the webhook"
+          },
+          "webhookName": {
+            "type": "string",
+            "description": "Human-readable name of the webhook"
+          },
+          "enabled": {
+            "type": "boolean",
+            "nullable": true,
+            "description": "Whether the webhook is enabled. Null if the API is unreachable."
+          }
+        }
+      },
+      "OutboundConflict": {
+        "type": "object",
+        "required": [
+          "type",
+          "message"
+        ],
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "event_disabled",
+              "all_webhooks_disabled",
+              "event_enabled_while_disabled",
+              "webhook_enabled_while_disabled"
+            ],
+            "description": "Type of conflict:\n- 'event_disabled': Event catalog event is disabled while use case is enabled\n- 'all_webhooks_disabled': All webhooks are disabled while use case is enabled\n- 'event_enabled_while_disabled': Event is enabled while use case is disabled\n- 'webhook_enabled_while_disabled': A webhook is enabled while use case is disabled\n"
+          },
+          "webhookId": {
+            "type": "string",
+            "description": "Webhook ID (only present for webhook_enabled_while_disabled conflicts)"
+          },
+          "message": {
+            "type": "string",
+            "description": "Human-readable description of the conflict"
+          }
+        }
       },
       "IntegrationEntity": {
         "type": "object",
@@ -3731,6 +4035,140 @@
           }
         }
       },
+      "QueryAccessLogsRequest": {
+        "type": "object",
+        "required": [
+          "token_id"
+        ],
+        "properties": {
+          "token_id": {
+            "type": "string",
+            "description": "Filter by access token ID (e.g., 'api_5ZugdRXasLfWBypHi93Fk')",
+            "example": "api_5ZugdRXasLfWBypHi93Fk"
+          },
+          "service": {
+            "type": "string",
+            "description": "Filter by service name (e.g., 'entity', 'metering', 'submission-api')",
+            "example": "entity"
+          },
+          "method": {
+            "type": "string",
+            "enum": [
+              "GET",
+              "POST",
+              "PUT",
+              "PATCH",
+              "DELETE",
+              "OPTIONS",
+              "HEAD"
+            ],
+            "description": "Filter by HTTP method"
+          },
+          "path": {
+            "type": "string",
+            "description": "Filter by request path (partial match)",
+            "example": "/v1/entity"
+          },
+          "status": {
+            "type": "integer",
+            "description": "Filter by HTTP status code",
+            "example": 200
+          },
+          "from_date": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Filter logs from this date (inclusive)",
+            "example": "2025-01-01T00:00:00Z"
+          },
+          "to_date": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Filter logs until this date (inclusive)",
+            "example": "2025-01-31T23:59:59Z"
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Maximum number of results to return",
+            "example": 50,
+            "default": 50,
+            "minimum": 1,
+            "maximum": 100
+          },
+          "cursor": {
+            "type": "object",
+            "description": "Cursor for pagination (infinite scroll)",
+            "properties": {
+              "timestamp": {
+                "type": "string",
+                "format": "date-time",
+                "description": "Timestamp from the last log entry in the previous page"
+              },
+              "request_id": {
+                "type": "string",
+                "description": "Request ID from the last log entry in the previous page"
+              }
+            }
+          }
+        }
+      },
+      "AccessLogEntry": {
+        "type": "object",
+        "properties": {
+          "timestamp": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When the request was made"
+          },
+          "environment": {
+            "type": "string",
+            "description": "Environment (e.g., 'dev', 'prod')"
+          },
+          "service": {
+            "type": "string",
+            "description": "Service name (e.g., 'entity', 'metering')"
+          },
+          "request_id": {
+            "type": "string",
+            "description": "Unique request identifier"
+          },
+          "method": {
+            "type": "string",
+            "description": "HTTP method"
+          },
+          "path": {
+            "type": "string",
+            "description": "Request path"
+          },
+          "status": {
+            "type": "integer",
+            "description": "HTTP status code"
+          },
+          "response_latency_ms": {
+            "type": "integer",
+            "description": "Response latency in milliseconds"
+          },
+          "response_length": {
+            "type": "integer",
+            "description": "Response body length in bytes"
+          },
+          "token_id": {
+            "type": "string",
+            "description": "Access token identifier"
+          },
+          "org_id": {
+            "type": "string",
+            "description": "Organization ID"
+          },
+          "origin": {
+            "type": "string",
+            "description": "Request origin header"
+          },
+          "source_ip": {
+            "type": "string",
+            "description": "Client IP address"
+          }
+        }
+      },
       "GetMonitoringStatsRequest": {
         "type": "object",
         "properties": {
@@ -3912,6 +4350,7 @@
         "type": "object",
         "required": [
           "total_events",
+          "total_correlations",
           "success_count",
           "error_count",
           "skipped_count"
@@ -3921,6 +4360,10 @@
             "type": "integer",
             "description": "Total number of events in the period"
           },
+          "total_correlations": {
+            "type": "integer",
+            "description": "Total number of unique correlation IDs (a correlation_id groups multiple event_ids)"
+          },
           "success_count": {
             "type": "integer",
             "description": "Number of successful events"
@@ -4043,6 +4486,43 @@
           }
         }
       },
+      "QueryAccessLogsResponse": {
+        "description": "Access logs queried successfully",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "data": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/AccessLogEntry"
+                  },
+                  "description": "List of access log entries"
+                },
+                "next_cursor": {
+                  "type": "object",
+                  "nullable": true,
+                  "description": "Cursor to fetch the next page. Null if no more results.",
+                  "properties": {
+                    "timestamp": {
+                      "type": "string",
+                      "format": "date-time"
+                    },
+                    "request_id": {
+                      "type": "string"
+                    }
+                  }
+                },
+                "has_more": {
+                  "type": "boolean",
+                  "description": "Indicates if more results are available"
+                }
+              }
+            }
+          }
+        }
+      },
       "ReplayEventsResponse": {
         "description": "Events replay initiated",
         "content": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/erp-integration-client",
-  "version": "0.15.2",
+  "version": "0.15.4",
   "description": "Client library for ePilot ERP Integration API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",