@epilot/sdk 2.20.34 → 2.20.35

package/definitions/integration-toolkit-runtime.json

@@ -1 +1 @@
-{"s":"https://integration-toolkit.sls.epilot.io","o":[["acknowledgeTracking","post","/v1/erp/tracking/acknowledgement",null,1],["triggerErp","post","/v1/erp/trigger",null,1],["processErpUpdatesEvents","post","/v1/erp/updates/events",null,1],["processErpUpdatesEventsV2","post","/v2/erp/updates/events",null,1],["processErpUpdatesEventsV3","post","/v3/erp/updates/events",null,1],["simulateMappingV2","post","/v2/erp/updates/mapping_simulation",null,1],["simulateDirect","post","/v1/erp/updates/direct_simulation",null,1],["simulateMapping","post","/v1/erp/updates/mapping_simulation",null,1],["listIntegrations","get","/v1/integrations"],["createIntegration","post","/v1/integrations",null,1],["getIntegration","get","/v1/integrations/{integrationId}",[["integrationId","p",true]]],["updateIntegration","put","/v1/integrations/{integrationId}",[["integrationId","p",true]],1],["deleteIntegration","delete","/v1/integrations/{integrationId}",[["integrationId","p",true]]],["queryEvents","post","/v1/integrations/{integrationId}/events",[["integrationId","p",true]],1],["replayEvents","post","/v1/integrations/{integrationId}/events/replay",[["integrationId","p",true]],1],["listUseCases","get","/v1/integrations/{integrationId}/use-cases",[["integrationId","p",true]]],["createUseCase","post","/v1/integrations/{integrationId}/use-cases",[["integrationId","p",true]],1],["getUseCase","get","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]]],["updateUseCase","put","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]],1],["deleteUseCase","delete","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]]],["listUseCaseHistory","get","/v1/integrations/{integrationId}/use-cases/{useCaseId}/history",[["integrationId","p",true],["useCaseId","p",true],["cursor","q"]]],["listDocumentationPages","get","/v1/integrations/{integrationId}/documentation",[["integrationId","p",true]]],["getDocumentationPage","get","/v1/integrations/{integrationId}/documentation/{docId}",[["integrationId","p",true],["docId","p",true]]],["upsertDocumentationPage","put","/v1/integrations/{integrationId}/documentation/{docId}",[["integrationId","p",true],["docId","p",true]],1],["deleteDocumentationPage","delete","/v1/integrations/{integrationId}/documentation/{docId}",[["integrationId","p",true],["docId","p",true]]],["listIntegrationsV2","get","/v2/integrations"],["createIntegrationV2","post","/v2/integrations",null,1],["getIntegrationV2","get","/v2/integrations/{integrationId}",[["integrationId","p",true]]],["updateIntegrationV2","put","/v2/integrations/{integrationId}",[["integrationId","p",true]],1],["deleteIntegrationV2","delete","/v2/integrations/{integrationId}",[["integrationId","p",true]]],["listNotificationHistory","get","/v2/integrations/{integrationId}/notifications/history",[["integrationId","p",true],["cursor","q"],["limit","q"],["type","q"]]],["testSendNotification","post","/v2/integrations/{integrationId}/notifications/test",[["integrationId","p",true]],1],["getNotificationStatus","get","/v2/integrations/{integrationId}/notifications/status",[["integrationId","p",true],["include","q"]]],["getSecureProxyWhitelist","get","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist",[["integrationId","p",true],["useCaseId","p",true]]],["updateSecureProxyWhitelist","put","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist",[["integrationId","p",true],["useCaseId","p",true]],1],["listSecureProxyWhitelistHistory","get","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist/history",[["integrationId","p",true],["useCaseId","p",true],["limit","q"]]],["setIntegrationAppMapping","put","/v1/integrations/{integrationId}/app-mapping",[["integrationId","p",true]],1],["deleteIntegrationAppMapping","delete","/v1/integrations/{integrationId}/app-mapping",[["integrationId","p",true]],1],["queryInboundMonitoringEvents","post","/v1/integrations/{integrationId}/monitoring/inbound-events",[["integrationId","p",true]],1],["getMonitoringStats","post","/v1/integrations/{integrationId}/monitoring/stats",[["integrationId","p",true]],1],["getMonitoringTimeSeries","post","/v1/integrations/{integrationId}/monitoring/timeseries",[["integrationId","p",true]],1],["getOutboundStatus","get","/v1/integrations/{integrationId}/outbound-status",[["integrationId","p",true]]],["getEntitySyncStatus","get","/v1/integrations/entities/{entityId}/sync-status",[["entityId","p",true],["integration_id","q"]]],["pollOutboundMessages","post","/v1/integrations/{integrationId}/outbound/messages/poll",[["integrationId","p",true]],1],["ackOutboundMessages","post","/v1/integrations/{integrationId}/outbound/messages/ack",[["integrationId","p",true]],1],["listOutboundDlqMessages","get","/v1/integrations/{integrationId}/outbound/messages/dlq",[["integrationId","p",true],["limit","q"],["next_token","q"]]],["redriveOutboundDlqMessages","post","/v1/integrations/{integrationId}/outbound/messages/dlq/redrive",[["integrationId","p",true]],1],["unblockOutboundStream","post","/v1/integrations/{integrationId}/outbound/messages/unblock",[["integrationId","p",true]],1],["queryAccessLogs","post","/v1/integrations/{integrationId}/monitoring/access-logs",[["integrationId","p",true]],1],["queryOutboundMonitoringEvents","post","/v1/integrations/{integrationId}/monitoring/outbound-events",[["integrationId","p",true]],1],["queryMonitoringEventsV2","post","/v2/integrations/{integrationId}/monitoring/events",[["integrationId","p",true]],1],["getMonitoringStatsV2","post","/v2/integrations/{integrationId}/monitoring/stats",[["integrationId","p",true]],1],["getMonitoringTimeSeriesV2","post","/v2/integrations/{integrationId}/monitoring/time-series",[["integrationId","p",true]],1],["getAssociatedMonitoringEvents","get","/v2/integrations/{integrationId}/monitoring/events/{eventId}/associated",[["integrationId","p",true],["eventId","p",true]]],["ingestExternalMonitoringEvents","post","/v2/integrations/{integrationId}/monitoring/external-events",[["integrationId","p",true]],1],["getMonitoringTraceByCorrelation","get","/v2/integrations/{integrationId}/monitoring/traces/{correlationId}",[["integrationId","p",true],["correlationId","p",true]]],["listSecureProxies","get","/v1/integrations/secure-proxies"],["secureProxy","post","/v1/secure-proxy",null,1],["managedCallExecute","post","/v1/managed-call/{slug}/execute",[["slug","p",true]],1],["generateTypesPreview","post","/v1/integrations/{integrationId}/generate-types-preview",[["integrationId","p",true]]],["generateTypes","post","/v1/integrations/{integrationId}/generate-types",[["integrationId","p",true]],1],["commitTypes","post","/v1/integrations/{integrationId}/commit-types",[["integrationId","p",true]],1],["createErpImport","post","/v2/erp/imports",null,1],["listErpImports","get","/v2/erp/imports",[["limit","q"],["cursor","q"]]],["getErpImport","get","/v2/erp/imports/{importId}",[["importId","p",true]]],["deleteErpImport","delete","/v2/erp/imports/{importId}",[["importId","p",true]]],["validateErpImport","post","/v2/erp/imports/{importId}:validate",[["importId","p",true]],1],["suggestErpImportUseCases","post","/v2/erp/imports/{importId}:suggest-use-cases",[["importId","p",true]]],["executeErpImport","post","/v2/erp/imports/{importId}:execute",[["importId","p",true]],1],["abortErpImport","post","/v2/erp/imports/{importId}:abort",[["importId","p",true]]]],"v":"3.0.3"}
+{"s":"https://integration-toolkit.sls.epilot.io","o":[["acknowledgeTracking","post","/v1/erp/tracking/acknowledgement",null,1],["triggerErp","post","/v1/erp/trigger",null,1],["processErpUpdatesEvents","post","/v1/erp/updates/events",null,1],["processErpUpdatesEventsV2","post","/v2/erp/updates/events",null,1],["processErpUpdatesEventsV3","post","/v3/erp/updates/events",null,1],["simulateMappingV2","post","/v2/erp/updates/mapping_simulation",null,1],["simulateDirect","post","/v1/erp/updates/direct_simulation",null,1],["simulateMapping","post","/v1/erp/updates/mapping_simulation",null,1],["listIntegrations","get","/v1/integrations"],["createIntegration","post","/v1/integrations",null,1],["getIntegration","get","/v1/integrations/{integrationId}",[["integrationId","p",true]]],["updateIntegration","put","/v1/integrations/{integrationId}",[["integrationId","p",true]],1],["deleteIntegration","delete","/v1/integrations/{integrationId}",[["integrationId","p",true]]],["queryEvents","post","/v1/integrations/{integrationId}/events",[["integrationId","p",true]],1],["replayEvents","post","/v1/integrations/{integrationId}/events/replay",[["integrationId","p",true]],1],["listUseCases","get","/v1/integrations/{integrationId}/use-cases",[["integrationId","p",true]]],["createUseCase","post","/v1/integrations/{integrationId}/use-cases",[["integrationId","p",true]],1],["getUseCase","get","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]]],["updateUseCase","put","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]],1],["deleteUseCase","delete","/v1/integrations/{integrationId}/use-cases/{useCaseId}",[["integrationId","p",true],["useCaseId","p",true]]],["listUseCaseHistory","get","/v1/integrations/{integrationId}/use-cases/{useCaseId}/history",[["integrationId","p",true],["useCaseId","p",true],["cursor","q"]]],["listDocumentationPages","get","/v1/integrations/{integrationId}/documentation",[["integrationId","p",true]]],["getDocumentationPage","get","/v1/integrations/{integrationId}/documentation/{docId}",[["integrationId","p",true],["docId","p",true]]],["upsertDocumentationPage","put","/v1/integrations/{integrationId}/documentation/{docId}",[["integrationId","p",true],["docId","p",true]],1],["deleteDocumentationPage","delete","/v1/integrations/{integrationId}/documentation/{docId}",[["integrationId","p",true],["docId","p",true]]],["listIntegrationsV2","get","/v2/integrations"],["createIntegrationV2","post","/v2/integrations",null,1],["getIntegrationV2","get","/v2/integrations/{integrationId}",[["integrationId","p",true]]],["updateIntegrationV2","put","/v2/integrations/{integrationId}",[["integrationId","p",true]],1],["deleteIntegrationV2","delete","/v2/integrations/{integrationId}",[["integrationId","p",true]]],["listNotificationHistory","get","/v2/integrations/{integrationId}/notifications/history",[["integrationId","p",true],["cursor","q"],["limit","q"],["type","q"]]],["testSendNotification","post","/v2/integrations/{integrationId}/notifications/test",[["integrationId","p",true]],1],["getNotificationStatus","get","/v2/integrations/{integrationId}/notifications/status",[["integrationId","p",true],["include","q"]]],["getSecureProxyWhitelist","get","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist",[["integrationId","p",true],["useCaseId","p",true]]],["updateSecureProxyWhitelist","put","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist",[["integrationId","p",true],["useCaseId","p",true]],1],["listSecureProxyWhitelistHistory","get","/v2/integrations/{integrationId}/use-cases/{useCaseId}/secure-proxy-whitelist/history",[["integrationId","p",true],["useCaseId","p",true],["limit","q"]]],["setIntegrationAppMapping","put","/v1/integrations/{integrationId}/app-mapping",[["integrationId","p",true]],1],["deleteIntegrationAppMapping","delete","/v1/integrations/{integrationId}/app-mapping",[["integrationId","p",true]],1],["queryInboundMonitoringEvents","post","/v1/integrations/{integrationId}/monitoring/inbound-events",[["integrationId","p",true]],1],["getMonitoringStats","post","/v1/integrations/{integrationId}/monitoring/stats",[["integrationId","p",true]],1],["getMonitoringTimeSeries","post","/v1/integrations/{integrationId}/monitoring/timeseries",[["integrationId","p",true]],1],["getOutboundStatus","get","/v1/integrations/{integrationId}/outbound-status",[["integrationId","p",true]]],["getEntitySyncStatus","get","/v1/integrations/entities/{entityId}/sync-status",[["entityId","p",true],["integration_id","q"]]],["pollOutboundMessages","post","/v1/integrations/{integrationId}/outbound/messages/poll",[["integrationId","p",true]],1],["ackOutboundMessages","post","/v1/integrations/{integrationId}/outbound/messages/ack",[["integrationId","p",true]],1],["listOutboundDlqMessages","get","/v1/integrations/{integrationId}/outbound/messages/dlq",[["integrationId","p",true],["limit","q"],["next_token","q"]]],["redriveOutboundDlqMessages","post","/v1/integrations/{integrationId}/outbound/messages/dlq/redrive",[["integrationId","p",true]],1],["unblockOutboundStream","post","/v1/integrations/{integrationId}/outbound/messages/unblock",[["integrationId","p",true]],1],["simulateOutboundMapping","post","/v1/integrations/{integrationId}/outbound/mapping-simulation",[["integrationId","p",true]],1],["queryAccessLogs","post","/v1/integrations/{integrationId}/monitoring/access-logs",[["integrationId","p",true]],1],["queryOutboundMonitoringEvents","post","/v1/integrations/{integrationId}/monitoring/outbound-events",[["integrationId","p",true]],1],["queryMonitoringEventsV2","post","/v2/integrations/{integrationId}/monitoring/events",[["integrationId","p",true]],1],["getMonitoringStatsV2","post","/v2/integrations/{integrationId}/monitoring/stats",[["integrationId","p",true]],1],["getMonitoringTimeSeriesV2","post","/v2/integrations/{integrationId}/monitoring/time-series",[["integrationId","p",true]],1],["getAssociatedMonitoringEvents","get","/v2/integrations/{integrationId}/monitoring/events/{eventId}/associated",[["integrationId","p",true],["eventId","p",true]]],["ingestExternalMonitoringEvents","post","/v2/integrations/{integrationId}/monitoring/external-events",[["integrationId","p",true]],1],["getMonitoringTraceByCorrelation","get","/v2/integrations/{integrationId}/monitoring/traces/{correlationId}",[["integrationId","p",true],["correlationId","p",true]]],["listSecureProxies","get","/v1/integrations/secure-proxies"],["secureProxy","post","/v1/secure-proxy",null,1],["managedCallExecute","post","/v1/managed-call/{slug}/execute",[["slug","p",true]],1],["generateTypesPreview","post","/v1/integrations/{integrationId}/generate-types-preview",[["integrationId","p",true]]],["generateTypes","post","/v1/integrations/{integrationId}/generate-types",[["integrationId","p",true]],1],["commitTypes","post","/v1/integrations/{integrationId}/commit-types",[["integrationId","p",true]],1],["createErpImport","post","/v2/erp/imports",null,1],["listErpImports","get","/v2/erp/imports",[["limit","q"],["cursor","q"]]],["getErpImport","get","/v2/erp/imports/{importId}",[["importId","p",true]]],["deleteErpImport","delete","/v2/erp/imports/{importId}",[["importId","p",true]]],["validateErpImport","post","/v2/erp/imports/{importId}:validate",[["importId","p",true]],1],["suggestErpImportUseCases","post","/v2/erp/imports/{importId}:suggest-use-cases",[["importId","p",true]]],["executeErpImport","post","/v2/erp/imports/{importId}:execute",[["importId","p",true]],1],["abortErpImport","post","/v2/erp/imports/{importId}:abort",[["importId","p",true]]]],"v":"3.0.3"}

