@epilot/erp-integration-client 0.13.0 → 0.14.0

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}/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":{}}},"/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":{}}}},"components":{"responses":{"BadRequest":{"content":{"application/json":{}}},"NotFound":{"content":{"application/json":{}}},"Unauthorized":{"content":{"application/json":{}}},"InternalServerError":{"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 s=t[r]={exports:{}};return e[r].call(s.exports,s,s.exports,n),s.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={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":{}}},"/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":{}}}},"components":{"responses":{"BadRequest":{"content":{"application/json":{}}},"NotFound":{"content":{"application/json":{}}},"Unauthorized":{"content":{"application/json":{}}},"InternalServerError":{"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 s=t[r]={exports:{}};return e[r].call(s.exports,s,s.exports,n),s.exports}(330),r=exports;for(var o in n)r[o]=n[o];n.__esModule&&Object.defineProperty(r,"__esModule",{value:!0})})();

package/dist/openapi-runtime.json

@@ -155,6 +155,25 @@
         "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",
@@ -323,6 +342,11 @@
           "application/json": {}
         }
       },
+      "ReplayEventsResponse": {
+        "content": {
+          "application/json": {}
+        }
+      },
       "ERPUpdatesResponse": {
         "content": {
           "application/json": {}

package/dist/openapi.d.ts

@@ -39,7 +39,7 @@ declare namespace Components {
                  * example:
                  * 2025-10-31T12:34:56Z
                  */
-                created_at?: string; // date-time
+                event_time?: string; // date-time
                 /**
                  * example:
                  * evt_1234567890abcdef
@@ -53,6 +53,12 @@ declare namespace Components {
              */
             has_more?: boolean;
         }
+        export interface ReplayEventsResponse {
+            /**
+             * List of event IDs for which replay was requested
+             */
+            event_ids?: string[];
+        }
         export type TriggerWebhookResponse = Schemas.TriggerWebhookResp;
         export type Unauthorized = Schemas.ErrorResponseBase;
     }
@@ -191,6 +197,25 @@ declare namespace Components {
              */
             message?: string;
         }
+        /**
+         * Extended unique identifier field configuration with type hints for repeatable fields
+         */
+        export interface ExtendedUniqueIdField {
+            /**
+             * The attribute name to use as unique identifier
+             */
+            attribute: string;
+            _type?: /**
+             * Type hint for repeatable fields that require special search handling.
+             * These fields are stored as arrays of objects (e.g., email: [{ email: "value" }]).
+             *
+             */
+            RepeatableFieldType;
+            /**
+             * Which array item to use (0-indexed, default first)
+             */
+            index?: number;
+        }
         /**
          * Configuration for inbound use cases (ERP to epilot)
          */
@@ -205,39 +230,11 @@ declare namespace Components {
             meter_readings?: IntegrationMeterReading[];
         }
         export interface InboundUseCase {
-            /**
-             * Unique identifier for the use case
-             */
-            id: string; // uuid
-            /**
-             * Parent integration ID
-             */
-            integrationId: string; // uuid
-            /**
-             * Use case name
-             */
-            name: string;
             /**
              * Use case type
              */
             type: "inbound";
-            /**
-             * Whether the use case is enabled
-             */
-            enabled: boolean;
             configuration?: /* Configuration for inbound use cases (ERP to epilot) */ InboundIntegrationEventConfiguration;
-            /**
-             * Description of the last change made to this use case
-             */
-            change_description?: string;
-            /**
-             * ISO-8601 timestamp when the use case was created
-             */
-            created_at: string; // date-time
-            /**
-             * ISO-8601 timestamp when the use case was last updated
-             */
-            updated_at: string; // date-time
         }
         export interface InboundUseCaseHistoryEntry {
             /**
@@ -348,7 +345,10 @@ declare namespace Components {
              */
             entity_schema: string;
             /**
-             * Array of attribute names that uniquely identify this entity
+             * Array of attribute names that uniquely identify this entity.
+             * The _type hint for repeatable fields (e.g., email, phone) should be specified
+             * on the corresponding field definition in the fields array.
+             *
              */
             unique_ids: string[];
             /**
@@ -381,6 +381,18 @@ declare namespace Components {
              * Constant value to assign (any type)
              */
             constant?: any;
+            /**
+             * Type hint for repeatable fields (email, phone).
+             * When this attribute is used as a unique identifier, specifying the _type
+             * enables correct search path generation (e.g., email.email.keyword).
+             *
+             */
+            _type?: /**
+             * Type hint for repeatable fields that require special search handling.
+             * These fields are stored as arrays of objects (e.g., email: [{ email: "value" }]).
+             *
+             */
+            RepeatableFieldType;
             /**
              * Controls whether this field mapping should be processed. Can be a boolean or a JSONata expression (string) that evaluates to a boolean. Defaults to true if omitted.
              */
@@ -520,39 +532,11 @@ declare namespace Components {
             [name: string]: any;
         }
         export interface OutboundUseCase {
-            /**
-             * Unique identifier for the use case
-             */
-            id: string; // uuid
-            /**
-             * Parent integration ID
-             */
-            integrationId: string; // uuid
-            /**
-             * Use case name
-             */
-            name: string;
             /**
              * Use case type
              */
             type: "outbound";
-            /**
-             * Whether the use case is enabled
-             */
-            enabled: boolean;
             configuration?: /* Configuration for outbound use cases (epilot to ERP). Structure TBD. */ OutboundIntegrationEventConfiguration;
-            /**
-             * Description of the last change made to this use case
-             */
-            change_description?: string;
-            /**
-             * ISO-8601 timestamp when the use case was created
-             */
-            created_at: string; // date-time
-            /**
-             * ISO-8601 timestamp when the use case was last updated
-             */
-            updated_at: string; // date-time
         }
         export interface OutboundUseCaseHistoryEntry {
             /**
@@ -746,6 +730,12 @@ declare namespace Components {
              * Target attribute name in the related entity
              */
             attribute: string;
+            _type?: /**
+             * Type hint for repeatable fields that require special search handling.
+             * These fields are stored as arrays of objects (e.g., email: [{ email: "value" }]).
+             *
+             */
+            RepeatableFieldType;
             /**
              * Source field name from the event data
              */
@@ -759,6 +749,119 @@ declare namespace Components {
              */
             constant?: any;
         }
+        /**
+         * Type hint for repeatable fields that require special search handling.
+         * These fields are stored as arrays of objects (e.g., email: [{ email: "value" }]).
+         *
+         */
+        export type RepeatableFieldType = "email" | "phone";
+        export interface ReplayEventsRequest {
+            /**
+             * List of event IDs to replay. Maximum 100 events per request.
+             */
+            event_ids: [
+                string,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?,
+                string?
+            ];
+        }
         export interface SetIntegrationAppMappingRequest {
             /**
              * UUID of the integration app instance
@@ -827,6 +930,34 @@ declare namespace Components {
             end_date?: string;
             event_id?: string;
         }
+        /**
+         * Unique identifier field configuration. Can be either:
+         * - A simple string (attribute name)
+         * - An extended object with type hints for repeatable fields
+         *
+         */
+        export type UniqueIdField = /**
+         * Unique identifier field configuration. Can be either:
+         * - A simple string (attribute name)
+         * - An extended object with type hints for repeatable fields
+         *
+         */
+        string | /* Extended unique identifier field configuration with type hints for repeatable fields */ ExtendedUniqueIdField;
+        /**
+         * Metadata about a unique identifier field (used in message payloads)
+         */
+        export interface UniqueIdMetadata {
+            fieldType?: /**
+             * Type hint for repeatable fields that require special search handling.
+             * These fields are stored as arrays of objects (e.g., email: [{ email: "value" }]).
+             *
+             */
+            RepeatableFieldType;
+            /**
+             * Which array item was used (0-indexed)
+             */
+            index?: number;
+        }
         export interface UpdateInboundUseCaseRequest {
             /**
              * Use case name
@@ -890,7 +1021,40 @@ declare namespace Components {
              */
             change_description?: string;
         }
-        export type UseCase = InboundUseCase | OutboundUseCase;
+        export type UseCase = {
+            /**
+             * Unique identifier for the use case
+             */
+            id: string; // uuid
+            /**
+             * Parent integration ID
+             */
+            integrationId: string; // uuid
+            /**
+             * Use case name
+             */
+            name: string;
+            /**
+             * Use case type
+             */
+            type: "inbound" | "outbound";
+            /**
+             * Whether the use case is enabled
+             */
+            enabled: boolean;
+            /**
+             * Description of the last change made to this use case
+             */
+            change_description?: string;
+            /**
+             * ISO-8601 timestamp when the use case was created
+             */
+            created_at: string; // date-time
+            /**
+             * ISO-8601 timestamp when the use case was last updated
+             */
+            updated_at: string; // date-time
+        } & (InboundUseCase | OutboundUseCase);
         export type UseCaseHistoryEntry = InboundUseCaseHistoryEntry | OutboundUseCaseHistoryEntry;
         export interface UseCaseHistoryEntryBase {
             /**
@@ -1180,6 +1344,22 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace ReplayEvents {
+        namespace Parameters {
+            export type IntegrationId = string; // uuid
+        }
+        export interface PathParameters {
+            integrationId: Parameters.IntegrationId /* uuid */;
+        }
+        export type RequestBody = Components.Schemas.ReplayEventsRequest;
+        namespace Responses {
+            export type $200 = Components.Responses.ReplayEventsResponse;
+            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 SetIntegrationAppMapping {
         namespace Parameters {
             export type IntegrationId = string; // uuid
@@ -1408,6 +1588,16 @@ export interface OperationMethods {
     data?: Paths.QueryEvents.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.QueryEvents.Responses.$200>
+  /**
+   * replayEvents - replayEvents
+   * 
+   * Replay one or more events for a specific integration. Events will be re-processed with their original payloads but with a new correlation ID for traceability.
+   */
+  'replayEvents'(
+    parameters?: Parameters<Paths.ReplayEvents.PathParameters> | null,
+    data?: Paths.ReplayEvents.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ReplayEvents.Responses.$200>
   /**
    * listUseCases - listUseCases
    * 
@@ -1649,6 +1839,18 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.QueryEvents.Responses.$200>
   }
+  ['/v1/integrations/{integrationId}/events/replay']: {
+    /**
+     * replayEvents - replayEvents
+     * 
+     * Replay one or more events for a specific integration. Events will be re-processed with their original payloads but with a new correlation ID for traceability.
+     */
+    'post'(
+      parameters?: Parameters<Paths.ReplayEvents.PathParameters> | null,
+      data?: Paths.ReplayEvents.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ReplayEvents.Responses.$200>
+  }
   ['/v1/integrations/{integrationId}/use-cases']: {
     /**
      * listUseCases - listUseCases
@@ -1759,6 +1961,7 @@ export type EntityUpdate = Components.Schemas.EntityUpdate;
 export type ErpEvent = Components.Schemas.ErpEvent;
 export type ErpUpdatesEventsV2Request = Components.Schemas.ErpUpdatesEventsV2Request;
 export type ErrorResponseBase = Components.Schemas.ErrorResponseBase;
+export type ExtendedUniqueIdField = Components.Schemas.ExtendedUniqueIdField;
 export type InboundIntegrationEventConfiguration = Components.Schemas.InboundIntegrationEventConfiguration;
 export type InboundUseCase = Components.Schemas.InboundUseCase;
 export type InboundUseCaseHistoryEntry = Components.Schemas.InboundUseCaseHistoryEntry;
@@ -1786,9 +1989,13 @@ export type RelationRefItemConfig = Components.Schemas.RelationRefItemConfig;
 export type RelationRefValueConfig = Components.Schemas.RelationRefValueConfig;
 export type RelationRefsConfig = Components.Schemas.RelationRefsConfig;
 export type RelationUniqueIdField = Components.Schemas.RelationUniqueIdField;
+export type RepeatableFieldType = Components.Schemas.RepeatableFieldType;
+export type ReplayEventsRequest = Components.Schemas.ReplayEventsRequest;
 export type SetIntegrationAppMappingRequest = Components.Schemas.SetIntegrationAppMappingRequest;
 export type TriggerErpActionRequest = Components.Schemas.TriggerErpActionRequest;
 export type TriggerWebhookResp = Components.Schemas.TriggerWebhookResp;
+export type UniqueIdField = Components.Schemas.UniqueIdField;
+export type UniqueIdMetadata = Components.Schemas.UniqueIdMetadata;
 export type UpdateInboundUseCaseRequest = Components.Schemas.UpdateInboundUseCaseRequest;
 export type UpdateIntegrationRequest = Components.Schemas.UpdateIntegrationRequest;
 export type UpdateOutboundUseCaseRequest = Components.Schemas.UpdateOutboundUseCaseRequest;

package/dist/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "ERP Integration API",
-    "version": "0.15.0",
+    "version": "0.17.0",
     "description": "API for integrating with ERP systems, handling tracking acknowledgments, triggering ERP processes, and processing ERP updates."
   },
   "tags": [
@@ -1154,6 +1154,55 @@
         }
       }
     },
+    "/v1/integrations/{integrationId}/events/replay": {
+      "post": {
+        "operationId": "replayEvents",
+        "summary": "replayEvents",
+        "description": "Replay one or more events for a specific integration. Events will be re-processed with their original payloads but with a new correlation ID for traceability.",
+        "tags": [
+          "integrations"
+        ],
+        "parameters": [
+          {
+            "name": "integrationId",
+            "in": "path",
+            "required": true,
+            "description": "The integration ID",
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ReplayEventsRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "$ref": "#/components/responses/ReplayEventsResponse"
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
     "/v1/integrations/{integrationId}/use-cases": {
       "get": {
         "operationId": "listUseCases",
@@ -1968,23 +2017,6 @@
         }
       },
       "UseCase": {
-        "oneOf": [
-          {
-            "$ref": "#/components/schemas/InboundUseCase"
-          },
-          {
-            "$ref": "#/components/schemas/OutboundUseCase"
-          }
-        ],
-        "discriminator": {
-          "propertyName": "type",
-          "mapping": {
-            "inbound": "#/components/schemas/InboundUseCase",
-            "outbound": "#/components/schemas/OutboundUseCase"
-          }
-        }
-      },
-      "InboundUseCase": {
         "type": "object",
         "required": [
           "id",
@@ -2013,7 +2045,8 @@
           "type": {
             "type": "string",
             "enum": [
-              "inbound"
+              "inbound",
+              "outbound"
             ],
             "description": "Use case type"
           },
@@ -2021,9 +2054,6 @@
             "type": "boolean",
             "description": "Whether the use case is enabled"
           },
-          "configuration": {
-            "$ref": "#/components/schemas/InboundIntegrationEventConfiguration"
-          },
           "change_description": {
             "type": "string",
             "maxLength": 2000,
@@ -2039,34 +2069,47 @@
             "format": "date-time",
             "description": "ISO-8601 timestamp when the use case was last updated"
           }
+        },
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InboundUseCase"
+          },
+          {
+            "$ref": "#/components/schemas/OutboundUseCase"
+          }
+        ],
+        "discriminator": {
+          "propertyName": "type",
+          "mapping": {
+            "inbound": "#/components/schemas/InboundUseCase",
+            "outbound": "#/components/schemas/OutboundUseCase"
+          }
         }
       },
-      "OutboundUseCase": {
+      "InboundUseCase": {
         "type": "object",
         "required": [
-          "id",
-          "integrationId",
-          "name",
-          "type",
-          "enabled",
-          "created_at",
-          "updated_at"
+          "type"
         ],
         "properties": {
-          "id": {
-            "type": "string",
-            "format": "uuid",
-            "description": "Unique identifier for the use case"
-          },
-          "integrationId": {
-            "type": "string",
-            "format": "uuid",
-            "description": "Parent integration ID"
-          },
-          "name": {
+          "type": {
             "type": "string",
-            "description": "Use case name"
+            "enum": [
+              "inbound"
+            ],
+            "description": "Use case type"
           },
+          "configuration": {
+            "$ref": "#/components/schemas/InboundIntegrationEventConfiguration"
+          }
+        }
+      },
+      "OutboundUseCase": {
+        "type": "object",
+        "required": [
+          "type"
+        ],
+        "properties": {
           "type": {
             "type": "string",
             "enum": [
@@ -2074,27 +2117,8 @@
             ],
             "description": "Use case type"
           },
-          "enabled": {
-            "type": "boolean",
-            "description": "Whether the use case is enabled"
-          },
           "configuration": {
             "$ref": "#/components/schemas/OutboundIntegrationEventConfiguration"
-          },
-          "change_description": {
-            "type": "string",
-            "maxLength": 2000,
-            "description": "Description of the last change made to this use case"
-          },
-          "created_at": {
-            "type": "string",
-            "format": "date-time",
-            "description": "ISO-8601 timestamp when the use case was created"
-          },
-          "updated_at": {
-            "type": "string",
-            "format": "date-time",
-            "description": "ISO-8601 timestamp when the use case was last updated"
           }
         }
       },
@@ -2724,7 +2748,7 @@
             "items": {
               "type": "string"
             },
-            "description": "Array of attribute names that uniquely identify this entity"
+            "description": "Array of attribute names that uniquely identify this entity.\nThe _type hint for repeatable fields (e.g., email, phone) should be specified\non the corresponding field definition in the fields array.\n"
           },
           "jsonataExpression": {
             "type": "string",
@@ -2814,6 +2838,10 @@
           "constant": {
             "description": "Constant value to assign (any type)"
           },
+          "_type": {
+            "$ref": "#/components/schemas/RepeatableFieldType",
+            "description": "Type hint for repeatable fields (email, phone).\nWhen this attribute is used as a unique identifier, specifying the _type\nenables correct search path generation (e.g., email.email.keyword).\n"
+          },
           "enabled": {
             "oneOf": [
               {
@@ -2898,6 +2926,9 @@
             "type": "string",
             "description": "Target attribute name in the related entity"
           },
+          "_type": {
+            "$ref": "#/components/schemas/RepeatableFieldType"
+          },
           "field": {
             "type": "string",
             "description": "Source field name from the event data"
@@ -3003,6 +3034,79 @@
           }
         }
       },
+      "RepeatableFieldType": {
+        "type": "string",
+        "enum": [
+          "email",
+          "phone"
+        ],
+        "description": "Type hint for repeatable fields that require special search handling.\nThese fields are stored as arrays of objects (e.g., email: [{ email: \"value\" }]).\n"
+      },
+      "ExtendedUniqueIdField": {
+        "type": "object",
+        "description": "Extended unique identifier field configuration with type hints for repeatable fields",
+        "required": [
+          "attribute"
+        ],
+        "properties": {
+          "attribute": {
+            "type": "string",
+            "description": "The attribute name to use as unique identifier"
+          },
+          "_type": {
+            "$ref": "#/components/schemas/RepeatableFieldType"
+          },
+          "index": {
+            "type": "integer",
+            "default": 0,
+            "minimum": 0,
+            "description": "Which array item to use (0-indexed, default first)"
+          }
+        }
+      },
+      "UniqueIdField": {
+        "description": "Unique identifier field configuration. Can be either:\n- A simple string (attribute name)\n- An extended object with type hints for repeatable fields\n",
+        "oneOf": [
+          {
+            "type": "string",
+            "description": "Simple attribute name"
+          },
+          {
+            "$ref": "#/components/schemas/ExtendedUniqueIdField"
+          }
+        ]
+      },
+      "UniqueIdMetadata": {
+        "type": "object",
+        "description": "Metadata about a unique identifier field (used in message payloads)",
+        "properties": {
+          "fieldType": {
+            "$ref": "#/components/schemas/RepeatableFieldType"
+          },
+          "index": {
+            "type": "integer",
+            "default": 0,
+            "description": "Which array item was used (0-indexed)"
+          }
+        }
+      },
+      "ReplayEventsRequest": {
+        "type": "object",
+        "required": [
+          "event_ids"
+        ],
+        "properties": {
+          "event_ids": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "minItems": 1,
+            "maxItems": 100,
+            "description": "List of event IDs to replay. Maximum 100 events per request."
+          }
+        }
+      },
       "QueryEventsRequest": {
         "type": "object",
         "properties": {
@@ -3096,6 +3200,29 @@
           }
         }
       },
+      "ReplayEventsResponse": {
+        "description": "Events replay initiated",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "required": [
+                "replayed",
+                "results"
+              ],
+              "properties": {
+                "event_ids": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "List of event IDs for which replay was requested"
+                }
+              }
+            }
+          }
+        }
+      },
       "ERPUpdatesResponse": {
         "description": "Some events failed to process",
         "content": {
@@ -3165,7 +3292,7 @@
                   "nullable": true,
                   "description": "Cursor to fetch the next page. Null if no more results.",
                   "properties": {
-                    "created_at": {
+                    "event_time": {
                       "type": "string",
                       "format": "date-time",
                       "example": "2025-10-31T12:34:56Z"

package/package.json

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