@epilot/erp-integration-client 0.8.0 → 0.10.0

package/dist/definition.js

@@ -1 +1 @@
-(()=>{"use strict";var e={330:function(e,t,r){var n=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0});var s=n(r(466));t.default=s.default},466:e=>{e.exports=JSON.parse('{"openapi":"3.0.3","info":{"title":"","version":""},"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":{}}},"/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}/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":{}}},"Unauthorized":{"content":{"application/json":{}}},"InternalServerError":{"content":{"application/json":{}}},"ERPUpdatesResponse":{"content":{"application/json":{}}},"TriggerWebhookResponse":{"content":{"application/json":{}}}}}}')}},t={},r=function r(n){var s=t[n];if(void 0!==s)return s.exports;var a=t[n]={exports:{}};return e[n].call(a.exports,a,a.exports,r),a.exports}(330),n=exports;for(var s in r)n[s]=r[s];r.__esModule&&Object.defineProperty(n,"__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 s=r(n(466));t.default=s.default},466:e=>{e.exports=JSON.parse('{"openapi":"3.0.3","info":{"title":"","version":""},"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}/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":{}}},"Unauthorized":{"content":{"application/json":{}}},"InternalServerError":{"content":{"application/json":{}}},"ERPUpdatesResponse":{"content":{"application/json":{}}},"TriggerWebhookResponse":{"content":{"application/json":{}}}}}}')}},t={},n=function n(r){var s=t[r];if(void 0!==s)return s.exports;var a=t[r]={exports:{}};return e[r].call(a.exports,a,a.exports,n),a.exports}(330),r=exports;for(var s in n)r[s]=n[s];n.__esModule&&Object.defineProperty(r,"__esModule",{value:!0})})();

package/dist/openapi-runtime.json

@@ -50,6 +50,18 @@
         "responses": {}
       }
     },
