@epilot/sdk 2.18.23 → 2.18.25

package/docs/customer-portal.md

@@ -141,6 +141,7 @@ const { data } = await customerPortalClient.upsertPortal(...)
 - [`getAutomationContext`](#getautomationcontext)
 - [`updateWorkflowStepAsDone`](#updateworkflowstepasdone)
 - [`getEntityWorkflows`](#getentityworkflows)
+- [`getOutstandingTasks`](#getoutstandingtasks)
 - [`getEntityPortalWorkflows`](#getentityportalworkflows)
 - [`getEntityPortalWorkflowsBatch`](#getentityportalworkflowsbatch)
 - [`uploadMeterReadingPhoto`](#uploadmeterreadingphoto)
@@ -153,6 +154,10 @@ const { data } = await customerPortalClient.upsertPortal(...)
 - [`getPortalPageBlocks`](#getportalpageblocks)
 - [`getPortalPageBlock`](#getportalpageblock)
 - [`updateCampaignPortalBlockStatus`](#updatecampaignportalblockstatus)
+- [`listPortalNotifications`](#listportalnotifications)
+- [`getPortalNotificationsUnreadCount`](#getportalnotificationsunreadcount)
+- [`markAllPortalNotificationsRead`](#markallportalnotificationsread)
+- [`markPortalNotificationRead`](#markportalnotificationread)
 - [`updateNotificationsStatus`](#updatenotificationsstatus)
 - [`invitePartner`](#invitepartner)
 - [`listBusinessPartners`](#listbusinesspartners)
@@ -176,6 +181,7 @@ const { data } = await customerPortalClient.upsertPortal(...)
 - [`ssoLoginV3`](#ssologinv3)
 
 **Schemas**
+- [`PortalNotification`](#portalnotification)
 - [`MobileBuildStatus`](#mobilebuildstatus)
 - [`MobileBranding`](#mobilebranding)
 - [`MobileConfig`](#mobileconfig)
@@ -195,6 +201,7 @@ const { data } = await customerPortalClient.upsertPortal(...)
 - [`AllowedFileExtensions`](#allowedfileextensions)
 - [`UpdateOnlyPortalConfigAttributes`](#updateonlyportalconfigattributes)
 - [`CommonConfigAttributes`](#commonconfigattributes)
+- [`NotificationTriggerConfig`](#notificationtriggerconfig)
 - [`UpsertPortalConfig`](#upsertportalconfig)
 - [`PortalConfig`](#portalconfig)
 - [`UpsertPortalWidget`](#upsertportalwidget)
@@ -255,6 +262,7 @@ const { data } = await customerPortalClient.upsertPortal(...)
 - [`Rule`](#rule)
 - [`JourneyActions`](#journeyactions)
 - [`ExternalLink`](#externallink)
+- [`OutstandingTask`](#outstandingtask)
 - [`WorkflowExecution`](#workflowexecution)
 - [`WorkflowStep`](#workflowstep)
 - [`PortalWorkflow`](#portalworkflow)
@@ -610,7 +618,15 @@ const { data } = await client.upsertPortal(
     portal_sk_v3: 'PORTAL_CONFIG#453ad7bf-86d5-46c8-8252-bcc868df5e3c',
     origin: 'string',
     pages: {},
-    global_blocks: {}
+    global_blocks: {},
+    notification_triggers: [
+      {
+        trigger_type: 'entity_created',
+        entity_schema: 'opportunity',
+        enabled: true,
+        template_id: '3fa85f64-5717-4562-b3fc-2c963f66afa6'
+      }
+    ]
   },
 )
 ```
@@ -838,6 +854,14 @@ const { data } = await client.upsertPortal(
   "origin": "string",
   "pages": {},
   "global_blocks": {},
+  "notification_triggers": [
+    {
+      "trigger_type": "entity_created",
+      "entity_schema": "opportunity",
+      "enabled": true,
+      "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
+    }
+  ],
   "id": 12345,
   "organization_id": 12345,
   "org_settings": {
@@ -1203,6 +1227,14 @@ const { data } = await client.getPortalConfigByDomain({
   "origin": "string",
   "pages": {},
   "global_blocks": {},
+  "notification_triggers": [
+    {
+      "trigger_type": "entity_created",
+      "entity_schema": "opportunity",
+      "enabled": true,
+      "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
+    }
+  ],
   "id": 12345,
   "organization_id": 12345,
   "org_settings": {
@@ -1471,6 +1503,14 @@ const { data } = await client.getPortalConfig({
   "origin": "string",
   "pages": {},
   "global_blocks": {},
+  "notification_triggers": [
+    {
+      "trigger_type": "entity_created",
+      "entity_schema": "opportunity",
+      "enabled": true,
+      "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
+    }
+  ],
   "id": 12345,
   "organization_id": 12345,
   "org_settings": {
@@ -2087,7 +2127,11 @@ const { data } = await client.getConsumption({
       "timestamp": "1970-01-01T00:00:00.000Z",
       "value": 0,
       "type": "nt",
-      "unit": "kWh"
+      "unit": "kWh",
+      "label": {
+        "en": "Billing period 1",
+        "de": "Abrechnungszeitraum 1"
+      }
     }
   ]
 }
@@ -2624,6 +2668,14 @@ const { data } = await client.getPublicPortalConfig({
   "origin": "string",
   "pages": {},
   "global_blocks": {},
+  "notification_triggers": [
+    {
+      "trigger_type": "entity_created",
+      "entity_schema": "opportunity",
+      "enabled": true,
+      "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
+    }
+  ],
   "id": 12345,
   "organization_id": 12345,
   "org_settings": {
@@ -2892,6 +2944,14 @@ const { data } = await client.getOrgPortalConfig({
   "origin": "string",
   "pages": {},
   "global_blocks": {},
+  "notification_triggers": [
+    {
+      "trigger_type": "entity_created",
+      "entity_schema": "opportunity",
+      "enabled": true,
+      "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
+    }
+  ],
   "id": 12345,
   "organization_id": 12345,
   "org_settings": {
@@ -3169,6 +3229,14 @@ const { data } = await client.getPublicPortalConfigV3({
   "origin": "string",
   "pages": {},
   "global_blocks": {},
+  "notification_triggers": [
+    {
+      "trigger_type": "entity_created",
+      "entity_schema": "opportunity",
+      "enabled": true,
+      "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
+    }
+  ],
   "id": 12345,
   "organization_id": 12345,
   "org_settings": {
@@ -3437,6 +3505,14 @@ const { data } = await client.getOrgPortalConfigV3({
   "origin": "string",
   "pages": {},
   "global_blocks": {},
+  "notification_triggers": [
+    {
+      "trigger_type": "entity_created",
+      "entity_schema": "opportunity",
+      "enabled": true,
+      "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
+    }
+  ],
   "id": 12345,
   "organization_id": 12345,
   "org_settings": {
@@ -3538,6 +3614,7 @@ const { data } = await client.getAllPortalConfigs()
       "origin": "string",
       "pages": {},
       "global_blocks": {},
+      "notification_triggers": [],
       "id": 12345,
       "organization_id": 12345,
       "org_settings": {},
@@ -5790,6 +5867,7 @@ const { data } = await client.getFilePreview({
 {
   "kind": "pdf",
   "url": "https://example.com/path",
+  "requires_auth": true,
   "download_url": "https://example.com/path"
 }
 ```
@@ -5843,7 +5921,8 @@ const { data } = await client.trackFileDownloaded({
         "_title": "Opportunity ABC"
       }
     ],
-    "is_new": true
+    "is_new": true,
+    "custom_download_url_auth": "token"
   }
 }
 ```
@@ -6477,6 +6556,42 @@ const { data } = await client.getEntityWorkflows({
 
 ---
 
+### `getOutstandingTasks`
+
+Get outstanding workflow tasks for the portal user
+
+`GET /v2/portal/engagement/tasks`
+
+```ts
+const { data } = await client.getOutstandingTasks()
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "tasks": [
+    {
+      "entity_id": "string",
+      "entity_schema": "string",
+      "entity_title": "string",
+      "workflow_id": "string",
+      "workflow_name": "string",
+      "step_id": "string",
+      "step_name": "string",
+      "journey_id": "string",
+      "complete_task_automatically": true
+    }
+  ],
+  "total": 0
+}
+```
+
+</details>
+
+---
+
 ### `getEntityPortalWorkflows`
 
 Get all portal-relevant workflows associated with an entity (requires access to the entity),
@@ -7871,6 +7986,100 @@ const { data } = await client.updateCampaignPortalBlockStatus(
 
 ---
 
+### `listPortalNotifications`
+
+Lists the 360 notifications addressed to the authenticated portal user, newest first. The organization and the portal user are derived from the authenticated session, so a user can only ever read thei
+
+`GET /v2/portal/notifications`
+
+```ts
+const { data } = await client.listPortalNotifications({
+  cursor: 'example',
+  limit: 1,
+})
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "cursor": "string",
+  "total_unread": 0,
+  "results": [
+    {
+      "id": "1234567890",
+      "notification_id": 1234567890,
+      "type": "workflow_step_overdue",
+      "title": {
+        "en": "string",
+        "de": "string"
+      },
+      "message": {
+        "en": "string",
+        "de": "string"
+      },
+      "created_at": "1970-01-01T00:00:00.000Z",
+      "read": false,
+      "redirect_url": "string"
+    }
+  ]
+}
+```
+
+</details>
+
+---
+
+### `getPortalNotificationsUnreadCount`
+
+Returns the number of unread notifications for the authenticated portal user.
+
+`GET /v2/portal/notifications/unread-count`
+
+```ts
+const { data } = await client.getPortalNotificationsUnreadCount()
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "count": 3
+}
+```
+
+</details>
+
+---
+
+### `markAllPortalNotificationsRead`
+
+Marks all notifications of the authenticated portal user as read.
+
+`PUT /v2/portal/notifications/read-all`
+
+```ts
+const { data } = await client.markAllPortalNotificationsRead()
+```
+
+---
+
+### `markPortalNotificationRead`
+
+Marks a single notification of the authenticated portal user as read.
+
+`PUT /v2/portal/notifications/{id}/read`
+
+```ts
+const { data } = await client.markPortalNotificationRead({
+  id: 1,
+})
+```
+
+---
+
 ### `updateNotificationsStatus`
 
 Updates the statuses of multiple notifications at once.
@@ -9909,7 +10118,6 @@ const { data } = await client.invitePartner(
   null,
   {
     email: 'string',
-    represents_contact_list: ['5da0a718-c822-403d-9f5d-20d4584e0528'],
     contact_data: {},
     portal_user_data: {}
   },
@@ -10302,6 +10510,29 @@ const { data } = await client.putMobileConfig(
 
 ## Schemas
 
+### `PortalNotification`
+
+A 360 notification addressed to a portal user.
+
+```ts
+type PortalNotification = {
+  id: string
+  notification_id?: number
+  type?: string
+  title?: {
+    en?: string
+    de?: string
+  }
+  message?: {
+    en?: string
+    de?: string
+  }
+  created_at?: string // date-time
+  read: boolean
+  redirect_url?: string
+}
+```
+
 ### `MobileBuildStatus`
 
 Latest build/upload status for a platform (system-written).
@@ -10771,6 +11002,17 @@ type CommonConfigAttributes = {
 }
 ```
 
+### `NotificationTriggerConfig`
+
+```ts
+type NotificationTriggerConfig = {
+  trigger_type: "entity_created" | "entity_assigned" | "workflow_step_overdue"
+  entity_schema?: string
+  enabled?: boolean
+  template_id?: string // uuid
+}
+```
+
 ### `UpsertPortalConfig`
 
 ```ts
@@ -12061,6 +12303,7 @@ type FileItem = {
     _title?: string
   }>
   is_new?: boolean
+  custom_download_url_auth?: "token" | "presigned"
 }
 ```
 
@@ -12070,6 +12313,7 @@ type FileItem = {
 type FilePreviewResult = {
   kind: "pdf" | "image" | "unsupported"
   url?: string // uri
+  requires_auth?: boolean
   download_url?: string // uri
 }
 ```
@@ -12172,6 +12416,22 @@ type ExternalLink = {
 }
 ```
 
+### `OutstandingTask`
+
+```ts
+type OutstandingTask = {
+  entity_id: string
+  entity_schema: string
+  entity_title: string
+  workflow_id: string
+  workflow_name: string
+  step_id: string
+  step_name: string
+  journey_id: string
+  complete_task_automatically?: boolean
+}
+```
+
 ### `WorkflowExecution`
 
 ```ts

package/docs/validation-rules.md

@@ -62,6 +62,7 @@ const { data } = await validationRulesClient.getValidationRules(...)
 - [`RelativeDateValue`](#relativedatevalue)
 - [`RangeValue`](#rangevalue)
 - [`NoValue`](#novalue)
+- [`AppliesWhen`](#applieswhen)
 - [`ContextRequirement`](#contextrequirement)
 
 ### `getValidationRules`
@@ -675,6 +676,7 @@ type UpdateValidationRuleRequest = {
       operator: { ... }
       value: { ... }
       error_message: { ... }
+      applies_when?: { ... }
       allow_failure?: { ... }
     }>
   }
@@ -729,6 +731,7 @@ type ValidationRuleBase = {
       operator: { ... }
       value: { ... }
       error_message: { ... }
+      applies_when?: { ... }
       allow_failure?: { ... }
     }>
   }
@@ -1696,6 +1699,11 @@ type ComparisonRuleType = {
       source: { ... }
     }
     error_message: string
+    applies_when?: {
+      path: { ... }
+      operator: { ... }
+      value?: { ... }
+    }
     allow_failure?: boolean
   }>
 }
@@ -1719,6 +1727,7 @@ type Condition = {
       type: { ... }
       value: { ... }
       direction: { ... }
+      rounding?: { ... }
     }
   } | {
     source: "relative_date"
@@ -1757,6 +1766,11 @@ type Condition = {
     source: "none"
   }
   error_message: string
+  applies_when?: {
+    path: string
+    operator: "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "isEmpty" | "isNotEmpty"
+    value?: number | string | boolean
+  }
   allow_failure?: boolean
 }
 ```
@@ -1785,8 +1799,13 @@ type ConditionValue = {
   path: string
   adjust?: {
     type: "percent" | "absolute"
-    value: number
+    value: number | {
+      source: { ... }
+      path: { ... }
+      adjust?: { ... }
+    }
     direction: "increase" | "decrease"
+    rounding?: "up" | "down"
   }
 } | {
   source: "relative_date"
@@ -1805,6 +1824,7 @@ type ConditionValue = {
       type: { ... }
       value: { ... }
       direction: { ... }
+      rounding?: { ... }
     }
   } | {
     source: "relative_date"
@@ -1822,6 +1842,7 @@ type ConditionValue = {
       type: { ... }
       value: { ... }
       direction: { ... }
+      rounding?: { ... }
     }
   } | {
     source: "relative_date"
@@ -1847,8 +1868,13 @@ type ScalarValue = {
   path: string
   adjust?: {
     type: "percent" | "absolute"
-    value: number
+    value: number | {
+      source: { ... }
+      path: { ... }
+      adjust?: { ... }
+    }
     direction: "increase" | "decrease"
+    rounding?: "up" | "down"
   }
 } | {
   source: "relative_date"
@@ -1882,8 +1908,13 @@ type ContextValue = {
   path: string
   adjust?: {
     type: "percent" | "absolute"
-    value: number
+    value: number | {
+      source: { ... }
+      path: { ... }
+      adjust?: { ... }
+    }
     direction: "increase" | "decrease"
+    rounding?: "up" | "down"
   }
 }
 ```
@@ -1897,8 +1928,18 @@ Used to express tolerance bands such as "at most 10% above the current instalmen
 ```ts
 type ValueAdjustment = {
   type: "percent" | "absolute"
-  value: number
+  value: number | {
+    source: "context"
+    path: string
+    adjust?: {
+      type: { ... }
+      value: { ... }
+      direction: { ... }
+      rounding?: { ... }
+    }
+  }
   direction: "increase" | "decrease"
+  rounding?: "up" | "down"
 }
 ```
 
@@ -1932,6 +1973,7 @@ type RangeValue = {
       type: { ... }
       value: { ... }
       direction: { ... }
+      rounding?: { ... }
     }
   } | {
     source: "relative_date"
@@ -1949,6 +1991,7 @@ type RangeValue = {
       type: { ... }
       value: { ... }
       direction: { ... }
+      rounding?: { ... }
     }
   } | {
     source: "relative_date"
@@ -1969,6 +2012,22 @@ type NoValue = {
 }
 ```
 
+### `AppliesWhen`
+
+Optional precondition on a condition: the condition only takes part in the
+validation when this comparison over context holds. Examples: apply the
+dual-tariff reference only when `contract.htnt` is not empty, or run a
+plausibility check only when a context value reaches a threshold.
+
+
+```ts
+type AppliesWhen = {
+  path: string
+  operator: "equal" | "notEqual" | "greaterThan" | "greaterThanInclusive" | "lessThan" | "lessThanInclusive" | "isEmpty" | "isNotEmpty"
+  value?: number | string | boolean
+}
+```
+
 ### `ContextRequirement`
 
 An entity context source the rule needs at evaluation time, referenced by `context`

package/package.json

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