@epilot/sdk 2.15.1 → 2.15.3

package/docs/app.md

@@ -63,6 +63,9 @@ const { data } = await appClient.getPublicFacingComponent(...)
 **App Proxy**
 - [`publicProxyGet`](#publicproxyget)
 - [`publicProxyPost`](#publicproxypost)
+- [`publicProxyPut`](#publicproxyput)
+- [`publicProxyPatch`](#publicproxypatch)
+- [`publicProxyDelete`](#publicproxydelete)
 
 **Schemas**
 - [`Role`](#role)
@@ -103,6 +106,9 @@ const { data } = await appClient.getPublicFacingComponent(...)
 - [`PortalExtensionHookDataExport`](#portalextensionhookdataexport)
 - [`PortalExtensionHookVisualizationMetadata`](#portalextensionhookvisualizationmetadata)
 - [`PortalExtensionHookCostDataRetrieval`](#portalextensionhookcostdataretrieval)
+- [`PortalExtensionHookChangeEmail`](#portalextensionhookchangeemail)
+- [`PortalExtensionHookChangePassword`](#portalextensionhookchangepassword)
+- [`PortalExtensionHookDeleteAccount`](#portalextensionhookdeleteaccount)
 - [`PortalExtensionSeamlessLink`](#portalextensionseamlesslink)
 - [`PortalExtensionAuthBlock`](#portalextensionauthblock)
 - [`PortalExtensionSecureProxy`](#portalextensionsecureproxy)
@@ -1713,6 +1719,60 @@ const { data } = await client.publicProxyPost(
 
 ---
 
+### `publicProxyPut`
+
+Forward a PUT request to a registered proxy target from a public-facing component
+
+`PUT /v1/public/app/{appId}/proxy/{proxyName}/{path}`
+
+```ts
+const { data } = await client.publicProxyPut(
+  {
+    appId: 'example',
+    proxyName: 'example',
+    path: 'example',
+  },
+  {},
+)
+```
+
+---
+
+### `publicProxyPatch`
+
+Forward a PATCH request to a registered proxy target from a public-facing component
+
+`PATCH /v1/public/app/{appId}/proxy/{proxyName}/{path}`
+
+```ts
+const { data } = await client.publicProxyPatch(
+  {
+    appId: 'example',
+    proxyName: 'example',
+    path: 'example',
+  },
+  {},
+)
+```
+
+---
+
+### `publicProxyDelete`
+
+Forward a DELETE request to a registered proxy target from a public-facing component
+
+`DELETE /v1/public/app/{appId}/proxy/{proxyName}/{path}`
+
+```ts
+const { data } = await client.publicProxyDelete({
+  appId: 'example',
+  proxyName: 'example',
+  path: 'example',
+})
+```
+
+---
+
 ## Schemas
 
 ### `Role`
@@ -1902,10 +1962,11 @@ type ApiProxyComponent = {
   component_type: "API_PROXY"
   configuration: {
     name: string
-    target: string // uri
+    target: string
     auth_type: "header" | "bearer" | "oauth2" | "none"
     auth_header?: string
     token_url?: string // uri
+    headers?: Record<string, string>
   }
 }
 ```
@@ -2327,17 +2388,24 @@ type PortalExtensionComponent = {
       resolved?: { ... }
       use_static_ips?: { ... }
       secure_proxy?: { ... }
-    }>
-    links?: Array<{
+    } | {
       id: { ... }
-      name: { ... }
-      description?: { ... }
+      name?: { ... }
       type: { ... }
-      condition?: { ... }
+      change_mode?: { ... }
+      require_password_confirmation?: { ... }
+      explanation?: { ... }
       auth?: { ... }
-      redirect: { ... }
-    }>
-  }
+      call: { ... }
+      resolved?: { ... }
+      secure_proxy?: { ... }
+    } | {
+      id: { ... }
+      name?: { ... }
+      type: { ... }
+      require_new_password?: { ... }
+      explanation?: { ... }
+  // ...
 }
 ```
 
@@ -2819,6 +2887,142 @@ type PortalExtensionHookCostDataRetrieval = {
 }
 ```
 
+### `PortalExtensionHookChangeEmail`
+
+Hook that replaces the built-in change email functionality for portal users. When configured, the portal does not run its own change email flow. Instead, this hook makes an HTTP call to the third-party system, which is expected to handle the email change.
+The `change_mode` controls what the portal d
+
+```ts
+type PortalExtensionHookChangeEmail = {
+  id: string
+  name?: {
+    en?: string
+    de: string
+  }
+  type: "changeEmail"
+  change_mode?: "synchronous" | "asynchronous"
+  require_password_confirmation?: boolean
+  explanation?: {
+    en: string
+  }
+  auth?: {
+    method?: string
+    url: string
+    params?: Record<string, string>
+    headers?: Record<string, string>
+    body?: Record<string, unknown>
+    cache?: {
+      key: { ... }
+      ttl: { ... }
+    }
+  }
+  call: {
+    method?: string
+    url: string
+    params?: Record<string, string>
+    headers: Record<string, string>
+    body?: object
+  }
+  resolved?: {
+    error_message_path?: string
+  }
+  secure_proxy?: {
+    integration_id: string // uuid
+    use_case_slug: string
+  }
+}
+```
+
+### `PortalExtensionHookChangePassword`
+
+Hook that replaces the built-in change password functionality for portal users. When configured, the portal does not change the user's password itself. Instead, this hook makes an HTTP call to the third-party system, which is expected to handle the password change (most likely by sending the user in
+
+```ts
+type PortalExtensionHookChangePassword = {
+  id: string
+  name?: {
+    en?: string
+    de: string
+  }
+  type: "changePassword"
+  require_new_password?: boolean
+  explanation?: {
+    en: string
+  }
+  auth?: {
+    method?: string
+    url: string
+    params?: Record<string, string>
+    headers?: Record<string, string>
+    body?: Record<string, unknown>
+    cache?: {
+      key: { ... }
+      ttl: { ... }
+    }
+  }
+  call: {
+    method?: string
+    url: string
+    params?: Record<string, string>
+    headers: Record<string, string>
+    body?: object
+  }
+  resolved?: {
+    error_message_path?: string
+  }
+  secure_proxy?: {
+    integration_id: string // uuid
+    use_case_slug: string
+  }
+}
+```
+
+### `PortalExtensionHookDeleteAccount`
+
+Hook that replaces the built-in delete account functionality for portal users. When configured, the portal does not delete the user itself. Instead, this hook makes an HTTP call to the third-party system, which is expected to handle the deletion.
+The `deletion_mode` controls what the portal does aft
+
+```ts
+type PortalExtensionHookDeleteAccount = {
+  id: string
+  name?: {
+    en?: string
+    de: string
+  }
+  type: "deleteAccount"
+  deletion_mode?: "synchronous" | "asynchronous"
+  delete_contact?: "none" | "soft" | "hard"
+  explanation?: {
+    en: string
+  }
+  auth?: {
+    method?: string
+    url: string
+    params?: Record<string, string>
+    headers?: Record<string, string>
+    body?: Record<string, unknown>
+    cache?: {
+      key: { ... }
+      ttl: { ... }
+    }
+  }
+  call: {
+    method?: string
+    url: string
+    params?: Record<string, string>
+    headers: Record<string, string>
+    body?: object
+  }
+  resolved?: {
+    error_message_path?: string
+  }
+  secure_proxy?: {
+    integration_id: string // uuid
+    use_case_slug: string
+  }
+}
+```
+
 ### `PortalExtensionSeamlessLink`
 
 ```ts
@@ -3174,10 +3378,11 @@ Configuration for an API proxy component
 ```ts
 type ApiProxyConfig = {
   name: string
-  target: string // uri
+  target: string
   auth_type: "header" | "bearer" | "oauth2" | "none"
   auth_header?: string
   token_url?: string // uri
+  headers?: Record<string, string>
 }
 ```
 

package/docs/integration-toolkit.md

@@ -79,6 +79,8 @@ const { data } = await integrationToolkitClient.acknowledgeTracking(...)
 - [`getMonitoringStatsV2`](#getmonitoringstatsv2)
 - [`getMonitoringTimeSeriesV2`](#getmonitoringtimeseriesv2)
 - [`getAssociatedMonitoringEvents`](#getassociatedmonitoringevents)
+- [`ingestExternalMonitoringEvents`](#ingestexternalmonitoringevents)
+- [`getMonitoringTraceByCorrelation`](#getmonitoringtracebycorrelation)
 
 **proxy**
 - [`secureProxy`](#secureproxy)
@@ -249,6 +251,10 @@ const { data } = await integrationToolkitClient.acknowledgeTracking(...)
 - [`MonitoringStats`](#monitoringstats)
 - [`InboundMonitoringEvent`](#inboundmonitoringevent)
 - [`QueryMonitoringEventsV2Request`](#querymonitoringeventsv2request)
+- [`ExternalMonitoringSpan`](#externalmonitoringspan)
+- [`IngestExternalMonitoringEventsRequest`](#ingestexternalmonitoringeventsrequest)
+- [`IngestExternalMonitoringEventsResponse`](#ingestexternalmonitoringeventsresponse)
+- [`MonitoringTraceResponse`](#monitoringtraceresponse)
 - [`MonitoringEventV2`](#monitoringeventv2)
 - [`GetMonitoringStatsV2Request`](#getmonitoringstatsv2request)
 - [`MonitoringStatsV2`](#monitoringstatsv2)
@@ -909,6 +915,7 @@ const { data } = await client.queryEvents(
       "format": "json",
       "payload": "string",
       "deduplication_id": "evt-2025-05-01-12345-create-bp",
+      "correlation_id": "bp-8f3a2c-7d4e-4b1a-9c2f-1e6d5a4b3c21",
       "use_case_id": "string"
     }
   ],
@@ -2801,6 +2808,86 @@ const { data } = await client.getAssociatedMonitoringEvents({
 
 ---
 
+### `ingestExternalMonitoringEvents`
+
+Ingest monitoring spans produced by an EXTERNAL system (e.g. an integration
+middleware), so the Integration Hub is the central monitoring point and the
+cross-system event trace spans both the external
+
+`POST /v2/integrations/{integrationId}/monitoring/external-events`
+
+```ts
+const { data } = await client.ingestExternalMonitoringEvents(
+  {
+    integrationId: 'example',
+  },
+  {
+    events: [
+      {
+        correlation_id: 'string',
+        level: 'string',
+        use_case_slug: 'string',
+        occurred_at: '1970-01-01T00:00:00.000Z',
+        message: 'string',
+        detail: {}
+      }
+    ]
+  },
+)
+```
+
+---
+
+### `getMonitoringTraceByCorrelation`
+
+Returns the cross-system event trace for a `correlation_id`: every monitoring
+span sharing it — external spans (middleware) plus epilot's own processing spans
+— ordered chronologically, with a rolled-
+
+`GET /v2/integrations/{integrationId}/monitoring/traces/{correlationId}`
+
+```ts
+const { data } = await client.getMonitoringTraceByCorrelation({
+  integrationId: 'example',
+  correlationId: 'example',
+})
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "correlation_id": "string",
+  "status": "success",
+  "started_at": "1970-01-01T00:00:00.000Z",
+  "ended_at": "1970-01-01T00:00:00.000Z",
+  "span_count": 0,
+  "truncated": true,
+  "spans": [
+    {
+      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
+      "org_id": "string",
+      "integration_id": "string",
+      "event_id": "string",
+      "correlation_id": "string",
+      "use_case_id": "string",
+      "use_case_type": "inbound",
+      "level": "success",
+      "code": "string",
+      "message": "string",
+      "detail": {},
+      "created_at": "1970-01-01T00:00:00.000Z"
+    }
+  ],
+  "inbound_event": {}
+}
+```
+
+</details>
+
+---
+
 ### `listSecureProxies`
 
 List all secure proxy use cases
@@ -3147,6 +3234,7 @@ type ErpEvent = {
   format: "json" | "xml"
   payload: string | Record<string, unknown>
   deduplication_id?: string
+  correlation_id?: string
   use_case_id?: string
 }
 ```
@@ -3164,6 +3252,7 @@ type ErpUpdatesEventsV2Request = {
     format: "json" | "xml"
     payload: string | Record<string, unknown>
     deduplication_id?: string
+    correlation_id?: string
     use_case_id?: string
   }>
 }
@@ -7247,6 +7336,78 @@ type QueryMonitoringEventsV2Request = {
 }
 ```
 
+### `ExternalMonitoringSpan`
+
+A single monitoring span produced by an external system. `correlation_id`, `level`, `use_case_slug`, `occurred_at` and `message` are all required and `level` must be one of success|error|warning|info — but these are validated PER SPAN at ingest and reported in the per-item `results[]`, so one malfor
+
+```ts
+type ExternalMonitoringSpan = {
+  correlation_id?: string
+  level?: string
+  use_case_slug?: string
+  occurred_at?: string // date-time
+  message?: string
+  detail?: Record<string, unknown>
+}
+```
+
+### `IngestExternalMonitoringEventsRequest`
+
+```ts
+type IngestExternalMonitoringEventsRequest = {
+  events: Array<{
+    correlation_id?: string
+    level?: string
+    use_case_slug?: string
+    occurred_at?: string // date-time
+    message?: string
+    detail?: Record<string, unknown>
+  }>
+}
+```
+
+### `IngestExternalMonitoringEventsResponse`
+
+```ts
+type IngestExternalMonitoringEventsResponse = {
+  accepted: number
+  rejected: number
+  results?: Array<{
+    index: number
+    status: "accepted" | "rejected"
+    reason?: string
+  }>
+}
+```
+
+### `MonitoringTraceResponse`
+
+```ts
+type MonitoringTraceResponse = {
+  correlation_id: string
+  status: "success" | "error" | "warning" | "info"
+  started_at?: string // date-time
+  ended_at?: string // date-time
+  span_count: number
+  truncated: boolean
+  spans: Array<{
+    id: string // uuid
+    org_id: string
+    integration_id: string
+    event_id: string
+    correlation_id?: string
+    use_case_id?: string
+    use_case_type: "inbound" | "outbound" | "file_proxy" | "managed_call" | "secure_proxy" | ""
+    level: "success" | "error" | "skipped" | "warning"
+    code?: string
+    message?: string
+    detail?: Record<string, unknown>
+    created_at: string // date-time
+  }>
+  inbound_event?: Record<string, unknown>
+}
+```
+
 ### `MonitoringEventV2`
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/sdk",
-  "version": "2.15.1",
+  "version": "2.15.3",
   "description": "JavaScript/TypeScript SDK for epilot APIs",
   "type": "module",
   "main": "./dist/index.cjs",