package/definitions/integration-toolkit.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Integration Toolkit API",
-    "version": "1.33.1",
+    "version": "1.35.0",
     "description": "API for integrating with external systems in a standardised way."
   },
   "tags": [
@@ -234,6 +234,9 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "429": {
+            "$ref": "#/components/responses/ERPUpdatesRetryableResponse"
+          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -294,6 +297,9 @@
           "404": {
             "$ref": "#/components/responses/NotFound"
           },
+          "429": {
+            "$ref": "#/components/responses/ERPUpdatesRetryableResponse"
+          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -351,6 +357,9 @@
           "404": {
             "$ref": "#/components/responses/NotFound"
           },
+          "429": {
+            "$ref": "#/components/responses/ERPUpdatesRetryableResponse"
+          },
           "500": {
             "$ref": "#/components/responses/InternalServerError"
           }
@@ -3223,7 +3232,7 @@
           }
         ],
         "summary": "pollOutboundMessages",
-        "description": "Poll outbound messages for an integration's poll-mode use cases.\nTakes a lease on the head-of-line batch of the integration's FIFO stream:\nthe returned messages stay invisible to subsequent polls until they are\nacknowledged or the visibility timeout elapses. POST because taking a\nlease mutates server state — auto-retrying middleware must not burn\nleases. One in-flight batch per stream: while a lease is active (or\nanother poll wins the race), the response is an empty batch\n(`messages: []`), not an error. Requires the `integration:consume` grant.\n",
+        "description": "Poll outbound messages for an integration's poll-mode use cases.\nTakes a lease on the head-of-line batch of the integration's FIFO stream:\nthe returned messages stay invisible to subsequent polls until they are\nacknowledged or the visibility timeout elapses. POST because taking a\nlease mutates server state — auto-retrying middleware must not burn\nleases. One in-flight batch per stream: while a lease is active (or\nanother poll wins the race), the response is an empty batch\n(`messages: []`), not an error. Each message's `payload` is the\nuse case's JSONata transformation of the event when it has one\n(`mapping_version` identifies the transform), otherwise the raw\nevent. Requires the `integration:consume` grant.\n\nOrdering: messages are delivered in stream order, which follows the\nevent time. An event that arrives after the consumer was already handed\nevents with a later event time is not inserted behind them (it would\nnever be delivered); it is appended at the end of the stream and a\n`MSG_LATE_ARRIVAL` warning is recorded. Delivery is at-least-once: a\nmessage whose lease expires is delivered again, and in rare races the\nsame event can be delivered twice under different message ids, so\nconsumers should deduplicate by `event_id`.\n",
         "tags": [
           "integrations"
         ],
@@ -3444,7 +3453,7 @@
           }
         ],
         "summary": "redriveOutboundDlqMessages",