+    "/v2/erp/updates/mapping_simulation": {
+      "post": {
+        "operationId": "simulateMappingV2",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {}
+          }
+        },
+        "responses": {}
+      }
+    },
     "/v1/erp/updates/mapping_simulation": {
       "post": {
         "operationId": "simulateMapping",

package/dist/openapi.d.ts

@@ -358,6 +358,13 @@ declare namespace Components {
              */
             enabled?: /* 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. */ boolean | string;
             relations?: RelationConfig;
+            relation_refs?: /**
+             * Configuration for relation references ($relation_ref).
+             * Relation references link to a specific item within a repeatable attribute on a related entity.
+             * Common use case: referencing a specific address within a contact's address list.
+             *
+             */
+            RelationRefsConfig;
         }
         export interface IntegrationFieldV1 {
             /**
@@ -427,6 +434,24 @@ declare namespace Components {
             entity_updates: EntityUpdate[];
             meter_readings_updates?: MeterReadingUpdate[];
         }
+        /**
+         * Request for v2 mapping simulation. Uses the same configuration format stored in integration use case resources,
+         * making it easier to test configurations before saving them.
+         *
+         */
+        export interface MappingSimulationV2Request {
+            event_configuration: /* Configuration for inbound use cases (ERP to epilot) */ InboundIntegrationEventConfiguration;
+            /**
+             * Format of the payload data
+             */
+            format: "json" | "xml";
+            /**
+             * The event data payload - can be either a serialized string or a direct JSON object
+             */
+            payload: /* The event data payload - can be either a serialized string or a direct JSON object */ string | {
+                [name: string]: any;
+            };
+        }
         export interface MeterReadingUpdate {
             meter: {
                 /**
@@ -548,10 +573,11 @@ declare namespace Components {
             /**
              * Relation operation:
              * - '_set': Replace all existing relations with the specified items
-             * - '_append': Add new items to existing relations (fetches current entity first)
+             * - '_append': Add new unique items to existing relations (deduplicates by entity_id)
+             * - '_append_all': Add all items to existing relations (no deduplication, allows duplicates)
              *
              */
-            operation: "_set" | "_append";
+            operation: "_set" | "_append" | "_append_all";
             /**
              * Array of relation item configurations
              */
@@ -575,6 +601,77 @@ declare namespace Components {
              */
             unique_ids: RelationUniqueIdField[];
         }
+        /**
+         * Configuration for a single relation reference item
+         */
+        export interface RelationRefItemConfig {
+            /**
+             * Schema of the related entity (e.g., "contact")
+             */
+            entity_schema: string;
+            /**
+             * Unique identifier mappings for the related entity
+             */
+            unique_ids: RelationUniqueIdField[];
+            /**
+             * Attribute path on the related entity (e.g., "address")
+             */
+            path: string;
+            value: /* Configuration for the value to set on the related entity's attribute */ RelationRefValueConfig;
+        }
+        /**
+         * Configuration for the value to set on the related entity's attribute
+         */
+        export interface RelationRefValueConfig {
+            /**
+             * Target attribute name on the related entity
+             */
+            attribute: string;
+            /**
+             * Operation for the attribute value:
+             * - '_set': Replace the attribute value
+             * - '_append': Add new unique items (deduplicates)
+             * - '_append_all': Add all items (no deduplication)
+             *
+             */
+            operation?: "_set" | "_append" | "_append_all";
+            /**
+             * Source field name from the event data
+             */
+            field?: string;
+            /**
+             * JSONata expression to compute the value
+             */
+            jsonataExpression?: string;
+            /**
+             * Constant value (any type)
+             */
+            constant?: any;
+        }
+        /**
+         * Configuration for relation references ($relation_ref).
+         * Relation references link to a specific item within a repeatable attribute on a related entity.
+         * Common use case: referencing a specific address within a contact's address list.
+         *
+         */
+        export interface RelationRefsConfig {
+            /**
+             * Relation reference operation:
+             * - '_set': Replace all existing relation_refs with the specified items
+             * - '_append': Add new unique items to existing relation_refs (deduplicates by entity_id + _id)
+             * - '_append_all': Add all items to existing relation_refs (no deduplication, allows duplicates)
+             *
+             */
+            operation: "_set" | "_append" | "_append_all";
+            /**
+             * Array of relation reference item configurations
+             */
+            items?: /* Configuration for a single relation reference item */ RelationRefItemConfig[];
+            /**
+             * JSONata expression that returns relation_ref items array (alternative to 'items')
+             */
+            jsonataExpression?: string;
+        }
         export interface RelationUniqueIdField {
             /**
              * Target attribute name in the related entity
@@ -1026,6 +1123,21 @@ declare namespace Paths {
             export type $500 = Components.Responses.InternalServerError;
         }
     }
+    namespace SimulateMappingV2 {
+        export type RequestBody = /**
+         * Request for v2 mapping simulation. Uses the same configuration format stored in integration use case resources,
+         * making it easier to test configurations before saving them.
+         *
+         */
+        Components.Schemas.MappingSimulationV2Request;
+        namespace Responses {
+            export type $200 = Components.Schemas.MappingSimulationResponse;
+            export type $400 = Components.Responses.BadRequest;
+            export type $401 = Components.Responses.Unauthorized;
+            export type $422 = Components.Schemas.ErrorResponseBase;
+            export type $500 = Components.Responses.InternalServerError;
+        }
+    }
     namespace TriggerErp {
         export type RequestBody = Components.Schemas.TriggerErpActionRequest;
         namespace Responses {
@@ -1121,6 +1233,22 @@ export interface OperationMethods {
     data?: Paths.ProcessErpUpdatesEventsV2.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.ProcessErpUpdatesEventsV2.Responses.$200>
+  /**
+   * simulateMappingV2 - simulateMappingV2
+   * 
+   * Test v2.0 mapping configuration by transforming a payload using the provided mapping rules without persisting data.
+   * 
+   * This endpoint accepts the same configuration format that is stored in the integration use case resource,
+   * making it easier to test configurations before saving them to a use case.
+   * 
+   * See documentation at /docs/MAPPING_V2.md for detailed v2.0 format specification.
+   * 
+   */
+  'simulateMappingV2'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.SimulateMappingV2.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.SimulateMappingV2.Responses.$200>
   /**
    * simulateMapping - simulateMapping
    * 
@@ -1136,7 +1264,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.SimulateMapping.Responses.$200>
   /**
-   * listIntegrations - List all integrations
+   * listIntegrations - listIntegrations
    * 
    * Retrieve all integrations for the authenticated organization
    */
@@ -1146,7 +1274,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.ListIntegrations.Responses.$200>
   /**
-   * createIntegration - Create a new integration
+   * createIntegration - createIntegration
    * 
    * Create a new integration configuration
    */
@@ -1156,7 +1284,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.CreateIntegration.Responses.$201>
   /**
-   * getIntegration - Get an integration by ID
+   * getIntegration - getIntegration
    * 
    * Retrieve a specific integration by its ID
    */
@@ -1166,7 +1294,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetIntegration.Responses.$200>
   /**
-   * updateIntegration - Update an integration
+   * updateIntegration - updateIntegration
    * 
    * Update an existing integration configuration
    */
@@ -1176,7 +1304,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.UpdateIntegration.Responses.$200>
   /**
-   * deleteIntegration - Delete an integration
+   * deleteIntegration - deleteIntegration
    * 
    * Delete an integration and all its use cases
    */
@@ -1186,7 +1314,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.DeleteIntegration.Responses.$200>
   /**
-   * listUseCases - List all use cases for an integration
+   * listUseCases - listUseCases
    * 
    * Retrieve all use cases for a specific integration
    */
@@ -1196,7 +1324,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.ListUseCases.Responses.$200>
   /**
-   * createUseCase - Create a new use case
+   * createUseCase - createUseCase
    * 
    * Create a new use case for an integration
    */
@@ -1206,7 +1334,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.CreateUseCase.Responses.$201>
   /**
-   * getUseCase - Get a use case by ID
+   * getUseCase - getUseCase
    * 
    * Retrieve a specific use case by its ID
    */
@@ -1216,7 +1344,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GetUseCase.Responses.$200>
   /**
-   * updateUseCase - Update a use case
+   * updateUseCase - updateUseCase
    * 
    * Update an existing use case configuration
    */
@@ -1226,7 +1354,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.UpdateUseCase.Responses.$200>
   /**
-   * deleteUseCase - Delete a use case
+   * deleteUseCase - deleteUseCase
    * 
    * Delete a use case from an integration
    */
@@ -1236,7 +1364,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.DeleteUseCase.Responses.$200>
   /**
-   * listUseCaseHistory - List use case configuration history
+   * listUseCaseHistory - listUseCaseHistory
    * 
    * Retrieve historical versions of a use case's configuration.
    * History entries are returned in reverse chronological order (newest first).
@@ -1249,7 +1377,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.ListUseCaseHistory.Responses.$200>
   /**
-   * setIntegrationAppMapping - Set integration app mapping
+   * setIntegrationAppMapping - setIntegrationAppMapping
    * 
    * Creates or updates a mapping from an app/component to an integration.
    * This allows ERP updates sent via app_id and component_id to be associated
@@ -1262,7 +1390,7 @@ export interface OperationMethods {
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.SetIntegrationAppMapping.Responses.$200>
   /**
-   * deleteIntegrationAppMapping - Delete integration app mapping
+   * deleteIntegrationAppMapping - deleteIntegrationAppMapping
    * 
    * Removes a mapping from an app/component to an integration.
    * 
@@ -1326,6 +1454,24 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.ProcessErpUpdatesEventsV2.Responses.$200>
   }
+  ['/v2/erp/updates/mapping_simulation']: {
+    /**
+     * simulateMappingV2 - simulateMappingV2
+     * 
+     * Test v2.0 mapping configuration by transforming a payload using the provided mapping rules without persisting data.
+     * 
+     * This endpoint accepts the same configuration format that is stored in the integration use case resource,
+     * making it easier to test configurations before saving them to a use case.
+     * 
+     * See documentation at /docs/MAPPING_V2.md for detailed v2.0 format specification.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.SimulateMappingV2.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.SimulateMappingV2.Responses.$200>
+  }
   ['/v1/erp/updates/mapping_simulation']: {
     /**
      * simulateMapping - simulateMapping
@@ -1344,7 +1490,7 @@ export interface PathsDictionary {
   }
   ['/v1/integrations']: {
     /**
-     * listIntegrations - List all integrations
+     * listIntegrations - listIntegrations
      * 
      * Retrieve all integrations for the authenticated organization
      */
@@ -1354,7 +1500,7 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.ListIntegrations.Responses.$200>
     /**
-     * createIntegration - Create a new integration
+     * createIntegration - createIntegration
      * 
      * Create a new integration configuration
      */
@@ -1366,7 +1512,7 @@ export interface PathsDictionary {
   }
   ['/v1/integrations/{integrationId}']: {
     /**
-     * getIntegration - Get an integration by ID
+     * getIntegration - getIntegration
      * 
      * Retrieve a specific integration by its ID
      */
@@ -1376,7 +1522,7 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetIntegration.Responses.$200>
     /**
-     * updateIntegration - Update an integration
+     * updateIntegration - updateIntegration
      * 
      * Update an existing integration configuration
      */
@@ -1386,7 +1532,7 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.UpdateIntegration.Responses.$200>
     /**
-     * deleteIntegration - Delete an integration
+     * deleteIntegration - deleteIntegration
      * 
      * Delete an integration and all its use cases
      */
@@ -1398,7 +1544,7 @@ export interface PathsDictionary {
   }
   ['/v1/integrations/{integrationId}/use-cases']: {
     /**
-     * listUseCases - List all use cases for an integration
+     * listUseCases - listUseCases
      * 
      * Retrieve all use cases for a specific integration
      */
@@ -1408,7 +1554,7 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.ListUseCases.Responses.$200>
     /**
-     * createUseCase - Create a new use case
+     * createUseCase - createUseCase
      * 
      * Create a new use case for an integration
      */
@@ -1420,7 +1566,7 @@ export interface PathsDictionary {
   }
   ['/v1/integrations/{integrationId}/use-cases/{useCaseId}']: {
     /**
-     * getUseCase - Get a use case by ID
+     * getUseCase - getUseCase
      * 
      * Retrieve a specific use case by its ID
      */
@@ -1430,7 +1576,7 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GetUseCase.Responses.$200>
     /**
-     * updateUseCase - Update a use case
+     * updateUseCase - updateUseCase
      * 
      * Update an existing use case configuration
      */
@@ -1440,7 +1586,7 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.UpdateUseCase.Responses.$200>
     /**
-     * deleteUseCase - Delete a use case
+     * deleteUseCase - deleteUseCase
      * 
      * Delete a use case from an integration
      */
@@ -1452,7 +1598,7 @@ export interface PathsDictionary {
   }
   ['/v1/integrations/{integrationId}/use-cases/{useCaseId}/history']: {
     /**
-     * listUseCaseHistory - List use case configuration history
+     * listUseCaseHistory - listUseCaseHistory
      * 
      * Retrieve historical versions of a use case's configuration.
      * History entries are returned in reverse chronological order (newest first).
@@ -1467,7 +1613,7 @@ export interface PathsDictionary {
   }
   ['/v1/integrations/{integrationId}/app-mapping']: {
     /**
-     * setIntegrationAppMapping - Set integration app mapping
+     * setIntegrationAppMapping - setIntegrationAppMapping
      * 
      * Creates or updates a mapping from an app/component to an integration.
      * This allows ERP updates sent via app_id and component_id to be associated
@@ -1480,7 +1626,7 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.SetIntegrationAppMapping.Responses.$200>
     /**
-     * deleteIntegrationAppMapping - Delete integration app mapping
+     * deleteIntegrationAppMapping - deleteIntegrationAppMapping
      * 
      * Removes a mapping from an app/component to an integration.
      * 
@@ -1520,6 +1666,7 @@ export type IntegrationMeterReading = Components.Schemas.IntegrationMeterReading
 export type IntegrationObjectV1 = Components.Schemas.IntegrationObjectV1;
 export type MappingSimulationRequest = Components.Schemas.MappingSimulationRequest;
 export type MappingSimulationResponse = Components.Schemas.MappingSimulationResponse;
+export type MappingSimulationV2Request = Components.Schemas.MappingSimulationV2Request;
 export type MeterReadingUpdate = Components.Schemas.MeterReadingUpdate;
 export type MeterUniqueIdsConfig = Components.Schemas.MeterUniqueIdsConfig;
 export type OutboundIntegrationEventConfiguration = Components.Schemas.OutboundIntegrationEventConfiguration;
@@ -1527,6 +1674,9 @@ export type OutboundUseCase = Components.Schemas.OutboundUseCase;
 export type OutboundUseCaseHistoryEntry = Components.Schemas.OutboundUseCaseHistoryEntry;
 export type RelationConfig = Components.Schemas.RelationConfig;
 export type RelationItemConfig = Components.Schemas.RelationItemConfig;
+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 SetIntegrationAppMappingRequest = Components.Schemas.SetIntegrationAppMappingRequest;
 export type TriggerErpActionRequest = Components.Schemas.TriggerErpActionRequest;

package/dist/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "ERP Integration API",
-    "version": "0.13.0",
+    "version": "0.15.0",
     "description": "API for integrating with ERP systems, handling tracking acknowledgments, triggering ERP processes, and processing ERP updates."
   },
   "tags": [
@@ -272,6 +272,277 @@
         }
       }
     },
+    "/v2/erp/updates/mapping_simulation": {
+      "post": {
+        "operationId": "simulateMappingV2",
+        "summary": "simulateMappingV2",
+        "description": "Test v2.0 mapping configuration by transforming a payload using the provided mapping rules without persisting data.\n\nThis endpoint accepts the same configuration format that is stored in the integration use case resource,\nmaking it easier to test configurations before saving them to a use case.\n\nSee documentation at /docs/MAPPING_V2.md for detailed v2.0 format specification.\n",
+        "tags": [
+          "erp"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/MappingSimulationV2Request"
+              },
+              "examples": {
+                "simple": {
+                  "summary": "Simple Example",
+                  "value": {
+                    "event_configuration": {
+                      "entities": [
+                        {
+                          "entity_schema": "contact",
+                          "unique_ids": [
+                            "customer_number"
+                          ],
+                          "fields": [
+                            {
+                              "attribute": "customer_number",
+                              "field": "customerId"
+                            },
+                            {
+                              "attribute": "first_name",
+                              "field": "firstName"
+                            },
+                            {
+                              "attribute": "last_name",
+                              "field": "lastName"
+                            },
+                            {
+                              "attribute": "email",
+                              "field": "email"
+                            },
+                            {
+                              "attribute": "source",
+                              "constant": "ERP"
+                            }
+                          ]
+                        }
+                      ]
+                    },
+                    "format": "json",
+                    "payload": "{\"customerId\":\"12345\",\"firstName\":\"Anna\",\"lastName\":\"Schmidt\",\"email\":\"anna@example.com\"}"
+                  }
+                },
+                "advanced_with_relations": {
+                  "summary": "Advanced with Relations",
+                  "value": {
+                    "event_configuration": {
+                      "entities": [
+                        {
+                          "entity_schema": "contract",
+                          "unique_ids": [
+                            "contract_number"
+                          ],
+                          "fields": [
+                            {
+                              "attribute": "contract_number",
+                              "field": "number"
+                            },
+                            {
+                              "attribute": "display_name",
+                              "field": "displayName"
+                            },
+                            {
+                              "attribute": "billing_account",
+                              "relations": {
+                                "operation": "_set",
+                                "items": [
+                                  {
+                                    "entity_schema": "billing_account",
+                                    "_tags": [
+                                      "PRIMARY"
+                                    ],
+                                    "unique_ids": [
+                                      {
+                                        "attribute": "external_id",
+                                        "field": "customerAccountId"
+                                      }
+                                    ]
+                                  }
+                                ]
+                              }
+                            }
+                          ]
+                        },
+                        {
+                          "entity_schema": "meter",
+                          "unique_ids": [
+                            "meter_number"
+                          ],
+                          "jsonataExpression": "meters.{\"number\": number, \"type\": meterType}",
+                          "fields": [
+                            {
+                              "attribute": "meter_number",
+                              "field": "number"
+                            },
+                            {
+                              "attribute": "meter_type",
+                              "field": "type"
+                            }
+                          ]
+                        }
+                      ]
+                    },
+                    "format": "json",
+                    "payload": "{\"number\":\"CTR-001\",\"displayName\":\"Premium Contract\",\"customerAccountId\":\"ACC-999\",\"meters\":[{\"number\":\"M-001\",\"meterType\":\"electricity\"},{\"number\":\"M-002\",\"meterType\":\"gas\"}]}"
+                  }
+                },
+                "with_meter_readings": {
+                  "summary": "With Meter Readings",
+                  "value": {
+                    "event_configuration": {
+                      "entities": [
+                        {
+                          "entity_schema": "contract",
+                          "unique_ids": [
+                            "contract_number"
+                          ],
+                          "fields": [
+                            {
+                              "attribute": "contract_number",
+                              "field": "number"
+                            },
+                            {
+                              "attribute": "display_name",
+                              "field": "name"
+                            }
+                          ]
+                        }
+                      ],
+                      "meter_readings": [
+                        {
+                          "jsonataExpression": "$.readings",
+                          "meter": {
+                            "unique_ids": [
+                              {
+                                "attribute": "external_id",
+                                "field": "meter_id"
+                              }
+                            ]
+                          },
+                          "fields": [
+                            {
+                              "attribute": "external_id",
+                              "field": "reading_id"
+                            },
+                            {
+                              "attribute": "timestamp",
+                              "field": "read_at"
+                            },
+                            {
+                              "attribute": "source",
+                              "constant": "ERP"
+                            },
+                            {
+                              "attribute": "value",
+                              "field": "value"
+                            }
+                          ]
+                        }
+                      ]
+                    },
+                    "format": "json",
+                    "payload": "{\"number\":\"CTR-001\",\"name\":\"Main Contract\",\"readings\":[{\"meter_id\":\"M-001\",\"reading_id\":\"R-001\",\"read_at\":\"2025-01-15T10:00:00Z\",\"value\":12345.6}]}"
+                  }
+                },
+                "conditional_fields": {
+                  "summary": "Conditional Field Processing",
+                  "description": "Example showing how to conditionally enable/disable individual field mappings",
+                  "value": {
+                    "event_configuration": {
+                      "entities": [
+                        {
+                          "entity_schema": "contact",
+                          "unique_ids": [
+                            "customer_number"
+                          ],
+                          "fields": [
+                            {
+                              "attribute": "customer_number",
+                              "field": "customerId"
+                            },
+                            {
+                              "attribute": "email",
+                              "field": "email",
+                              "enabled": "$exists(email) and email != ''"
+                            },
+                            {
+                              "attribute": "phone",
+                              "field": "phone",
+                              "enabled": "$exists(phone) and phone != ''"
+                            },
+                            {
+                              "attribute": "vip_status",
+                              "constant": "VIP",
+                              "enabled": "vipFlag = true"
+                            },
+                            {
+                              "attribute": "billing_account",
+                              "enabled": "$exists(billingAccountId)",
+                              "relations": {
+                                "operation": "_set",
+                                "items": [
+                                  {
+                                    "entity_schema": "billing_account",
+                                    "unique_ids": [
+                                      {
+                                        "attribute": "external_id",
+                                        "field": "billingAccountId"
+                                      }
+                                    ]
+                                  }
+                                ]
+                              }
+                            }
+                          ]
+                        }
+                      ]
+                    },
+                    "format": "json",
+                    "payload": "{\"customerId\":\"12345\",\"email\":\"user@example.com\",\"phone\":\"\",\"vipFlag\":true,\"billingAccountId\":\"ACC-999\"}"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Successfully simulated mapping",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/MappingSimulationResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "422": {
+            "description": "Unprocessable entity - mapping configuration or payload validation failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponseBase"
+                }
+              }
+            }
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
     "/v1/erp/updates/mapping_simulation": {
       "post": {
         "operationId": "simulateMapping",
@@ -608,7 +879,7 @@
     "/v1/integrations": {
       "get": {
         "operationId": "listIntegrations",
-        "summary": "List all integrations",
+        "summary": "listIntegrations",
         "description": "Retrieve all integrations for the authenticated organization",
         "tags": [
           "integrations"
@@ -645,7 +916,7 @@
       },
       "post": {
         "operationId": "createIntegration",
-        "summary": "Create a new integration",
+        "summary": "createIntegration",
         "description": "Create a new integration configuration",
         "tags": [
           "integrations"
@@ -686,7 +957,7 @@
     "/v1/integrations/{integrationId}": {
       "get": {
         "operationId": "getIntegration",
-        "summary": "Get an integration by ID",
+        "summary": "getIntegration",
         "description": "Retrieve a specific integration by its ID",
         "tags": [
           "integrations"
@@ -727,7 +998,7 @@
       },
       "put": {
         "operationId": "updateIntegration",
-        "summary": "Update an integration",
+        "summary": "updateIntegration",
         "description": "Update an existing integration configuration",
         "tags": [
           "integrations"
@@ -781,7 +1052,7 @@
       },
       "delete": {
         "operationId": "deleteIntegration",
-        "summary": "Delete an integration",
+        "summary": "deleteIntegration",
         "description": "Delete an integration and all its use cases",
         "tags": [
           "integrations"
@@ -829,7 +1100,7 @@
     "/v1/integrations/{integrationId}/use-cases": {
       "get": {
         "operationId": "listUseCases",
-        "summary": "List all use cases for an integration",
+        "summary": "listUseCases",
         "description": "Retrieve all use cases for a specific integration",
         "tags": [
           "integrations"
@@ -878,7 +1149,7 @@
       },
       "post": {
         "operationId": "createUseCase",
-        "summary": "Create a new use case",
+        "summary": "createUseCase",
         "description": "Create a new use case for an integration",
         "tags": [
           "integrations"
@@ -934,7 +1205,7 @@
     "/v1/integrations/{integrationId}/use-cases/{useCaseId}": {
       "get": {
         "operationId": "getUseCase",
-        "summary": "Get a use case by ID",
+        "summary": "getUseCase",
         "description": "Retrieve a specific use case by its ID",
         "tags": [
           "integrations"
@@ -985,7 +1256,7 @@
       },
       "put": {
         "operationId": "updateUseCase",
-        "summary": "Update a use case",
+        "summary": "updateUseCase",
         "description": "Update an existing use case configuration",
         "tags": [
           "integrations"
@@ -1049,7 +1320,7 @@
       },
       "delete": {
         "operationId": "deleteUseCase",
-        "summary": "Delete a use case",
+        "summary": "deleteUseCase",
         "description": "Delete a use case from an integration",
         "tags": [
           "integrations"
@@ -1107,7 +1378,7 @@
     "/v1/integrations/{integrationId}/use-cases/{useCaseId}/history": {
       "get": {
         "operationId": "listUseCaseHistory",
-        "summary": "List use case configuration history",
+        "summary": "listUseCaseHistory",
         "description": "Retrieve historical versions of a use case's configuration.\nHistory entries are returned in reverse chronological order (newest first).\nUse the 'cursor' parameter for pagination to fetch additional entries.\n",
         "tags": [
           "integrations"
@@ -1186,7 +1457,7 @@
     "/v1/integrations/{integrationId}/app-mapping": {
       "put": {
         "operationId": "setIntegrationAppMapping",
-        "summary": "Set integration app mapping",
+        "summary": "setIntegrationAppMapping",
         "description": "Creates or updates a mapping from an app/component to an integration.\nThis allows ERP updates sent via app_id and component_id to be associated\nwith a specific integration configuration.\n",
         "tags": [
           "integrations"
@@ -1250,7 +1521,7 @@
       },
       "delete": {
         "operationId": "deleteIntegrationAppMapping",
-        "summary": "Delete integration app mapping",
+        "summary": "deleteIntegrationAppMapping",
         "description": "Removes a mapping from an app/component to an integration.\n",
         "tags": [
           "integrations"
@@ -2111,6 +2382,43 @@
           }
         }
       },
+      "MappingSimulationV2Request": {
+        "type": "object",
+        "description": "Request for v2 mapping simulation. Uses the same configuration format stored in integration use case resources,\nmaking it easier to test configurations before saving them.\n",
+        "required": [
+          "event_configuration",
+          "format",
+          "payload"
+        ],
+        "properties": {
+          "event_configuration": {
+            "$ref": "#/components/schemas/InboundIntegrationEventConfiguration"
+          },
+          "format": {
+            "type": "string",
+            "enum": [
+              "json",
+              "xml"
+            ],
+            "default": "json",
+            "description": "Format of the payload data"
+          },
+          "payload": {
+            "oneOf": [
+              {
+                "type": "string",
+                "description": "The serialized event data payload (JSON, XML, etc.) as a string"
+              },
+              {
+                "type": "object",
+                "description": "Direct JSON object (will be automatically serialized)",
+                "additionalProperties": true
+              }
+            ],
+            "description": "The event data payload - can be either a serialized string or a direct JSON object"
+          }
+        }
+      },
       "MappingSimulationResponse": {
         "type": "object",
         "required": [
@@ -2462,6 +2770,9 @@
           },
           "relations": {
             "$ref": "#/components/schemas/RelationConfig"
+          },
+          "relation_refs": {
+            "$ref": "#/components/schemas/RelationRefsConfig"
           }
         }
       },
@@ -2475,9 +2786,10 @@
             "type": "string",
             "enum": [
               "_set",
-              "_append"
+              "_append",
+              "_append_all"
             ],
-            "description": "Relation operation:\n- '_set': Replace all existing relations with the specified items\n- '_append': Add new items to existing relations (fetches current entity first)\n"
+            "description": "Relation operation:\n- '_set': Replace all existing relations with the specified items\n- '_append': Add new unique items to existing relations (deduplicates by entity_id)\n- '_append_all': Add all items to existing relations (no deduplication, allows duplicates)\n"
           },
           "items": {
             "type": "array",
@@ -2541,6 +2853,98 @@
             "description": "Constant value (any type)"
           }
         }
+      },
+      "RelationRefsConfig": {
+        "type": "object",
+        "description": "Configuration for relation references ($relation_ref).\nRelation references link to a specific item within a repeatable attribute on a related entity.\nCommon use case: referencing a specific address within a contact's address list.\n",
+        "required": [
+          "operation"
+        ],
+        "properties": {
+          "operation": {
+            "type": "string",
+            "enum": [
+              "_set",
+              "_append",
+              "_append_all"
+            ],
+            "description": "Relation reference operation:\n- '_set': Replace all existing relation_refs with the specified items\n- '_append': Add new unique items to existing relation_refs (deduplicates by entity_id + _id)\n- '_append_all': Add all items to existing relation_refs (no deduplication, allows duplicates)\n"
+          },
+          "items": {
+            "type": "array",
+            "description": "Array of relation reference item configurations",
+            "items": {
+              "$ref": "#/components/schemas/RelationRefItemConfig"
+            }
+          },
+          "jsonataExpression": {
+            "type": "string",
+            "description": "JSONata expression that returns relation_ref items array (alternative to 'items')"
+          }
+        }
+      },
+      "RelationRefItemConfig": {
+        "type": "object",
+        "description": "Configuration for a single relation reference item",
+        "required": [
+          "entity_schema",
+          "unique_ids",
+          "path",
+          "value"
+        ],
+        "properties": {
+          "entity_schema": {
+            "type": "string",
+            "description": "Schema of the related entity (e.g., \"contact\")"
+          },
+          "unique_ids": {
+            "type": "array",
+            "description": "Unique identifier mappings for the related entity",
+            "items": {
+              "$ref": "#/components/schemas/RelationUniqueIdField"
+            }
+          },
+          "path": {
+            "type": "string",
+            "description": "Attribute path on the related entity (e.g., \"address\")"
+          },
+          "value": {
+            "$ref": "#/components/schemas/RelationRefValueConfig"
+          }
+        }
+      },
+      "RelationRefValueConfig": {
+        "type": "object",
+        "description": "Configuration for the value to set on the related entity's attribute",
+        "required": [
+          "attribute"
+        ],
+        "properties": {
+          "attribute": {
+            "type": "string",
+            "description": "Target attribute name on the related entity"
+          },
+          "operation": {
+            "type": "string",
+            "enum": [
+              "_set",
+              "_append",
+              "_append_all"
+            ],
+            "description": "Operation for the attribute value:\n- '_set': Replace the attribute value\n- '_append': Add new unique items (deduplicates)\n- '_append_all': Add all items (no deduplication)\n"
+          },
+          "field": {
+            "type": "string",
+            "description": "Source field name from the event data"
+          },
+          "jsonataExpression": {
+            "type": "string",
+            "description": "JSONata expression to compute the value"
+          },
+          "constant": {
+            "description": "Constant value (any type)"
+          }
+        }
       }
     },
     "responses": {

package/package.json

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