@epilot/customer-portal-client 0.46.2 → 0.46.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/customer-portal-client",
-  "version": "0.46.2",
+  "version": "0.46.3",
   "description": "API Client for epilot portal API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/openapi-runtime.json

@@ -2717,6 +2717,12 @@
         "responses": {}
       }
     },
+    "/v3/portal/configs/summaries": {
+      "get": {
+        "operationId": "listPortalConfigSummaries",
+        "responses": {}
+      }
+    },
     "/v3/portal/config/swap": {
       "post": {
         "operationId": "swapPortalConfig",

package/src/openapi.json

@@ -4036,7 +4036,7 @@
       "post": {
         "operationId": "identifyContact",
         "summary": "identifyContact",
-        "description": "Identify a contact by the portal's configured registration identifiers and, on a match,\nissue a short-lived bearer token that acts as that contact.\n\nResolution is identical to `checkContactExistsV3`. The token does not grant a portal\nsession; it is accepted only on the operations listed in `allowed_operations`, and\nexpires at `expires_at`. Requires `surface_id` to name a surface of the portal whose\n`authentication` is `registration_identifiers`; returns 403 otherwise. The token is\nconfined to that surface's data access. Requests may be rate limited (429).\n",
+        "description": "Identify a contact by the surface's identifiers and, on a match, issue a short-lived\nbearer token that acts as that contact.\n\nThe identifiers checked are the surface's own `identifiers` when it configures any,\notherwise the portal's `registration_identifiers`. Their values are sent in the\n`registration_identifiers` request property. Resolution is otherwise identical to\n`checkContactExistsV3`: the same lookup, `registrationIdentifiersCheck` hook and\nTIMEOUT semantics, run on the surface's identifiers. The token does not grant a portal\nsession; it is accepted only on the operations listed in `allowed_operations`, and\nexpires at `expires_at`. Requires `surface_id` to name a surface of the portal whose\n`authentication` is `registration_identifiers`; returns 403 otherwise. The token is\nconfined to that surface's data access. Requests may be rate limited (429).\n\nNo portal session is expected, but the caller must present a public access token\n(`token_type: journey` or `token_type: portal`) as the bearer, minted for the same\n`org_id`; the request is rejected with 401 otherwise. It binds the call to the journey\nor portal it comes from — the token is public, so it proves origin, not identity.\n",
         "security": [],
         "tags": [
           "Public"
@@ -10747,7 +10747,7 @@
       "delete": {
         "operationId": "deletePortalConfig",
         "summary": "deletePortalConfig",
-        "description": "Deletes a specific portal configuration by ID.",
+        "description": "Deletes a specific portal configuration by ID, together with everything the portal owns:\nits pages, revisions, email templates and widget configuration. The custom domain network\nsetup is torn down asynchronously afterwards.\n",
         "tags": [
           "ECP Admin"
         ],
@@ -11115,6 +11115,50 @@
         }
       }
     },
+    "/v3/portal/configs/summaries": {
+      "get": {
+        "operationId": "listPortalConfigSummaries",
+        "summary": "listPortalConfigSummaries",
+        "description": "Lists the portals of the organization as lightweight summaries: the identifying,\ndisplay and registration fields of each portal config, without pages, email\ntemplates, grants, feature flags, identity providers or certificate details.\n\nUse it for portal overviews and pickers. Read a single portal with\n`getPortalConfigV3` when the full configuration is needed.\n",
+        "tags": [
+          "ECP Admin"
+        ],
+        "security": [
+          {
+            "EpilotAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Portal config summaries retrieved successfully.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/PortalConfigSummaryV3"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "500": {
+            "$ref": "#/components/responses/InternalServerError"
+          }
+        }
+      }
+    },
     "/v3/portal/config/swap": {
       "post": {
         "operationId": "swapPortalConfig",
@@ -12477,6 +12521,42 @@
           }
         }
       },
+      "NewDesignMigrationResult": {
+        "type": "object",
+        "properties": {
+          "org_id": {
+            "type": "string"
+          },
+          "portal_id": {
+            "type": "string"
+          },
+          "origin": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "is_v3_item": {
+            "type": "boolean"
+          },
+          "dry_run": {
+            "type": "boolean"
+          },
+          "migrated": {
+            "type": "boolean",
+            "description": "True when the migration was written (false for dry_run)"
+          },
+          "summary": {
+            "type": "object",
+            "additionalProperties": true
+          },
+          "before": {
+            "type": "object",
+            "description": "Stored feature_settings and pages before the migration, for rollback",
+            "additionalProperties": true
+          }
+        }
+      },
       "OtaPortal": {
         "type": "object",
         "description": "A portal that has mobile OTA updates enabled.",
@@ -13069,37 +13149,7 @@
             "example": false
           },
           "feature_settings": {
-            "type": "object",
-            "description": "Feature settings for the portal",
-            "properties": {
-              "start_page": {
-                "type": "boolean",
-                "description": "Start page feature flag"
-              },
-              "billing": {
-                "type": "boolean",
-                "description": "Billing feature flag"
-              },
-              "change_due_date": {
-                "type": "boolean",
-                "description": "Change due date feature flag"
-              },
-              "new_design": {
-                "type": "boolean",
-                "description": "Enable or disable the new design for the portal"
-              },
-              "mcp_enabled": {
-                "type": "boolean",
-                "description": "Enable the MCP (AI agent) connector channel for this portal"
-              },
-              "mcp_grant_version": {
-                "type": "integer",
-                "minimum": 0,
-                "default": 0,
-                "readOnly": true,
-                "description": "Server-managed generation used to invalidate MCP grants after the connector is disabled or re-enabled"
-              }
-            }
+            "$ref": "#/components/schemas/PortalFeatureSettings"
           },
           "accessToken": {
             "type": "string",
@@ -14104,7 +14154,7 @@
         }
       },
       "ContactIdentifyRequest": {
-        "description": "ContactExistsRequest plus the surface the token is requested for.\n",
+        "description": "ContactExistsRequest plus the surface the token is requested for. `registration_identifiers` carries the values of the surface's effective identifiers (keyed by schema, then attribute name): the surface's own `identifiers` when it configures any, otherwise the portal's `registration_identifiers`.\n",
         "allOf": [
           {
             "$ref": "#/components/schemas/ContactExistsRequest"
@@ -14558,6 +14608,14 @@
               "format": "uuid"
             }
           },
+          "match_any_targets": {
+            "type": "array",
+            "description": "The entity must match at least one of these targets. Combined with `targets` (all of which must match) using AND.",
+            "items": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
           "templates": {
             "type": "object",
             "deprecated": true,
@@ -15695,7 +15753,7 @@
               "login",
               "registration_identifiers"
             ],
-            "description": "How a caller on this surface proves who they are.\n\n- `login`: a logged-in portal user token (the portal's own authentication).\n- `registration_identifiers`: the caller supplies the portal's\n  `registration_identifiers` to `identifyContact` and receives a short-lived\n  contact identification token. Anyone who knows or guesses those values can\n  use this surface, so its data access should be as narrow as the use case allows.\n\n`anonymous` (no proof of identity at all) is planned and not accepted yet.\n"
+            "description": "How a caller on this surface proves who they are.\n\n- `login`: a logged-in portal user token (the portal's own authentication).\n- `registration_identifiers`: the caller supplies the values of the surface's\n  identifiers (its own `identifiers`, or the portal's `registration_identifiers`\n  when it sets none) to `identifyContact` and receives a short-lived contact\n  identification token. Anyone who knows or guesses those values can use this\n  surface, so its data access should be as narrow as the use case allows.\n\n`anonymous` (no proof of identity at all) is planned and not accepted yet.\n"
           },
           "token_ttl_seconds": {
             "type": "integer",
@@ -15705,6 +15763,23 @@
             "maximum": 900,
             "description": "Lifetime of tokens minted for this surface. Only used with `registration_identifiers`."
           },
+          "identifiers": {
+            "type": "array",
+            "description": "Identifier attributes a caller must supply on this surface to be identified. Only\nused with `authentication: registration_identifiers`.\n\nOmitted or empty means the surface uses the portal's `registration_identifiers`.\nWhen set, these replace the portal's `registration_identifiers` on this surface\nonly: `identifyContact` requires a value for each of them (400 listing the missing\nones otherwise), runs the contact lookup and the `registrationIdentifiersCheck`\nhook on them, and refuses to issue tokens (403) unless there are at least two.\nEntries without `name` or `schema` are ignored.\n",
+            "items": {
+              "$ref": "#/components/schemas/RegistrationIdentifier"
+            },
+            "example": [
+              {
+                "name": "customer_number",
+                "schema": "contact"
+              },
+              {
+                "name": "meter_number",
+                "schema": "meter"
+              }
+            ]
+          },
           "data_access": {
             "$ref": "#/components/schemas/PortalSurfaceDataAccess"
           }
@@ -15831,6 +15906,123 @@
           }
         }
       },