-        "description": "Redrive selected dead-lettered messages back into the live stream.\nOperator endpoint — requires the `integration:manage` grant.\nA redriven message is re-enqueued at the tail with a new id and\nsequence — it is delivered out of its original per-entity order (the\nstream has moved on); this is inherent to redrive and matches SQS DLQ\nsemantics. The redriven copy starts with zero delivery attempts and a\nfresh retention window; the original DLQ entry is removed. Per-id\nresults report `redriven` or `not_found` (unknown ids, or entries\nconcurrently redriven/expired).\n",
+        "description": "Redrive selected dead-lettered messages back into the live stream.\nOperator endpoint — requires the `integration:manage` grant.\nA redriven message is re-enqueued at the tail with a new id and\nsequence — it is delivered out of its original per-entity order (the\nstream has moved on); this is inherent to redrive and matches SQS DLQ\nsemantics. The redriven copy starts with zero delivery attempts and a\nfresh retention window; the original DLQ entry is removed.\nWith `reapply_mapping`, the raw event is re-mapped with the use case's\ncurrent `jsonata_expression`; entries whose mapping failed are always\nre-mapped. Per-id results report `redriven`, `not_found` (unknown ids,\nor entries concurrently redriven/expired) or `mapping_failed` (the\nre-mapping failed again and the entry stays in the DLQ).\n",
         "tags": [
           "integrations"
         ],
@@ -3514,7 +3523,7 @@
           }
         ],
         "summary": "unblockOutboundStream",
-        "description": "Unblock an integration's outbound stream halted by the `block`\npoison policy: skips (dead-letters) the current blocked head message,\nemitting MSG_DEAD_LETTERED and letting the next message become the\nhead. Operator endpoint — requires the `integration:manage` grant.\nReturns `unblocked: false` as a no-op when the stream is not\ncurrently blocked (or the state moved concurrently) — safe to retry.\n",
+        "description": "Unblock an integration's outbound stream halted by the `block`\npoison policy: skips (dead-letters) the current blocked head message,\nemitting MSG_DEAD_LETTERED and letting the next message become the\nhead. A head blocked because its `jsonata_expression` failed at\nenqueue is skipped the same way (its DLQ reason defaults to\n`mapping_failed`); fix the expression, then redrive the entry to\nre-map it. Operator endpoint — requires the `integration:manage` grant.\nReturns `unblocked: false` as a no-op when the stream is not\ncurrently blocked (or the state moved concurrently) — safe to retry.\n",
         "tags": [
           "integrations"
         ],
@@ -3574,6 +3583,76 @@
         }
       }
     },
+    "/v1/integrations/{integrationId}/outbound/mapping-simulation": {
+      "post": {
+        "operationId": "simulateOutboundMapping",
+        "x-epilot-permissions": [
+          {
+            "action": "integration:view",
+            "resource": "integration:{integrationId}"
+          }
+        ],
+        "summary": "simulateOutboundMapping",
+        "description": "Preview a poll delivery's `jsonata_expression` without saving or\nenqueueing anything. The expression is checked and evaluated exactly\nas at enqueue time: the same length, syntax and binding checks, the\nsame `$env`/`$mapValue`/`$mapKey` bindings resolved server-side from\nthe org's non-secret environment variables and key/value maps, the\nsame evaluation limits, and the same rule that the output must be a\nJSON object.\n\nProvide exactly one input: `payload` (an event to map as-is), or\n`event_id` (with `event_catalog_event`) to load a historical\nevent-catalog event and hydrate it exactly as enqueue does — the\npreview is then exact, and the hydrated event is echoed as `input`.\n\nMapping failures are a `200` with `valid: false` and an `error`;\n`4xx` is reserved for malformed requests. Requires the\n`integration:view` grant.\n",
+        "tags": [
+          "integrations"
+        ],
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "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/SimulateOutboundMappingRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Simulation outcome (mapping failures included)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SimulateOutboundMappingResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
     "/v1/integrations/{integrationId}/monitoring/access-logs": {
       "post": {
         "operationId": "queryAccessLogs",
@@ -10328,7 +10407,7 @@
           "enabled",
           "delivery"
         ],
-        "description": "A mapping that delivers an event to an external system by one of three mechanisms — pushed to a webhook (with a JSONata payload transformation), made available on the pull-based poll queue (raw event payload, no transformation), or handed to a file_proxy use case that uploads files to an external document system (a pointer only; the referenced use case owns the payload and the fan-out)",
+        "description": "A mapping that delivers an event to an external system by one of three mechanisms — pushed to a webhook (with a JSONata payload transformation), made available on the pull-based poll queue (the raw event payload, or its JSONata transformation when the mapping carries one), or handed to a file_proxy use case that uploads files to an external document system (a pointer only; the referenced use case owns the payload and the fan-out)",
         "properties": {
           "id": {
             "type": "string",
@@ -10342,7 +10421,7 @@
           },
           "jsonata_expression": {
             "type": "string",
-            "description": "JSONata expression to transform the event payload. Required for webhook delivery, ignored for poll delivery, and rejected for file_proxy delivery — a file_proxy payload is built by the referenced use case's steps, so accepting an expression here would silently do nothing.",
+            "description": "JSONata expression transforming the event payload. Required for webhook delivery (evaluated by the webhook service). Optional for poll delivery: evaluated at enqueue time against the standardized event-catalog event with `$env`/`$mapValue`/`$mapKey` bindings; must return a JSON object; empty = raw event payload is delivered. Rejected for file_proxy delivery.",
             "example": "{ \"id\": entity._id, \"customer\": entity.customer_name }"
           },
           "enabled": {
@@ -10366,7 +10445,7 @@
         }
       },
       "DeliveryConfig": {
-        "description": "Configuration for how the event should be delivered. webhook = push delivery via svc-webhooks (JSONata-transformed payload); poll = pull-based queue delivery where the consumer fetches items via the poll API (raw event payload); file_proxy = one push per event attachment to an external document system, through a file_proxy use case (JSONata-transformed payload carrying the file bytes)",
+        "description": "Configuration for how the event should be delivered. webhook = push delivery via svc-webhooks (JSONata-transformed payload); poll = pull-based queue delivery where the consumer fetches items via the poll API (raw event payload, or its JSONata transformation when the mapping carries a jsonata_expression); file_proxy = one push per event attachment to an external document system, through a file_proxy use case (JSONata-transformed payload carrying the file bytes)",
         "oneOf": [
           {
             "$ref": "#/components/schemas/WebhookDeliveryConfig"
@@ -10421,7 +10500,7 @@
         "required": [
           "type"
         ],
-        "description": "Pull-based queue delivery. Items carry the raw standardized event-catalog payload; no JSONata mapping is applied in poll mode. Consumers fetch and acknowledge items via the poll API.",
+        "description": "Pull-based queue delivery. Consumers fetch and acknowledge items via the poll API. When the mapping carries a `jsonata_expression`, it is evaluated once at enqueue time against the standardized event-catalog event (with `$env`/`$mapValue`/`$mapKey` bindings) and its output — a JSON object — is the delivered payload; without one, items carry the raw standardized event-catalog payload. An item whose expression fails at enqueue is never delivered: when it reaches the head of the stream the poison_policy applies to it at once, without waiting for max_delivery_attempts.",
         "properties": {
           "type": {
             "type": "string",
@@ -10444,7 +10523,7 @@
               "block"
             ],
             "default": "dead_letter",
-            "description": "What happens when an item exhausts max_delivery_attempts: dead_letter routes the exhausted item to the dead-letter queue and advances past it so the stream keeps flowing; block halts the queue at that item until operator/consumer action removes it."
+            "description": "What happens when an item exhausts max_delivery_attempts, or its jsonata_expression failed at enqueue: dead_letter routes the item to the dead-letter queue and advances past it so the stream keeps flowing; block halts the queue at that item until operator/consumer action removes it."
           },
           "max_delivery_attempts": {
             "type": "integer",
@@ -10839,10 +10918,19 @@
             "type": "string",
             "description": "Ordering group — messages sharing a group are strictly ordered,\ndistinct groups are independent. Constant \"0\" in v1.\n"
           },
+          "org_id": {
+            "type": "string",
+            "description": "The epilot org the message belongs to. Always populated — lets one\nconsumer that polls many orgs attribute every message.\n"
+          },
           "payload": {
             "type": "object",
             "additionalProperties": true,
-            "description": "The raw standardized event-catalog event, always inlined as-is"
+            "description": "The mapped output when the use case has a `jsonata_expression`,\notherwise the raw standardized event-catalog event. Always inlined.\n"
+          },
+          "mapping_version": {
+            "type": "string",
+            "description": "Version of the transform that produced the payload — the first 16\nhex characters of sha256 over the trimmed expression. Absent for\nraw payloads.\n",
+            "example": "3f2a9c1b7d4e8f60"
           },
           "enqueued_at": {
             "type": "string",
@@ -10994,7 +11082,15 @@
           },
           "reason": {
             "type": "string",
-            "description": "Why the message was dead-lettered (policy or operator reason)"
+            "description": "Why the message was dead-lettered (policy or operator reason) —\n`max_delivery_attempts_exhausted`, `mapping_failed`, or the\noperator's own reason\n"
+          },
+          "mapping_error": {
+            "type": "string",
+            "description": "Why the message's transform failed, prefixed with the error code\n(e.g. `invalid_output: ...`). Present on entries whose mapping\nfailed — at enqueue, or again on a re-mapping redrive.\n"
+          },
+          "mapping_version": {
+            "type": "string",
+            "description": "Version of the transform that produced (or failed to produce) the payload"
           },
           "expires_at": {
             "type": "string",
@@ -11037,6 +11133,11 @@
               "type": "string"
             },
             "description": "Message ids (msg_…) of the DLQ entries to redrive"
+          },
+          "reapply_mapping": {
+            "type": "boolean",
+            "default": false,
+            "description": "Re-apply the use case's CURRENT `jsonata_expression` to the raw\nevent instead of re-sending the stored payload. Entries whose\nmapping failed are always re-mapped, whatever this says. When the\nuse case no longer has an expression, the raw event is redriven.\n"
           }
         }
       },
@@ -11055,9 +11156,14 @@
             "type": "string",
             "enum": [
               "redriven",
-              "not_found"
+              "not_found",
+              "mapping_failed"
             ],
-            "description": "Outcome — `redriven` re-enqueued at the tail; `not_found` for\nunknown ids or entries concurrently redriven/expired\n"
+            "description": "Outcome — `redriven` re-enqueued at the tail; `not_found` for\nunknown ids or entries concurrently redriven/expired;\n`mapping_failed` when re-mapping failed again (the entry stays in\nthe DLQ with the updated mapping_error and mapping_version)\n"
+          },
+          "mapping_error": {
+            "type": "string",
+            "description": "Why re-mapping failed — present only when status is mapping_failed"
           }
         }
       },