+      "JourneyContextUsagesRequest": {
+        "type": "object",
+        "required": [
+          "journey_id",
+          "param_keys"
+        ],
+        "properties": {
+          "journey_id": {
+            "type": "string",
+            "description": "Journey whose context parameters are being looked up"
+          },
+          "param_keys": {
+            "type": "array",
+            "description": "Context parameter names (the `paramKey` of each parameter)",
+            "items": {
+              "type": "string"
+            }
+          },
+          "param_ids": {
+            "type": "array",
+            "description": "Accepted for a uniform adapter request shape; portals reference parameters by name only, so this is ignored.",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "JourneyContextUsagesResponse": {
+        "type": "object",
+        "required": [
+          "usages",
+          "status",
+          "scanned"
+        ],
+        "properties": {
+          "status": {
+            "type": "string",
+            "enum": [
+              "ok",
+              "partial"
+            ],
+            "description": "partial when the row cap, the soft deadline or a failed portal truncated the result"
+          },
+          "scanned": {
+            "type": "integer",
+            "description": "Portals examined"
+          },
+          "usages": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "kind",
+                "resource",
+                "location",
+                "matched_as"
+              ],
+              "properties": {
+                "kind": {
+                  "type": "string",
+                  "enum": [
+                    "portal-config",
+                    "portal-block",
+                    "portal-widget"
+                  ]
+                },
+                "resource": {
+                  "type": "object",
+                  "required": [
+                    "type",
+                    "id"
+                  ],
+                  "properties": {
+                    "type": {
+                      "type": "string",
+                      "enum": [
+                        "portal"
+                      ]
+                    },
+                    "id": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    }
+                  }
+                },
+                "location": {
+                  "type": "object",
+                  "additionalProperties": true
+                },
+                "matched_as": {
+                  "type": "object",
+                  "required": [
+                    "dialect",
+                    "token"
+                  ],
+                  "properties": {
+                    "dialect": {
+                      "type": "string",
+                      "enum": [
+                        "name"
+                      ]
+                    },
+                    "token": {
+                      "type": "string"
+                    },
+                    "at": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
       "ExternalLink": {
         "type": "object",
         "properties": {
@@ -16122,6 +16314,9 @@
             "items": {
               "$ref": "#/components/schemas/PortalWorkflowStage"
             }
+          },
+          "portal_titles": {
+            "$ref": "#/components/schemas/PortalNameOverrides"
           }
         },
         "required": [
@@ -16154,13 +16349,20 @@
             "enum": [
               "COMPLETED",
               "IN_PROGRESS",
-              "UPCOMING"
+              "UPCOMING",
+              "NOT_REACHED"
             ],
-            "description": "Derived progress status:\n- COMPLETED: every task of the stage is done, and the flow has moved past it\n- IN_PROGRESS: the flow's current work is inside this stage\n- UPCOMING: the flow has not reached this stage yet\n"
+            "description": "Derived progress status:\n- COMPLETED: every task of the stage is done, and the flow has moved past it\n- IN_PROGRESS: the flow's current work is inside this stage\n- UPCOMING: the flow has not reached this stage yet\n- NOT_REACHED: the flow finished (DONE or CLOSED) before reaching this stage — a run may legitimately end at any stage\n"
           },
           "completed_at": {
             "type": "string",
             "description": "Latest completion timestamp among the stage's tasks; set only when the\nstage is COMPLETED and at least one of its tasks recorded one\n"
+          },
+          "portal_names": {
+            "$ref": "#/components/schemas/PortalNameOverrides"
+          },
+          "portal_descriptions": {
+            "$ref": "#/components/schemas/PortalDescriptionOverrides"
           }
         },
         "required": [
@@ -16169,6 +16371,34 @@
           "status"
         ]
       },
+      "PortalNameOverrides": {
+        "type": "object",
+        "description": "Portal-facing overrides of a flow or stage title, configured per portal\naudience in the Flows Hub. Served unresolved because this endpoint asks\nthe Workflows API for audience `all` — one cached response feeds blocks\nof both audiences, so each block picks its own override and falls back\nto `name` when the key is absent.\n",
+        "properties": {
+          "ecp": {
+            "type": "string",
+            "description": "Title shown in the End Customer Portal"
+          },
+          "installer": {
+            "type": "string",
+            "description": "Title shown in the Installer Portal"
+          }
+        }
+      },
+      "PortalDescriptionOverrides": {
+        "type": "object",
+        "description": "Portal-facing overrides of a stage description, configured per portal\naudience in the Flows Hub. Served unresolved for the same reason as\n`PortalNameOverrides`; a block falls back to `description` when its\naudience's key is absent. The values are rich text, like `description`\nitself.\n",
+        "properties": {
+          "ecp": {
+            "type": "string",
+            "description": "Description shown in the End Customer Portal"
+          },
+          "installer": {
+            "type": "string",
+            "description": "Description shown in the Installer Portal"
+          }
+        }
+      },
       "PortalWorkflowTask": {
         "type": "object",
         "description": "A single portal-visible task of a linearized workflow execution",
@@ -16218,6 +16448,10 @@
               "name": {
                 "type": "string"
               },
+              "portal_button_label": {
+                "type": "string",
+                "description": "Portal-facing label configured in the Flows Hub that replaces the portal's default \"Start now\" button for this journey. Blank or absent means the portal keeps its own translated default."
+              },
               "complete_task_automatically": {
                 "type": "boolean",
                 "description": "If true, the task is auto completed when the journey is completed"
@@ -16304,6 +16538,10 @@
               "name": {
                 "type": "string"
               },
+              "portal_button_label": {
+                "type": "string",
+                "description": "Portal-facing label configured in the Flows Hub that replaces the portal's default \"Start now\" button for this journey."
+              },
               "complete_task_automatically": {
                 "type": "boolean"
               }
@@ -16874,6 +17112,18 @@
               "3ec28ab5-8598-41ef-9486-b57fca1d5e2a"
             ]
           },
+          "match_any_targets": {
+            "type": "array",
+            "description": "The entity must match at least one of these targets. Combined with `targets` (all of which must match) using AND.",
+            "items": {
+              "type": "string",
+              "format": "uuid"
+            },
+            "example": [
+              "3ec28ab5-8598-41ef-9486-b57fca1d5e2a",
+              "5f2c1e7a-6b0d-4a8e-9c3f-1d2e3f4a5b6c"
+            ]
+          },
           "include": {
             "type": "array",
             "description": "Optional enrichment data to side-load alongside results under the `includes` response key.",
@@ -19985,37 +20235,7 @@
             "example": false
           },
           "feature_settings": {
-            "type": "object",
-            "description": "Feature settings for the portal",
-            "properties": {
-              "start_page": {
-                "type": "boolean",
-                "description": "Start page feature flag"
-              },
-              "billing": {
-                "type": "boolean",
-                "description": "Billing feature flag"
-              },
-              "change_due_date": {
-                "type": "boolean",
-                "description": "Change due date feature flag"
-              },
-              "new_design": {
-                "type": "boolean",
-                "description": "Enable or disable the new design for the portal"
-              },
-              "mcp_enabled": {
-                "type": "boolean",
-                "description": "Enable the MCP (AI agent) connector channel for this portal"
-              },
-              "mcp_grant_version": {
-                "type": "integer",
-                "minimum": 0,
-                "default": 0,
-                "readOnly": true,
-                "description": "Server-managed generation used to invalidate MCP grants after the connector is disabled or re-enabled"
-              }
-            }
+            "$ref": "#/components/schemas/PortalFeatureSettings"
           },
           "accessToken": {
             "type": "string",
@@ -20674,6 +20894,176 @@
           }
         ]
       },
+      "PortalFeatureSettings": {
+        "type": "object",
+        "description": "Feature settings for the portal",
+        "properties": {
+          "start_page": {
+            "type": "boolean",
+            "description": "Start page feature flag"
+          },
+          "billing": {
+            "type": "boolean",
+            "description": "Billing feature flag"
+          },
+          "change_due_date": {
+            "type": "boolean",
+            "description": "Change due date feature flag"
+          },
+          "new_design": {
+            "type": "boolean",
+            "description": "Enable or disable the new design for the portal"
+          },
+          "mcp_enabled": {
+            "type": "boolean",
+            "description": "Enable the MCP (AI agent) connector channel for this portal"
+          },
+          "mcp_grant_version": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0,
+            "readOnly": true,
+            "description": "Server-managed generation used to invalidate MCP grants after the connector is disabled or re-enabled"
+          }
+        }
+      },
+      "PortalConfigSummaryV3": {
+        "type": "object",
+        "description": "Lightweight view of a portal config for lists and pickers. Carries the identifying,\ndisplay and registration fields only. Pages, email templates, grants, feature flags,\nidentity providers and certificate details are left out; read them per portal with\n`getPortalConfigV3`.\n",
+        "properties": {
+          "portal_id": {
+            "$ref": "#/components/schemas/PortalId"
+          },
+          "organization_id": {
+            "type": "string",
+            "example": 12345,
+            "description": "ID of the organization"
+          },
+          "origin": {
+            "$ref": "#/components/schemas/Origin"
+          },
+          "name": {
+            "type": "string",
+            "description": "Name of the portal"
+          },
+          "enabled": {
+            "type": "boolean",
+            "description": "Whether the portal is enabled"
+          },
+          "domain": {
+            "type": "string",
+            "description": "Custom domain of the portal"
+          },
+          "epilot_domain": {
+            "type": "string",
+            "description": "epilot-hosted domain of the portal"
+          },
+          "is_epilot_domain": {
+            "type": "boolean"
+          },
+          "dnsStatus": {
+            "type": "string",
+            "description": "Status of the custom domain setup, when a custom domain is configured",
+            "enum": [
+              "CONFIGURING",
+              "PENDING",
+              "SUCCEED",
+              "EXPIRED",
+              "NEW_CERT_IN_PROGRESS"
+            ]
+          },
+          "design_id": {
+            "$ref": "#/components/schemas/EntityId"
+          },
+          "default_user_to_notify": {
+            "type": "object",
+            "description": "Default 360 user to notify upon an internal notification",
+            "properties": {
+              "onPendingUser": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/AdminUser"
+                },
+                "description": "Default admin users for pending user notification to notify"
+              }
+            }
+          },
+          "feature_settings": {
+            "$ref": "#/components/schemas/PortalFeatureSettings"
+          },
+          "self_registration_setting": {
+            "type": "string",
+            "enum": [
+              "ALLOW_WITH_CONTACT_CREATION",
+              "ALLOW_WITHOUT_CONTACT_CREATION",
+              "DENY",
+              "ALWAYS_CREATE_CONTACT",
+              "DISALLOW_COMPLETELY",
+              "BLOCK_IF_PORTAL_USER_EXISTS"
+            ]
+          },
+          "self_registration_account_setting": {
+            "type": "string",
+            "enum": [
+              "ALLOW_WITH_CREATION",
+              "DENY",
+              "ALWAYS_CREATE",
+              "BLOCK_IF_PORTAL_USER_EXISTS",
+              "DISALLOW_COMPLETELY"
+            ]
+          },
+          "block_registration_if_portal_user_exists": {
+            "type": "boolean"
+          },
+          "self_registration_entity": {
+            "type": "string",
+            "description": "Entity type used as the primary identifier for self-registration",
+            "enum": [
+              "contact",
+              "account"
+            ]
+          },
+          "user_account_self_management": {
+            "type": "boolean",
+            "description": "Enable or disable user account self management"
+          },
+          "registration_identifiers": {
+            "type": "array",
+            "description": "Identifiers to identify a contact of a portal user during the registration.",
+            "items": {
+              "$ref": "#/components/schemas/ContractIdentifier"
+            }
+          },
+          "surfaces": {
+            "type": "array",
+            "description": "Surfaces this portal's data is reached from besides the portal UI itself.",
+            "items": {
+              "$ref": "#/components/schemas/PortalSurface"
+            }
+          },
+          "is_dummy": {
+            "type": "boolean"
+          },
+          "is_v3_item": {
+            "type": "boolean"
+          },
+          "published_revision_id": {
+            "type": "string",
+            "readOnly": true,
+            "description": "ID of the currently published revision, if the portal has been published"
+          },
+          "_created_at": {
+            "type": "string",
+            "format": "date-time",
+            "readOnly": true
+          },
+          "_updated_at": {
+            "type": "string",
+            "format": "date-time",
+            "readOnly": true
+          }
+        }
+      },
       "JuiceSettings": {
         "type": "object",
         "properties": {