@@ -11103,6 +11209,96 @@
           }
         }
       },
+      "SimulateOutboundMappingRequest": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "jsonata_expression"
+        ],
+        "description": "Exactly one of `payload` or `event_id` is required. `event_id` needs\n`event_catalog_event` to name the event it belongs to.\n",
+        "properties": {
+          "jsonata_expression": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The poll mapping expression to preview",
+            "example": "{ \"contract_number\": contract.contract_number, \"status\": $mapValue($env.erp.statuses, contract.status) }"
+          },
+          "payload": {
+            "type": "object",
+            "additionalProperties": true,
+            "description": "A standardized event-catalog event to map as-is"
+          },
+          "event_id": {
+            "type": "string",
+            "description": "Id of a historical event-catalog event to load, hydrate and map"
+          },
+          "event_catalog_event": {
+            "type": "string",
+            "description": "Event-catalog event name of `event_id` (required with `event_id`)",
+            "example": "contract.updated"
+          }
+        }
+      },
+      "OutboundMappingSimulationError": {
+        "type": "object",
+        "required": [
+          "code",
+          "message"
+        ],
+        "properties": {
+          "code": {
+            "type": "string",
+            "enum": [
+              "syntax_error",
+              "unknown_binding",
+              "evaluation_error",
+              "timeout",
+              "invalid_output",
+              "expression_too_long"
+            ],
+            "description": "`syntax_error` — the expression does not parse; `unknown_binding` —\nit reads a `$` name that is never bound; `evaluation_error` — it\nfailed while evaluating; `timeout` — it exceeded the evaluation\ntime or depth limit; `invalid_output` — it did not return a JSON\nobject; `expression_too_long` — it exceeds 10,000 characters\n"
+          },
+          "message": {
+            "type": "string",
+            "description": "Human-readable explanation"
+          },
+          "position": {
+            "type": "integer",
+            "description": "Character position of the failure in the expression, when known"
+          }
+        }
+      },
+      "SimulateOutboundMappingResponse": {
+        "type": "object",
+        "required": [
+          "valid",
+          "mapping_version"
+        ],
+        "properties": {
+          "valid": {
+            "type": "boolean",
+            "description": "Whether the expression produced a deliverable payload"
+          },
+          "output": {
+            "type": "object",
+            "additionalProperties": true,
+            "description": "The payload a consumer would receive — present when valid"
+          },
+          "error": {
+            "$ref": "#/components/schemas/OutboundMappingSimulationError"
+          },
+          "mapping_version": {
+            "type": "string",
+            "description": "The `mapping_version` messages mapped by this expression carry",
+            "example": "3f2a9c1b7d4e8f60"
+          },
+          "input": {
+            "type": "object",
+            "additionalProperties": true,
+            "description": "The hydrated event the expression ran against — present when `event_id` was used"
+          }
+        }
+      },
       "RelationConfig": {
         "type": "object",
         "required": [
@@ -12384,6 +12580,7 @@
           "MSG_ENQUEUED",
           "MSG_EXPIRED_UNPOLLED",
           "MSG_HEAD_BLOCKED",
+          "MSG_LATE_ARRIVAL",
           "OAUTH2_TOKEN_FAILURE",
           "PAYLOAD_TOO_LARGE",
           "PRUNE_SCOPE_COMPLETED",
@@ -13212,6 +13409,55 @@
           }
         }
       },
+      "ERPUpdatesRetryableResponse": {
+        "description": "Some events could not be processed right now but will succeed on a retry: their\ndeduplication check was throttled, or another request carrying the same\ndeduplication_id is still being processed. Those events have status `error`.\nRetry the whole request after the `Retry-After` interval: events that were\naccepted by this request are recorded and come back as `skipped` on the retry.\n",
+        "headers": {
+          "Retry-After": {
+            "description": "Seconds to wait before retrying the request",
+            "schema": {
+              "type": "integer"
+            }
+          }
+        },
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "results": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "required": [
+                      "event_id",
+                      "status"
+                    ],
+                    "properties": {
+                      "event_id": {
+                        "type": "string",
+                        "description": "ID of the processed event"
+                      },
+                      "status": {
+                        "type": "string",
+                        "enum": [
+                          "success",
+                          "error",
+                          "skipped",
+                          "ignored"
+                        ],
+                        "description": "Processing status for the event (skipped indicates duplicate deduplication_id, ignored indicates unconfigured event)"
+                      },
+                      "message": {
+                        "type": "string"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
       "TriggerWebhookResponse": {
         "description": "Result of triggering an ERP synchronization event",
         "content": {

package/dist/apis/access-token.cjs

@@ -6,25 +6,25 @@ var _chunkZMBA3WV4cjs = require('../chunk-ZMBA3WV4.cjs');
 
 
 
-var _chunkXFBOYWIPcjs = require('../chunk-XFBOYWIP.cjs');
+var _chunkRE2KDGKQcjs = require('../chunk-RE2KDGKQ.cjs');
 require('../chunk-NJK5F5TF.cjs');
 
 // src/apis/access-token.ts
 var loadDefinition = () => {
   const mod = _chunkZMBA3WV4cjs.require_access_token_runtime.call(void 0, );
-  return _chunkXFBOYWIPcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+  return _chunkRE2KDGKQcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 };
 var _instance = null;
 var resolve = () => {
   if (!_instance) {
     const def = loadDefinition();
-    _instance = _chunkXFBOYWIPcjs.createApiClient.call(void 0, { definition: def, apiName: "accessToken" });
+    _instance = _chunkRE2KDGKQcjs.createApiClient.call(void 0, { definition: def, apiName: "accessToken" });
   }
   return _instance;
 };
-var _handle = _chunkXFBOYWIPcjs.createApiHandle.call(void 0, {
+var _handle = _chunkRE2KDGKQcjs.createApiHandle.call(void 0, {
   resolveClient: resolve,
-  createClient: () => _chunkXFBOYWIPcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "accessToken" }),
+  createClient: () => _chunkRE2KDGKQcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "accessToken" }),
   apiName: "accessToken"
 });
 var getClient = _handle.getClient;
@@ -35,4 +35,4 @@ var accessToken = _handle;
 
 
 
-exports.accessToken = accessToken; exports.authorize = _chunkXFBOYWIPcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;
+exports.accessToken = accessToken; exports.authorize = _chunkRE2KDGKQcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;

package/dist/apis/access-token.js

@@ -6,7 +6,7 @@ import {
   createApiClient,
   createApiHandle,
   expand
-} from "../chunk-RJVNG46W.js";
+} from "../chunk-OXXS3O7X.js";
 import "../chunk-YPSWSI3M.js";
 
 // src/apis/access-token.ts

package/dist/apis/address-suggestions.cjs

@@ -6,25 +6,25 @@ var _chunkLKRBFBFNcjs = require('../chunk-LKRBFBFN.cjs');
 
 
 
-var _chunkXFBOYWIPcjs = require('../chunk-XFBOYWIP.cjs');
+var _chunkRE2KDGKQcjs = require('../chunk-RE2KDGKQ.cjs');
 require('../chunk-NJK5F5TF.cjs');
 
 // src/apis/address-suggestions.ts
 var loadDefinition = () => {
   const mod = _chunkLKRBFBFNcjs.require_address_suggestions_runtime.call(void 0, );
-  return _chunkXFBOYWIPcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+  return _chunkRE2KDGKQcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 };
 var _instance = null;
 var resolve = () => {
   if (!_instance) {
     const def = loadDefinition();
-    _instance = _chunkXFBOYWIPcjs.createApiClient.call(void 0, { definition: def, apiName: "addressSuggestions" });
+    _instance = _chunkRE2KDGKQcjs.createApiClient.call(void 0, { definition: def, apiName: "addressSuggestions" });
   }
   return _instance;
 };
-var _handle = _chunkXFBOYWIPcjs.createApiHandle.call(void 0, {
+var _handle = _chunkRE2KDGKQcjs.createApiHandle.call(void 0, {
   resolveClient: resolve,
-  createClient: () => _chunkXFBOYWIPcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "addressSuggestions" }),
+  createClient: () => _chunkRE2KDGKQcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "addressSuggestions" }),
   apiName: "addressSuggestions"
 });
 var getClient = _handle.getClient;
@@ -35,4 +35,4 @@ var addressSuggestions = _handle;
 
 
 
-exports.addressSuggestions = addressSuggestions; exports.authorize = _chunkXFBOYWIPcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;
+exports.addressSuggestions = addressSuggestions; exports.authorize = _chunkRE2KDGKQcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;

package/dist/apis/address-suggestions.js

@@ -6,7 +6,7 @@ import {
   createApiClient,
   createApiHandle,
   expand
-} from "../chunk-RJVNG46W.js";
+} from "../chunk-OXXS3O7X.js";
 import "../chunk-YPSWSI3M.js";
 
 // src/apis/address-suggestions.ts

package/dist/apis/address.cjs

@@ -6,25 +6,25 @@ var _chunkT67ZXTVGcjs = require('../chunk-T67ZXTVG.cjs');
 
 
 
-var _chunkXFBOYWIPcjs = require('../chunk-XFBOYWIP.cjs');
+var _chunkRE2KDGKQcjs = require('../chunk-RE2KDGKQ.cjs');
 require('../chunk-NJK5F5TF.cjs');
 
 // src/apis/address.ts
 var loadDefinition = () => {
   const mod = _chunkT67ZXTVGcjs.require_address_runtime.call(void 0, );
-  return _chunkXFBOYWIPcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+  return _chunkRE2KDGKQcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 };
 var _instance = null;
 var resolve = () => {
   if (!_instance) {
     const def = loadDefinition();
-    _instance = _chunkXFBOYWIPcjs.createApiClient.call(void 0, { definition: def, apiName: "address" });
+    _instance = _chunkRE2KDGKQcjs.createApiClient.call(void 0, { definition: def, apiName: "address" });
   }
   return _instance;
 };
-var _handle = _chunkXFBOYWIPcjs.createApiHandle.call(void 0, {
+var _handle = _chunkRE2KDGKQcjs.createApiHandle.call(void 0, {
   resolveClient: resolve,
-  createClient: () => _chunkXFBOYWIPcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "address" }),
+  createClient: () => _chunkRE2KDGKQcjs.createApiClient.call(void 0, { definition: loadDefinition(), apiName: "address" }),
   apiName: "address"
 });
 var getClient = _handle.getClient;
@@ -35,4 +35,4 @@ var address = _handle;
 
 
 
-exports.address = address; exports.authorize = _chunkXFBOYWIPcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;
+exports.address = address; exports.authorize = _chunkRE2KDGKQcjs.authorize; exports.createClient = createClient; exports.getClient = getClient;

package/dist/apis/address.js

@@ -6,7 +6,7 @@ import {
   createApiClient,
   createApiHandle,
   expand
-} from "../chunk-RJVNG46W.js";
+} from "../chunk-OXXS3O7X.js";
 import "../chunk-YPSWSI3M.js";
 
 // src/apis/address.ts