@epilot/sdk 2.19.1 → 2.19.2

package/docs/targeting.md

@@ -44,7 +44,9 @@ const { data } = await targetingClient.changeCampaignStatus(...)
 - [`updateRecipient`](#updaterecipient)
 - [`updateRecipientPortalStatus`](#updaterecipientportalstatus)
 - [`updateRecipientEntityUiStatus`](#updaterecipiententityuistatus)
+- [`restoreRecipientEntityUiStatus`](#restorerecipiententityuistatus)
 - [`getRecipients`](#getrecipients)
+- [`getEmailStats`](#getemailstats)
 
 **Schemas**
 - [`BaseError`](#baseerror)
@@ -67,13 +69,15 @@ const { data } = await targetingClient.changeCampaignStatus(...)
 - [`MatchCampaignParams`](#matchcampaignparams)
 - [`NextBestAction`](#nextbestaction)
 - [`DiscoverCampaignsParams`](#discovercampaignsparams)
+- [`DiscoverResult`](#discoverresult)
 - [`MatchTargetParams`](#matchtargetparams)
 - [`GetTargetQueriesParams`](#gettargetqueriesparams)
 - [`TargetQueryResult`](#targetqueryresult)
 - [`AutomationStatus`](#automationstatus)
 - [`PortalStatus`](#portalstatus)
 - [`EntityUiStatus`](#entityuistatus)
-- [`Resolution`](#resolution)
+- [`EmailStatus`](#emailstatus)
+- [`EmailBounceType`](#emailbouncetype)
 - [`Recipient`](#recipient)
 - [`BaseRecipientPayload`](#baserecipientpayload)
 - [`AutomationRecipientPayload`](#automationrecipientpayload)
@@ -90,7 +94,7 @@ const { data } = await targetingClient.changeCampaignStatus(...)
 
 ### `changeCampaignStatus`
 
-Change the status of a campaign
+Change the status of a campaign to a desired status.
 
 `POST /v1/campaign/{campaign_id}/status`
 
@@ -180,7 +184,7 @@ const { data } = await client.getCampaignJobStatus({
 
 ### `getCampaignPortals`
 
-Get portals usage info for a campaign
+Get the list of portals and its widgets where the campaign is used.
 
 `GET /v1/campaign/{campaign_id}/portals`
 
@@ -220,7 +224,7 @@ const { data } = await client.getCampaignPortals({
 
 ### `retriggerCampaignAutomations`
 
-Retrigger automations for campaign recipients
+Retrigger automation executions for specific campaign recipients that have failed.
 
 `POST /v1/campaign/{campaign_id}/automations:retrigger`
 
@@ -258,7 +262,8 @@ const { data } = await client.retriggerCampaignAutomations(
 
 ### `setupCampaign`
 
-Set up a campaign with related entities and configurations
+Creates a `campaign` entity together with its related entities and configurations in a single call.
+Used by the campaign wizard UI, but not restricted to it.
 
 `POST /v1/campaign:setup`
 
@@ -325,7 +330,7 @@ const { data } = await client.setupCampaign(
 
 ### `matchCampaigns`
 
-Match campaigns
+Match campaigns based on target entities.
 
 `POST /v1/campaign:match`
 
@@ -398,7 +403,7 @@ const { data } = await client.matchCampaigns(
 
 ### `discoverCampaigns`
 
-Discover Entity-UI Next Best Actions for an entity
+Given an entity, returns the Next Best Actions it should see on the Entity-UI channel.
 
 `POST /v1/campaign:discover`
 
@@ -434,7 +439,6 @@ const { data } = await client.discoverCampaigns(
         "cta": {
           "type": "journey",
           "target": "string",
-          "label": "string",
           "context_params": [
             {
               "key": "string",
@@ -443,7 +447,36 @@ const { data } = await client.discoverCampaigns(
           ]
         }
       },
-      "status": "seen"
+      "status": "seen",
+      "status_updated_at": "1970-01-01T00:00:00.000Z"
+    }
+  ],
+  "dismissed": [
+    {
+      "campaign_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",
+      "nba": {
+        "category": "string",
+        "icon": {
+          "name": "string",
+          "color": "string"
+        },
+        "title": "string",
+        "body": "string",
+        "priority": "medium",
+        "is_dismissable": true,
+        "cta": {
+          "type": "journey",
+          "target": "string",
+          "context_params": [
+            {
+              "key": "string",
+              "value": "string"
+            }
+          ]
+        }
+      },
+      "status": "seen",
+      "status_updated_at": "1970-01-01T00:00:00.000Z"
     }
   ]
 }
@@ -455,7 +488,7 @@ const { data } = await client.discoverCampaigns(
 
 ### `matchTargets`
 
-Match targets
+Find targets from the provided list that include the provide entities.
 
 `POST /v1/target:match`
 
@@ -517,7 +550,8 @@ const { data } = await client.matchTargets(
 
 ### `getTargetQueries`
 
-Get target queries
+Transform target filters into Lucene queries for the provided target IDs.
+Returns the transformed query string for each target along with any errors encountered.
 
 `POST /v1/target/queries`
 
@@ -551,7 +585,7 @@ const { data } = await client.getTargetQueries(
 
 ### `createRecipient`
 
-Create a recipient associated with a campaign
+Creates a new recipient associated with a campaign.
 
 `POST /v1/campaign/{campaign_id}/recipient`
 
@@ -584,7 +618,15 @@ const { data } = await client.createRecipient(
   "portal_state": {},
   "entity_ui_status": "seen",
   "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",
-  "resolution": "accepted",
+  "entity_ui_status_before_dismiss": "seen",
+  "message_entity_id": "string",
+  "email_status": "sent",
+  "email_status_updated_at": "1970-01-01T00:00:00.000Z",
+  "email_bounce_type": "permanent",
+  "email_bounce_subtype": "string",
+  "email_complaint_type": "string",
+  "email_bounce_reason": "string",
+  "email_send_error": {},
   "updated_at": "1970-01-01T00:00:00.000Z"
 }
 ```
@@ -595,7 +637,7 @@ const { data } = await client.createRecipient(
 
 ### `updateRecipient`
 
-Update a recipient
+Updates a recipient's attributes.
 
 `PATCH /v1/campaign/{campaign_id}/recipient/{recipient_id}`
 
@@ -629,7 +671,15 @@ const { data } = await client.updateRecipient(
   "portal_state": {},
   "entity_ui_status": "seen",
   "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",
-  "resolution": "accepted",
+  "entity_ui_status_before_dismiss": "seen",
+  "message_entity_id": "string",
+  "email_status": "sent",
+  "email_status_updated_at": "1970-01-01T00:00:00.000Z",
+  "email_bounce_type": "permanent",
+  "email_bounce_subtype": "string",
+  "email_complaint_type": "string",
+  "email_bounce_reason": "string",
+  "email_send_error": {},
   "updated_at": "1970-01-01T00:00:00.000Z"
 }
 ```
@@ -640,7 +690,8 @@ const { data } = await client.updateRecipient(
 
 ### `updateRecipientPortalStatus`
 
-Update portal status for a campaign recipient
+Updates the portal status for a specific campaign recipient.
+The portal_status_updated_at timestamp is automatically set when the status changes.
 
 `PATCH /v1/campaign/{campaign_id}/recipient/{recipient_id}/portal:status`
 
@@ -671,7 +722,15 @@ const { data } = await client.updateRecipientPortalStatus(
   "portal_state": {},
   "entity_ui_status": "seen",
   "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",
-  "resolution": "accepted",
+  "entity_ui_status_before_dismiss": "seen",
+  "message_entity_id": "string",
+  "email_status": "sent",
+  "email_status_updated_at": "1970-01-01T00:00:00.000Z",
+  "email_bounce_type": "permanent",
+  "email_bounce_subtype": "string",
+  "email_complaint_type": "string",
+  "email_bounce_reason": "string",
+  "email_send_error": {},
   "updated_at": "1970-01-01T00:00:00.000Z"
 }
 ```
@@ -682,7 +741,7 @@ const { data } = await client.updateRecipientPortalStatus(
 
 ### `updateRecipientEntityUiStatus`
 
-Update Entity-UI (Next Best Action) status for a campaign recipient
+Records a Next Best Action interaction for a recipient on the Entity-UI channel.
 
 `PATCH /v1/campaign/{campaign_id}/recipient/{recipient_id}/entity_ui:status`
 
@@ -714,7 +773,60 @@ const { data } = await client.updateRecipientEntityUiStatus(
   "portal_state": {},
   "entity_ui_status": "seen",
   "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",
-  "resolution": "accepted",
+  "entity_ui_status_before_dismiss": "seen",
+  "message_entity_id": "string",
+  "email_status": "sent",
+  "email_status_updated_at": "1970-01-01T00:00:00.000Z",
+  "email_bounce_type": "permanent",
+  "email_bounce_subtype": "string",
+  "email_complaint_type": "string",
+  "email_bounce_reason": "string",
+  "email_send_error": {},
+  "updated_at": "1970-01-01T00:00:00.000Z"
+}
+```
+
+</details>
+
+---
+
+### `restoreRecipientEntityUiStatus`
+
+Undo a dismissal on the Entity-UI (Next Best Action) channel
+
+`POST /v1/campaign/{campaign_id}/recipient/{recipient_id}/entity_ui:restore`
+
+```ts
+const { data } = await client.restoreRecipientEntityUiStatus({
+  campaign_id: 'example',
+  recipient_id: 'example',
+})
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",
+  "entity_schema": "string",
+  "title": "string",
+  "automation_status": "pending",
+  "automation_execution_id": "string",
+  "portal_status": "sent",
+  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",
+  "portal_state": {},
+  "entity_ui_status": "seen",
+  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",
+  "entity_ui_status_before_dismiss": "seen",
+  "message_entity_id": "string",
+  "email_status": "sent",
+  "email_status_updated_at": "1970-01-01T00:00:00.000Z",
+  "email_bounce_type": "permanent",
+  "email_bounce_subtype": "string",
+  "email_complaint_type": "string",
+  "email_bounce_reason": "string",
+  "email_send_error": {},
   "updated_at": "1970-01-01T00:00:00.000Z"
 }
 ```
@@ -725,7 +837,7 @@ const { data } = await client.updateRecipientEntityUiStatus(
 
 ### `getRecipients`
 
-Get campaign recipients
+Get a paginated list of recipients for a campaign.
 
 `GET /v1/campaign/{campaign_id}/recipients`
 
@@ -737,6 +849,7 @@ const { data } = await client.getRecipients({
   q: 'example',
   automation_status: ['...'],
   portal_status: 'example',
+  email_status: 'example',
 })
 ```
 
@@ -757,7 +870,15 @@ const { data } = await client.getRecipients({
       "portal_state": {},
       "entity_ui_status": "seen",
       "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",
-      "resolution": "accepted",
+      "entity_ui_status_before_dismiss": "seen",
+      "message_entity_id": "string",
+      "email_status": "sent",
+      "email_status_updated_at": "1970-01-01T00:00:00.000Z",
+      "email_bounce_type": "permanent",
+      "email_bounce_subtype": "string",
+      "email_complaint_type": "string",
+      "email_bounce_reason": "string",
+      "email_send_error": {},
       "updated_at": "1970-01-01T00:00:00.000Z"
     }
   ],
@@ -770,6 +891,40 @@ const { data } = await client.getRecipients({
 
 ---
 
+### `getEmailStats`
+
+Aggregate email delivery counts for a campaign, for the KPI summary on the campaign UI.
+Counts cover the email (automation) channel only; `total_emailed` is the number of
+recipients with a recorded em
+
+`GET /v1/campaign/{campaign_id}/email-stats`
+
+```ts
+const { data } = await client.getEmailStats({
+  campaign_id: 'example',
+})
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "total_emailed": 0,
+  "sent": 0,
+  "delivered": 0,
+  "bounced": 0,
+  "bounced_hard": 0,
+  "bounced_soft": 0,
+  "complained": 0,
+  "failed": 0
+}
+```
+
+</details>
+
+---
+
 ## Schemas
 
 ### `BaseError`
@@ -801,7 +956,7 @@ Describes the structure of a client error response, which can be one of several
 type ClientError = {
   message: string
 } | {
-  code: "CAMPAIGN_NOT_FOUND" | "CAMPAIGN_HAS_NO_TARGET" | "CAMPAIGN_HAS_NO_DELIVERY_METHOD" | "CAMPAIGN_HAS_JOB_IN_PROGRESS" | "CAMPAIGN_HAS_UNEXPECTED_STATUS" | "JOB_TOKEN_MISSING" | "TARGET_WITHOUT_FILTERS"
+  code: "CAMPAIGN_NOT_FOUND" | "CAMPAIGN_HAS_NO_TARGET" | "CAMPAIGN_HAS_NO_DELIVERY_METHOD" | "INVALID_NEXT_BEST_ACTION" | "CAMPAIGN_HAS_JOB_IN_PROGRESS" | "CAMPAIGN_HAS_UNEXPECTED_STATUS" | "JOB_TOKEN_MISSING" | "TARGET_WITHOUT_FILTERS"
 } | {
   error: string
   status: number
@@ -1021,9 +1176,8 @@ type NextBestAction = {
   priority?: "low" | "medium" | "high"
   is_dismissable?: boolean
   cta: {
-    type: "journey" | "workflow" | "url"
+    type: "journey" | "workflow" | "flow"
     target: string
-    label?: string
     context_params?: Array<{
       key: { ... }
       value: { ... }
@@ -1041,6 +1195,34 @@ type DiscoverCampaignsParams = {
 }
 ```
 
+### `DiscoverResult`
+
+One discovered Next Best Action, plus this entity's interaction state for it.
+
+```ts
+type DiscoverResult = {
+  campaign_id: string // uuid
+  nba: {
+    category?: string
+    icon?: {
+      name: { ... }
+      color?: { ... }
+    }
+    title: string
+    body?: string
+    priority?: "low" | "medium" | "high"
+    is_dismissable?: boolean
+    cta: {
+      type: { ... }
+      target: { ... }
+      context_params?: { ... }
+    }
+  }
+  status?: "seen" | "dismissed" | "clicked"
+  status_updated_at?: string // date-time
+}
+```
+
 ### `MatchTargetParams`
 
 ```ts
@@ -1094,15 +1276,23 @@ action is first rendered to an agent.
 type EntityUiStatus = "seen" | "dismissed" | "clicked"
 ```
 
-### `Resolution`
+### `EmailStatus`
+
+Delivery status of the email a campaign's automation sends to a recipient. Set to `sent`
+once the automation hands the email off, then updated asynchronously as SES notifications
+arrive (`bounced` / `complained`; an SES Reject maps to `bounced`). `failed` is a send-time
+failure (the automation execu
+
+```ts
+type EmailStatus = "sent" | "delivered" | "bounced" | "complained" | "failed"
+```
+
+### `EmailBounceType`
 
-Cross-channel resolution of a campaign for a recipient. Unlike the per-channel `*_status`
-fields (where `dismissed` is channel-local), a resolution suppresses the campaign on EVERY
-channel — the 360 Entity-UI card and the portal teaser alike. Server-managed and read-only:
-never sent by a client. Abs
+SES bounce classification: `permanent` (hard) or `transient` (soft).
 
 ```ts
-type Resolution = "accepted"
+type EmailBounceType = "permanent" | "transient"
 ```
 
 ### `Recipient`
@@ -1119,7 +1309,15 @@ type Recipient = {
   portal_state?: Record<string, unknown>
   entity_ui_status?: "seen" | "dismissed" | "clicked"
   entity_ui_status_updated_at?: string // date-time
-  resolution?: "accepted"
+  entity_ui_status_before_dismiss?: "seen" | "dismissed" | "clicked"
+  message_entity_id?: string
+  email_status?: "sent" | "delivered" | "bounced" | "complained" | "failed"
+  email_status_updated_at?: string // date-time
+  email_bounce_type?: "permanent" | "transient"
+  email_bounce_subtype?: string
+  email_complaint_type?: string
+  email_bounce_reason?: string
+  email_send_error?: Record<string, unknown>
   updated_at?: string // date-time
 }
 ```

package/package.json

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

package/dist/targeting-A2X6X7BF.js

@@ -1,7 +0,0 @@
-import "./chunk-YPSWSI3M.js";
-
-// src/docs/targeting.json
-var targeting_default = '# Targeting API\n\n- **Base URL:** `https://targeting.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/targeting](https://docs.epilot.io/api/targeting)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.targeting.changeCampaignStatus(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/targeting\'\n\nconst targetingClient = getClient()\nauthorize(targetingClient, () => \'<token>\')\nconst { data } = await targetingClient.changeCampaignStatus(...)\n```\n\n## Operations\n\n**Campaign**\n- [`changeCampaignStatus`](#changecampaignstatus)\n- [`getCampaignJobStatus`](#getcampaignjobstatus)\n- [`getCampaignPortals`](#getcampaignportals)\n- [`setupCampaign`](#setupcampaign)\n- [`matchCampaigns`](#matchcampaigns)\n- [`discoverCampaigns`](#discovercampaigns)\n\n**Campaign Delivery**\n- [`retriggerCampaignAutomations`](#retriggercampaignautomations)\n\n**Target**\n- [`matchTargets`](#matchtargets)\n- [`getTargetQueries`](#gettargetqueries)\n\n**Campaign Recipient**\n- [`createRecipient`](#createrecipient)\n- [`updateRecipient`](#updaterecipient)\n- [`updateRecipientPortalStatus`](#updaterecipientportalstatus)\n- [`updateRecipientEntityUiStatus`](#updaterecipiententityuistatus)\n- [`getRecipients`](#getrecipients)\n\n**Schemas**\n- [`BaseError`](#baseerror)\n- [`ServerError`](#servererror)\n- [`ClientError`](#clienterror)\n- [`BaseUUID`](#baseuuid)\n- [`BaseNanoID`](#basenanoid)\n- [`BaseTags`](#basetags)\n- [`BaseRelation`](#baserelation)\n- [`BaseSystemId`](#basesystemid)\n- [`BaseEntityOwner`](#baseentityowner)\n- [`BaseEntityAcl`](#baseentityacl)\n- [`BaseSystemFields`](#basesystemfields)\n- [`BaseSystemFieldsRequired`](#basesystemfieldsrequired)\n- [`CampaignStatus`](#campaignstatus)\n- [`ExecutionSummaryItem`](#executionsummaryitem)\n- [`JobStatus`](#jobstatus)\n- [`Campaign`](#campaign)\n- [`Target`](#target)\n- [`MatchCampaignParams`](#matchcampaignparams)\n- [`NextBestAction`](#nextbestaction)\n- [`DiscoverCampaignsParams`](#discovercampaignsparams)\n- [`MatchTargetParams`](#matchtargetparams)\n- [`GetTargetQueriesParams`](#gettargetqueriesparams)\n- [`TargetQueryResult`](#targetqueryresult)\n- [`AutomationStatus`](#automationstatus)\n- [`PortalStatus`](#portalstatus)\n- [`EntityUiStatus`](#entityuistatus)\n- [`Resolution`](#resolution)\n- [`Recipient`](#recipient)\n- [`BaseRecipientPayload`](#baserecipientpayload)\n- [`AutomationRecipientPayload`](#automationrecipientpayload)\n- [`PortalRecipientPayload`](#portalrecipientpayload)\n- [`CreateRecipientPayload`](#createrecipientpayload)\n- [`UpdateRecipientPayload`](#updaterecipientpayload)\n- [`RetriggerAutomationsRequest`](#retriggerautomationsrequest)\n- [`RetriggerAutomationsResult`](#retriggerautomationsresult)\n- [`UpdatePortalStatusRequest`](#updateportalstatusrequest)\n- [`UpdateEntityUiStatusRequest`](#updateentityuistatusrequest)\n- [`SetupCampaignRequest`](#setupcampaignrequest)\n- [`SetupTariffChangeCampaignRequest`](#setuptariffchangecampaignrequest)\n- [`SetupTariffChangeCampaignResponse`](#setuptariffchangecampaignresponse)\n\n### `changeCampaignStatus`\n\nChange the status of a campaign\n\n`POST /v1/campaign/{campaign_id}/status`\n\n```ts\nconst { data } = await client.changeCampaignStatus({\n  campaign_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "campaign": {\n    "_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n    "_org": "string",\n    "_owners": [\n      {\n        "org_id": "123",\n        "user_id": "123"\n      }\n    ],\n    "_schema": "string",\n    "_title": "string",\n    "_tags": ["string"],\n    "_created_at": "1970-01-01T00:00:00.000Z",\n    "_updated_at": "1970-01-01T00:00:00.000Z",\n    "_acl": {\n      "view": ["org:456"],\n      "edit": ["org:456"],\n      "delete": ["org:456"]\n    },\n    "name": "string",\n    "goal": "string",\n    "status": "draft",\n    "start_date": "1970-01-01",\n    "end_date": "1970-01-01",\n    "flow_id": "string",\n    "job_id": "string",\n    "target": {\n      "$relation": [\n        {\n          "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n          "_tags": ["string"]\n        }\n      ]\n    }\n  }\n}\n```\n\n</details>\n\n---\n\n### `getCampaignJobStatus`\n\nGet the status of a campaign\'s automation job\n\n`GET /v1/campaign/{campaign_id}/job`\n\n```ts\nconst { data } = await client.getCampaignJobStatus({\n  campaign_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "status": "queued",\n  "execution_summary": [\n    {\n      "execution_id": "string",\n      "execution_status": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getCampaignPortals`\n\nGet portals usage info for a campaign\n\n`GET /v1/campaign/{campaign_id}/portals`\n\n```ts\nconst { data } = await client.getCampaignPortals({\n  campaign_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n[\n  {\n    "portal": {\n      "origin": "string",\n      "domain": "string",\n      "name": "string"\n    },\n    "widgets": [\n      {\n        "id": "string",\n        "headline": {\n          "en": "string",\n          "de": "string"\n        }\n      }\n    ]\n  }\n]\n```\n\n</details>\n\n---\n\n### `retriggerCampaignAutomations`\n\nRetrigger automations for campaign recipients\n\n`POST /v1/campaign/{campaign_id}/automations:retrigger`\n\n```ts\nconst { data } = await client.retriggerCampaignAutomations(\n  {\n    campaign_id: \'example\',\n  },\n  {\n    recipient_ids: [\'3fa85f64-5717-4562-b3fc-2c963f66afa6\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "message": "string",\n  "results": [\n    {\n      "recipient_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "result": "success",\n      "execution_id": "string",\n      "error": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `setupCampaign`\n\nSet up a campaign with related entities and configurations\n\n`POST /v1/campaign:setup`\n\n```ts\nconst { data } = await client.setupCampaign(\n  null,\n  {\n    type: \'tariff_change\',\n    product_recommendation: {\n      name: \'string\',\n      source_product_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n      source_price_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n      offers: [\n        {\n          target_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n          items: [\n            {\n              product_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n              price_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n              highlight_config: {}\n            }\n          ]\n        }\n      ]\n    },\n    campaign: {\n      name: \'string\',\n      goal: \'string\',\n      target_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n    },\n    journey: {\n      journey_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\'\n    },\n    channels: {\n      portal_widget: {\n        portal_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        block_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\'\n      },\n      email: {\n        automation_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        template_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\'\n      }\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "type": "tariff_change",\n  "product_recommendation_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "campaign_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "journey_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "portal_widget_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84"\n}\n```\n\n</details>\n\n---\n\n### `matchCampaigns`\n\nMatch campaigns\n\n`POST /v1/campaign:match`\n\n```ts\nconst { data } = await client.matchCampaigns(\n  null,\n  {\n    entity_refs: [\n      {\n        entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        entity_schema: \'string\'\n      }\n    ],\n    campaign_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "hits": 0,\n  "results": [\n    {\n      "campaign": {\n        "_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n        "_org": "string",\n        "_owners": [\n          {\n            "org_id": "123",\n            "user_id": "123"\n          }\n        ],\n        "_schema": "string",\n        "_title": "string",\n        "_tags": ["string"],\n        "_created_at": "1970-01-01T00:00:00.000Z",\n        "_updated_at": "1970-01-01T00:00:00.000Z",\n        "_acl": {\n          "view": ["org:456"],\n          "edit": ["org:456"],\n          "delete": ["org:456"]\n        },\n        "name": "string",\n        "goal": "string",\n        "status": "draft",\n        "start_date": "1970-01-01",\n        "end_date": "1970-01-01",\n        "flow_id": "string",\n        "job_id": "string",\n        "target": {\n          "$relation": [\n            {\n              "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n              "_tags": ["string"]\n            }\n          ]\n        }\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `discoverCampaigns`\n\nDiscover Entity-UI Next Best Actions for an entity\n\n`POST /v1/campaign:discover`\n\n```ts\nconst { data } = await client.discoverCampaigns(\n  null,\n  {\n    entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n    entity_schema: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "hits": 0,\n  "results": [\n    {\n      "campaign_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n      "nba": {\n        "category": "string",\n        "icon": {\n          "name": "string",\n          "color": "string"\n        },\n        "title": "string",\n        "body": "string",\n        "priority": "medium",\n        "is_dismissable": true,\n        "cta": {\n          "type": "journey",\n          "target": "string",\n          "label": "string",\n          "context_params": [\n            {\n              "key": "string",\n              "value": "string"\n            }\n          ]\n        }\n      },\n      "status": "seen"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `matchTargets`\n\nMatch targets\n\n`POST /v1/target:match`\n\n```ts\nconst { data } = await client.matchTargets(\n  null,\n  {\n    entity_refs: [\n      {\n        entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        entity_schema: \'string\'\n      }\n    ],\n    target_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "hits": 0,\n  "results": [\n    {\n      "target": {\n        "_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n        "_org": "string",\n        "_owners": [\n          {\n            "org_id": "123",\n            "user_id": "123"\n          }\n        ],\n        "_schema": "string",\n        "_title": "string",\n        "_tags": ["string"],\n        "_created_at": "1970-01-01T00:00:00.000Z",\n        "_updated_at": "1970-01-01T00:00:00.000Z",\n        "_acl": {\n          "view": ["org:456"],\n          "edit": ["org:456"],\n          "delete": ["org:456"]\n        },\n        "name": "string",\n        "description": "string",\n        "entity_schema": "string",\n        "entity_filters": {}\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getTargetQueries`\n\nGet target queries\n\n`POST /v1/target/queries`\n\n```ts\nconst { data } = await client.getTargetQueries(\n  null,\n  {\n    target_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "target_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n      "query": "string",\n      "error": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `createRecipient`\n\nCreate a recipient associated with a campaign\n\n`POST /v1/campaign/{campaign_id}/recipient`\n\n```ts\nconst { data } = await client.createRecipient(\n  {\n    campaign_id: \'example\',\n  },\n  {\n    entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n    entity_schema: \'string\',\n    automation_status: \'pending\',\n    automation_execution_id: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "resolution": "accepted",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateRecipient`\n\nUpdate a recipient\n\n`PATCH /v1/campaign/{campaign_id}/recipient/{recipient_id}`\n\n```ts\nconst { data } = await client.updateRecipient(\n  {\n    campaign_id: \'example\',\n    recipient_id: \'example\',\n  },\n  {\n    automation_status: \'pending\',\n    automation_execution_id: \'string\',\n    portal_status: \'sent\',\n    portal_state: {}\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "resolution": "accepted",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateRecipientPortalStatus`\n\nUpdate portal status for a campaign recipient\n\n`PATCH /v1/campaign/{campaign_id}/recipient/{recipient_id}/portal:status`\n\n```ts\nconst { data } = await client.updateRecipientPortalStatus(\n  {\n    campaign_id: \'example\',\n    recipient_id: \'example\',\n  },\n  {\n    status: \'sent\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "resolution": "accepted",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateRecipientEntityUiStatus`\n\nUpdate Entity-UI (Next Best Action) status for a campaign recipient\n\n`PATCH /v1/campaign/{campaign_id}/recipient/{recipient_id}/entity_ui:status`\n\n```ts\nconst { data } = await client.updateRecipientEntityUiStatus(\n  {\n    campaign_id: \'example\',\n    recipient_id: \'example\',\n  },\n  {\n    status: \'seen\',\n    entity_schema: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "resolution": "accepted",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `getRecipients`\n\nGet campaign recipients\n\n`GET /v1/campaign/{campaign_id}/recipients`\n\n```ts\nconst { data } = await client.getRecipients({\n  campaign_id: \'example\',\n  limit: 1,\n  next: \'example\',\n  q: \'example\',\n  automation_status: [\'...\'],\n  portal_status: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n      "entity_schema": "string",\n      "title": "string",\n      "automation_status": "pending",\n      "automation_execution_id": "string",\n      "portal_status": "sent",\n      "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n      "portal_state": {},\n      "entity_ui_status": "seen",\n      "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n      "resolution": "accepted",\n      "updated_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "next": "string",\n  "total": 0\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `BaseError`\n\n```ts\ntype BaseError = {\n  status: number\n  message: string\n}\n```\n\n### `ServerError`\n\n```ts\ntype ServerError = {\n  status: number\n  message: string\n}\n```\n\n### `ClientError`\n\nDescribes the structure of a client error response, which can be one of several types:\n1. `MessageError`: Contains a \'message\' field for general descriptive errors.\n2. `CodeError`: Contains a \'code\' field for specific, machine-readable error codes.\n3. `StatusedError`: Contains \'error\' and \'status\' f\n\n```ts\ntype ClientError = {\n  message: string\n} | {\n  code: "CAMPAIGN_NOT_FOUND" | "CAMPAIGN_HAS_NO_TARGET" | "CAMPAIGN_HAS_NO_DELIVERY_METHOD" | "CAMPAIGN_HAS_JOB_IN_PROGRESS" | "CAMPAIGN_HAS_UNEXPECTED_STATUS" | "JOB_TOKEN_MISSING" | "TARGET_WITHOUT_FILTERS"\n} | {\n  error: string\n  status: number\n}\n```\n\n### `BaseUUID`\n\n```ts\ntype BaseUUID = string // uuid\n```\n\n### `BaseNanoID`\n\n```ts\ntype BaseNanoID = string\n```\n\n### `BaseTags`\n\n```ts\ntype BaseTags = string[]\n```\n\n### `BaseRelation`\n\n```ts\ntype BaseRelation = {\n  $relation?: Array<{\n    entity_id?: string // uuid\n    _tags?: string[]\n  }>\n}\n```\n\n### `BaseSystemId`\n\n```ts\ntype BaseSystemId = {\n  _id: string // uuid\n}\n```\n\n### `BaseEntityOwner`\n\nThe user / organization owning this entity.\n\nNote: Owner implicitly has access to the entity regardless of ACLs.\n\n\n```ts\ntype BaseEntityOwner = {\n  org_id: string\n  user_id?: string\n}\n```\n\n### `BaseEntityAcl`\n\nAccess control list (ACL) for an entity. Defines sharing access to external orgs or users.\n\n```ts\ntype BaseEntityAcl = {\n  view?: string[]\n  edit?: string[]\n  delete?: string[]\n}\n```\n\n### `BaseSystemFields`\n\n```ts\ntype BaseSystemFields = {\n  _id?: string // uuid\n  _org?: string\n  _owners?: Array<{\n    org_id: string\n    user_id?: string\n  }>\n  _schema?: string\n  _title?: string\n  _tags?: string[]\n  _created_at?: string // date-time\n  _updated_at?: string // date-time\n  _acl?: {\n    view?: string[]\n    edit?: string[]\n    delete?: string[]\n  }\n}\n```\n\n### `BaseSystemFieldsRequired`\n\n```ts\ntype BaseSystemFieldsRequired = object\n```\n\n### `CampaignStatus`\n\n```ts\ntype CampaignStatus = "draft" | "activating" | "active" | "inactive"\n```\n\n### `ExecutionSummaryItem`\n\n```ts\ntype ExecutionSummaryItem = {\n  execution_id?: string\n  execution_status?: string\n}\n```\n\n### `JobStatus`\n\n```ts\ntype JobStatus = {\n  status?: "queued" | "processing" | "finished" | "failed" | "cancelled" | "send_report"\n  execution_summary?: Array<{\n    execution_id?: string\n    execution_status?: string\n  }>\n}\n```\n\n### `Campaign`\n\n```ts\ntype Campaign = {\n  _id?: string // uuid\n  _org?: string\n  _owners?: Array<{\n    org_id: string\n    user_id?: string\n  }>\n  _schema?: string\n  _title?: string\n  _tags?: string[]\n  _created_at?: string // date-time\n  _updated_at?: string // date-time\n  _acl?: {\n    view?: string[]\n    edit?: string[]\n    delete?: string[]\n  }\n  name?: string\n  goal?: string\n  status?: "draft" | "activating" | "active" | "inactive"\n  start_date?: string // date\n  end_date?: string // date\n  flow_id?: string\n  job_id?: string\n  target?: {\n    $relation?: Array<{\n      entity_id?: { ... }\n      _tags?: { ... }\n    }>\n  }\n}\n```\n\n### `Target`\n\n```ts\ntype Target = {\n  _id?: string // uuid\n  _org?: string\n  _owners?: Array<{\n    org_id: string\n    user_id?: string\n  }>\n  _schema?: string\n  _title?: string\n  _tags?: string[]\n  _created_at?: string // date-time\n  _updated_at?: string // date-time\n  _acl?: {\n    view?: string[]\n    edit?: string[]\n    delete?: string[]\n  }\n  name?: string\n  description?: string\n  entity_schema?: string\n  entity_filters?: Record<string, unknown>\n}\n```\n\n### `MatchCampaignParams`\n\n```ts\ntype MatchCampaignParams = {\n  entity_refs: Array<{\n    entity_id: string // uuid\n    entity_schema: string\n  }>\n  campaign_ids: string // uuid[]\n}\n```\n\n### `NextBestAction`\n\nA Next Best Action configured on a campaign\'s Entity-UI channel.\nThis is the canonical NBA contract shared by discovery (this API), authoring, and rendering.\nNBA content is single-language in v1; text fields may contain `{{placeholders}}` resolved at render time.\n\n\n```ts\ntype NextBestAction = {\n  category?: string\n  icon?: {\n    name: string\n    color?: string\n  }\n  title: string\n  body?: string\n  priority?: "low" | "medium" | "high"\n  is_dismissable?: boolean\n  cta: {\n    type: "journey" | "workflow" | "url"\n    target: string\n    label?: string\n    context_params?: Array<{\n      key: { ... }\n      value: { ... }\n    }>\n  }\n}\n```\n\n### `DiscoverCampaignsParams`\n\n```ts\ntype DiscoverCampaignsParams = {\n  entity_id: string // uuid\n  entity_schema: string\n}\n```\n\n### `MatchTargetParams`\n\n```ts\ntype MatchTargetParams = {\n  entity_refs: Array<{\n    entity_id: string // uuid\n    entity_schema: string\n  }>\n  target_ids: string // uuid[]\n}\n```\n\n### `GetTargetQueriesParams`\n\n```ts\ntype GetTargetQueriesParams = {\n  target_ids: string // uuid[]\n}\n```\n\n### `TargetQueryResult`\n\n```ts\ntype TargetQueryResult = {\n  target_id: string // uuid\n  query: string\n  error?: string\n}\n```\n\n### `AutomationStatus`\n\n```ts\ntype AutomationStatus = "pending" | "in_progress" | "success" | "failed" | "cancelled"\n```\n\n### `PortalStatus`\n\n```ts\ntype PortalStatus = "sent" | "seen" | "dismissed" | "clicked"\n```\n\n### `EntityUiStatus`\n\nLifecycle status of a Next Best Action on the Entity-UI channel. Unlike the portal\nchannel there is no `sent` state: an NBA recipient is born at `seen`, the moment the\naction is first rendered to an agent.\n\n\n```ts\ntype EntityUiStatus = "seen" | "dismissed" | "clicked"\n```\n\n### `Resolution`\n\nCross-channel resolution of a campaign for a recipient. Unlike the per-channel `*_status`\nfields (where `dismissed` is channel-local), a resolution suppresses the campaign on EVERY\nchannel \u2014 the 360 Entity-UI card and the portal teaser alike. Server-managed and read-only:\nnever sent by a client. Abs\n\n```ts\ntype Resolution = "accepted"\n```\n\n### `Recipient`\n\n```ts\ntype Recipient = {\n  entity_id?: string // uuid\n  entity_schema?: string\n  title?: string\n  automation_status?: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id?: string\n  portal_status?: "sent" | "seen" | "dismissed" | "clicked"\n  portal_status_updated_at?: string // date-time\n  portal_state?: Record<string, unknown>\n  entity_ui_status?: "seen" | "dismissed" | "clicked"\n  entity_ui_status_updated_at?: string // date-time\n  resolution?: "accepted"\n  updated_at?: string // date-time\n}\n```\n\n### `BaseRecipientPayload`\n\n```ts\ntype BaseRecipientPayload = {\n  entity_id: string // uuid\n  entity_schema: string\n}\n```\n\n### `AutomationRecipientPayload`\n\n```ts\ntype AutomationRecipientPayload = {\n  automation_status: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id: string\n}\n```\n\n### `PortalRecipientPayload`\n\n```ts\ntype PortalRecipientPayload = {\n  portal_status: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n}\n```\n\n### `CreateRecipientPayload`\n\n```ts\ntype CreateRecipientPayload = {\n  entity_id: string // uuid\n  entity_schema: string\n  automation_status: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id: string\n} | {\n  entity_id: string // uuid\n  entity_schema: string\n  portal_status: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n} | {\n  entity_id: string // uuid\n  entity_schema: string\n  automation_status: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id: string\n  portal_status: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n}\n```\n\n### `UpdateRecipientPayload`\n\n```ts\ntype UpdateRecipientPayload = {\n  automation_status?: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id?: string\n  portal_status?: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n}\n```\n\n### `RetriggerAutomationsRequest`\n\n```ts\ntype RetriggerAutomationsRequest = {\n  recipient_ids: string // uuid[]\n}\n```\n\n### `RetriggerAutomationsResult`\n\n```ts\ntype RetriggerAutomationsResult = {\n  recipient_id: string // uuid\n  result: "success" | "failure" | "not_found" | "invalid_status"\n  execution_id?: string\n  error?: string\n}\n```\n\n### `UpdatePortalStatusRequest`\n\n```ts\ntype UpdatePortalStatusRequest = {\n  status: "sent" | "seen" | "dismissed" | "clicked"\n}\n```\n\n### `UpdateEntityUiStatusRequest`\n\n```ts\ntype UpdateEntityUiStatusRequest = {\n  status: "seen" | "dismissed" | "clicked"\n  entity_schema?: string\n}\n```\n\n### `SetupCampaignRequest`\n\nDiscriminated by `type`. Each campaign variant has its own request shape;\nnew variants are added by introducing a new schema and extending the `oneOf` list.\n\n\n```ts\ntype SetupCampaignRequest = {\n  type: "tariff_change"\n  product_recommendation: {\n    name?: string\n    source_product_id?: string // uuid\n    source_price_id?: string // uuid\n    offers?: Array<{\n      target_id?: { ... }\n      items: { ... }\n    }>\n  }\n  campaign: {\n    name: string\n    goal?: string\n    target_ids: string // uuid[]\n  }\n  journey?: {\n    journey_id: string // uuid\n  }\n  channels?: {\n    portal_widget?: {\n      portal_id: { ... }\n      block_id: { ... }\n    }\n    email?: {\n      automation_id?: { ... }\n      template_id?: { ... }\n    }\n  }\n}\n```\n\n### `SetupTariffChangeCampaignRequest`\n\n```ts\ntype SetupTariffChangeCampaignRequest = {\n  type: "tariff_change"\n  product_recommendation: {\n    name?: string\n    source_product_id?: string // uuid\n    source_price_id?: string // uuid\n    offers?: Array<{\n      target_id?: { ... }\n      items: { ... }\n    }>\n  }\n  campaign: {\n    name: string\n    goal?: string\n    target_ids: string // uuid[]\n  }\n  journey?: {\n    journey_id: string // uuid\n  }\n  channels?: {\n    portal_widget?: {\n      portal_id: { ... }\n      block_id: { ... }\n    }\n    email?: {\n      automation_id?: { ... }\n      template_id?: { ... }\n    }\n  }\n}\n```\n\n### `SetupTariffChangeCampaignResponse`\n\n```ts\ntype SetupTariffChangeCampaignResponse = {\n  type: "tariff_change"\n  product_recommendation_id: string // uuid\n  campaign_id: string // uuid\n  journey_id?: string // uuid\n  portal_widget_id?: string // uuid\n}\n```\n';
-export {
-  targeting_default as default
-};

package/dist/targeting-CSGKITGV.cjs

@@ -1,7 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
-
-// src/docs/targeting.json
-var targeting_default = '# Targeting API\n\n- **Base URL:** `https://targeting.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/targeting](https://docs.epilot.io/api/targeting)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.targeting.changeCampaignStatus(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/targeting\'\n\nconst targetingClient = getClient()\nauthorize(targetingClient, () => \'<token>\')\nconst { data } = await targetingClient.changeCampaignStatus(...)\n```\n\n## Operations\n\n**Campaign**\n- [`changeCampaignStatus`](#changecampaignstatus)\n- [`getCampaignJobStatus`](#getcampaignjobstatus)\n- [`getCampaignPortals`](#getcampaignportals)\n- [`setupCampaign`](#setupcampaign)\n- [`matchCampaigns`](#matchcampaigns)\n- [`discoverCampaigns`](#discovercampaigns)\n\n**Campaign Delivery**\n- [`retriggerCampaignAutomations`](#retriggercampaignautomations)\n\n**Target**\n- [`matchTargets`](#matchtargets)\n- [`getTargetQueries`](#gettargetqueries)\n\n**Campaign Recipient**\n- [`createRecipient`](#createrecipient)\n- [`updateRecipient`](#updaterecipient)\n- [`updateRecipientPortalStatus`](#updaterecipientportalstatus)\n- [`updateRecipientEntityUiStatus`](#updaterecipiententityuistatus)\n- [`getRecipients`](#getrecipients)\n\n**Schemas**\n- [`BaseError`](#baseerror)\n- [`ServerError`](#servererror)\n- [`ClientError`](#clienterror)\n- [`BaseUUID`](#baseuuid)\n- [`BaseNanoID`](#basenanoid)\n- [`BaseTags`](#basetags)\n- [`BaseRelation`](#baserelation)\n- [`BaseSystemId`](#basesystemid)\n- [`BaseEntityOwner`](#baseentityowner)\n- [`BaseEntityAcl`](#baseentityacl)\n- [`BaseSystemFields`](#basesystemfields)\n- [`BaseSystemFieldsRequired`](#basesystemfieldsrequired)\n- [`CampaignStatus`](#campaignstatus)\n- [`ExecutionSummaryItem`](#executionsummaryitem)\n- [`JobStatus`](#jobstatus)\n- [`Campaign`](#campaign)\n- [`Target`](#target)\n- [`MatchCampaignParams`](#matchcampaignparams)\n- [`NextBestAction`](#nextbestaction)\n- [`DiscoverCampaignsParams`](#discovercampaignsparams)\n- [`MatchTargetParams`](#matchtargetparams)\n- [`GetTargetQueriesParams`](#gettargetqueriesparams)\n- [`TargetQueryResult`](#targetqueryresult)\n- [`AutomationStatus`](#automationstatus)\n- [`PortalStatus`](#portalstatus)\n- [`EntityUiStatus`](#entityuistatus)\n- [`Resolution`](#resolution)\n- [`Recipient`](#recipient)\n- [`BaseRecipientPayload`](#baserecipientpayload)\n- [`AutomationRecipientPayload`](#automationrecipientpayload)\n- [`PortalRecipientPayload`](#portalrecipientpayload)\n- [`CreateRecipientPayload`](#createrecipientpayload)\n- [`UpdateRecipientPayload`](#updaterecipientpayload)\n- [`RetriggerAutomationsRequest`](#retriggerautomationsrequest)\n- [`RetriggerAutomationsResult`](#retriggerautomationsresult)\n- [`UpdatePortalStatusRequest`](#updateportalstatusrequest)\n- [`UpdateEntityUiStatusRequest`](#updateentityuistatusrequest)\n- [`SetupCampaignRequest`](#setupcampaignrequest)\n- [`SetupTariffChangeCampaignRequest`](#setuptariffchangecampaignrequest)\n- [`SetupTariffChangeCampaignResponse`](#setuptariffchangecampaignresponse)\n\n### `changeCampaignStatus`\n\nChange the status of a campaign\n\n`POST /v1/campaign/{campaign_id}/status`\n\n```ts\nconst { data } = await client.changeCampaignStatus({\n  campaign_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "campaign": {\n    "_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n    "_org": "string",\n    "_owners": [\n      {\n        "org_id": "123",\n        "user_id": "123"\n      }\n    ],\n    "_schema": "string",\n    "_title": "string",\n    "_tags": ["string"],\n    "_created_at": "1970-01-01T00:00:00.000Z",\n    "_updated_at": "1970-01-01T00:00:00.000Z",\n    "_acl": {\n      "view": ["org:456"],\n      "edit": ["org:456"],\n      "delete": ["org:456"]\n    },\n    "name": "string",\n    "goal": "string",\n    "status": "draft",\n    "start_date": "1970-01-01",\n    "end_date": "1970-01-01",\n    "flow_id": "string",\n    "job_id": "string",\n    "target": {\n      "$relation": [\n        {\n          "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n          "_tags": ["string"]\n        }\n      ]\n    }\n  }\n}\n```\n\n</details>\n\n---\n\n### `getCampaignJobStatus`\n\nGet the status of a campaign\'s automation job\n\n`GET /v1/campaign/{campaign_id}/job`\n\n```ts\nconst { data } = await client.getCampaignJobStatus({\n  campaign_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "status": "queued",\n  "execution_summary": [\n    {\n      "execution_id": "string",\n      "execution_status": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getCampaignPortals`\n\nGet portals usage info for a campaign\n\n`GET /v1/campaign/{campaign_id}/portals`\n\n```ts\nconst { data } = await client.getCampaignPortals({\n  campaign_id: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n[\n  {\n    "portal": {\n      "origin": "string",\n      "domain": "string",\n      "name": "string"\n    },\n    "widgets": [\n      {\n        "id": "string",\n        "headline": {\n          "en": "string",\n          "de": "string"\n        }\n      }\n    ]\n  }\n]\n```\n\n</details>\n\n---\n\n### `retriggerCampaignAutomations`\n\nRetrigger automations for campaign recipients\n\n`POST /v1/campaign/{campaign_id}/automations:retrigger`\n\n```ts\nconst { data } = await client.retriggerCampaignAutomations(\n  {\n    campaign_id: \'example\',\n  },\n  {\n    recipient_ids: [\'3fa85f64-5717-4562-b3fc-2c963f66afa6\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "message": "string",\n  "results": [\n    {\n      "recipient_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",\n      "result": "success",\n      "execution_id": "string",\n      "error": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `setupCampaign`\n\nSet up a campaign with related entities and configurations\n\n`POST /v1/campaign:setup`\n\n```ts\nconst { data } = await client.setupCampaign(\n  null,\n  {\n    type: \'tariff_change\',\n    product_recommendation: {\n      name: \'string\',\n      source_product_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n      source_price_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n      offers: [\n        {\n          target_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n          items: [\n            {\n              product_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n              price_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n              highlight_config: {}\n            }\n          ]\n        }\n      ]\n    },\n    campaign: {\n      name: \'string\',\n      goal: \'string\',\n      target_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n    },\n    journey: {\n      journey_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\'\n    },\n    channels: {\n      portal_widget: {\n        portal_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        block_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\'\n      },\n      email: {\n        automation_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        template_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\'\n      }\n    }\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "type": "tariff_change",\n  "product_recommendation_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "campaign_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "journey_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "portal_widget_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84"\n}\n```\n\n</details>\n\n---\n\n### `matchCampaigns`\n\nMatch campaigns\n\n`POST /v1/campaign:match`\n\n```ts\nconst { data } = await client.matchCampaigns(\n  null,\n  {\n    entity_refs: [\n      {\n        entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        entity_schema: \'string\'\n      }\n    ],\n    campaign_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "hits": 0,\n  "results": [\n    {\n      "campaign": {\n        "_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n        "_org": "string",\n        "_owners": [\n          {\n            "org_id": "123",\n            "user_id": "123"\n          }\n        ],\n        "_schema": "string",\n        "_title": "string",\n        "_tags": ["string"],\n        "_created_at": "1970-01-01T00:00:00.000Z",\n        "_updated_at": "1970-01-01T00:00:00.000Z",\n        "_acl": {\n          "view": ["org:456"],\n          "edit": ["org:456"],\n          "delete": ["org:456"]\n        },\n        "name": "string",\n        "goal": "string",\n        "status": "draft",\n        "start_date": "1970-01-01",\n        "end_date": "1970-01-01",\n        "flow_id": "string",\n        "job_id": "string",\n        "target": {\n          "$relation": [\n            {\n              "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n              "_tags": ["string"]\n            }\n          ]\n        }\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `discoverCampaigns`\n\nDiscover Entity-UI Next Best Actions for an entity\n\n`POST /v1/campaign:discover`\n\n```ts\nconst { data } = await client.discoverCampaigns(\n  null,\n  {\n    entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n    entity_schema: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "hits": 0,\n  "results": [\n    {\n      "campaign_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n      "nba": {\n        "category": "string",\n        "icon": {\n          "name": "string",\n          "color": "string"\n        },\n        "title": "string",\n        "body": "string",\n        "priority": "medium",\n        "is_dismissable": true,\n        "cta": {\n          "type": "journey",\n          "target": "string",\n          "label": "string",\n          "context_params": [\n            {\n              "key": "string",\n              "value": "string"\n            }\n          ]\n        }\n      },\n      "status": "seen"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `matchTargets`\n\nMatch targets\n\n`POST /v1/target:match`\n\n```ts\nconst { data } = await client.matchTargets(\n  null,\n  {\n    entity_refs: [\n      {\n        entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n        entity_schema: \'string\'\n      }\n    ],\n    target_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "hits": 0,\n  "results": [\n    {\n      "target": {\n        "_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n        "_org": "string",\n        "_owners": [\n          {\n            "org_id": "123",\n            "user_id": "123"\n          }\n        ],\n        "_schema": "string",\n        "_title": "string",\n        "_tags": ["string"],\n        "_created_at": "1970-01-01T00:00:00.000Z",\n        "_updated_at": "1970-01-01T00:00:00.000Z",\n        "_acl": {\n          "view": ["org:456"],\n          "edit": ["org:456"],\n          "delete": ["org:456"]\n        },\n        "name": "string",\n        "description": "string",\n        "entity_schema": "string",\n        "entity_filters": {}\n      }\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `getTargetQueries`\n\nGet target queries\n\n`POST /v1/target/queries`\n\n```ts\nconst { data } = await client.getTargetQueries(\n  null,\n  {\n    target_ids: [\'b8c01433-5556-4e2b-aad4-6f5348d1df84\']\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "target_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n      "query": "string",\n      "error": "string"\n    }\n  ]\n}\n```\n\n</details>\n\n---\n\n### `createRecipient`\n\nCreate a recipient associated with a campaign\n\n`POST /v1/campaign/{campaign_id}/recipient`\n\n```ts\nconst { data } = await client.createRecipient(\n  {\n    campaign_id: \'example\',\n  },\n  {\n    entity_id: \'b8c01433-5556-4e2b-aad4-6f5348d1df84\',\n    entity_schema: \'string\',\n    automation_status: \'pending\',\n    automation_execution_id: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "resolution": "accepted",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateRecipient`\n\nUpdate a recipient\n\n`PATCH /v1/campaign/{campaign_id}/recipient/{recipient_id}`\n\n```ts\nconst { data } = await client.updateRecipient(\n  {\n    campaign_id: \'example\',\n    recipient_id: \'example\',\n  },\n  {\n    automation_status: \'pending\',\n    automation_execution_id: \'string\',\n    portal_status: \'sent\',\n    portal_state: {}\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "resolution": "accepted",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateRecipientPortalStatus`\n\nUpdate portal status for a campaign recipient\n\n`PATCH /v1/campaign/{campaign_id}/recipient/{recipient_id}/portal:status`\n\n```ts\nconst { data } = await client.updateRecipientPortalStatus(\n  {\n    campaign_id: \'example\',\n    recipient_id: \'example\',\n  },\n  {\n    status: \'sent\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "resolution": "accepted",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `updateRecipientEntityUiStatus`\n\nUpdate Entity-UI (Next Best Action) status for a campaign recipient\n\n`PATCH /v1/campaign/{campaign_id}/recipient/{recipient_id}/entity_ui:status`\n\n```ts\nconst { data } = await client.updateRecipientEntityUiStatus(\n  {\n    campaign_id: \'example\',\n    recipient_id: \'example\',\n  },\n  {\n    status: \'seen\',\n    entity_schema: \'string\'\n  },\n)\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n  "entity_schema": "string",\n  "title": "string",\n  "automation_status": "pending",\n  "automation_execution_id": "string",\n  "portal_status": "sent",\n  "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "portal_state": {},\n  "entity_ui_status": "seen",\n  "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n  "resolution": "accepted",\n  "updated_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `getRecipients`\n\nGet campaign recipients\n\n`GET /v1/campaign/{campaign_id}/recipients`\n\n```ts\nconst { data } = await client.getRecipients({\n  campaign_id: \'example\',\n  limit: 1,\n  next: \'example\',\n  q: \'example\',\n  automation_status: [\'...\'],\n  portal_status: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "entity_id": "b8c01433-5556-4e2b-aad4-6f5348d1df84",\n      "entity_schema": "string",\n      "title": "string",\n      "automation_status": "pending",\n      "automation_execution_id": "string",\n      "portal_status": "sent",\n      "portal_status_updated_at": "1970-01-01T00:00:00.000Z",\n      "portal_state": {},\n      "entity_ui_status": "seen",\n      "entity_ui_status_updated_at": "1970-01-01T00:00:00.000Z",\n      "resolution": "accepted",\n      "updated_at": "1970-01-01T00:00:00.000Z"\n    }\n  ],\n  "next": "string",\n  "total": 0\n}\n```\n\n</details>\n\n---\n\n## Schemas\n\n### `BaseError`\n\n```ts\ntype BaseError = {\n  status: number\n  message: string\n}\n```\n\n### `ServerError`\n\n```ts\ntype ServerError = {\n  status: number\n  message: string\n}\n```\n\n### `ClientError`\n\nDescribes the structure of a client error response, which can be one of several types:\n1. `MessageError`: Contains a \'message\' field for general descriptive errors.\n2. `CodeError`: Contains a \'code\' field for specific, machine-readable error codes.\n3. `StatusedError`: Contains \'error\' and \'status\' f\n\n```ts\ntype ClientError = {\n  message: string\n} | {\n  code: "CAMPAIGN_NOT_FOUND" | "CAMPAIGN_HAS_NO_TARGET" | "CAMPAIGN_HAS_NO_DELIVERY_METHOD" | "CAMPAIGN_HAS_JOB_IN_PROGRESS" | "CAMPAIGN_HAS_UNEXPECTED_STATUS" | "JOB_TOKEN_MISSING" | "TARGET_WITHOUT_FILTERS"\n} | {\n  error: string\n  status: number\n}\n```\n\n### `BaseUUID`\n\n```ts\ntype BaseUUID = string // uuid\n```\n\n### `BaseNanoID`\n\n```ts\ntype BaseNanoID = string\n```\n\n### `BaseTags`\n\n```ts\ntype BaseTags = string[]\n```\n\n### `BaseRelation`\n\n```ts\ntype BaseRelation = {\n  $relation?: Array<{\n    entity_id?: string // uuid\n    _tags?: string[]\n  }>\n}\n```\n\n### `BaseSystemId`\n\n```ts\ntype BaseSystemId = {\n  _id: string // uuid\n}\n```\n\n### `BaseEntityOwner`\n\nThe user / organization owning this entity.\n\nNote: Owner implicitly has access to the entity regardless of ACLs.\n\n\n```ts\ntype BaseEntityOwner = {\n  org_id: string\n  user_id?: string\n}\n```\n\n### `BaseEntityAcl`\n\nAccess control list (ACL) for an entity. Defines sharing access to external orgs or users.\n\n```ts\ntype BaseEntityAcl = {\n  view?: string[]\n  edit?: string[]\n  delete?: string[]\n}\n```\n\n### `BaseSystemFields`\n\n```ts\ntype BaseSystemFields = {\n  _id?: string // uuid\n  _org?: string\n  _owners?: Array<{\n    org_id: string\n    user_id?: string\n  }>\n  _schema?: string\n  _title?: string\n  _tags?: string[]\n  _created_at?: string // date-time\n  _updated_at?: string // date-time\n  _acl?: {\n    view?: string[]\n    edit?: string[]\n    delete?: string[]\n  }\n}\n```\n\n### `BaseSystemFieldsRequired`\n\n```ts\ntype BaseSystemFieldsRequired = object\n```\n\n### `CampaignStatus`\n\n```ts\ntype CampaignStatus = "draft" | "activating" | "active" | "inactive"\n```\n\n### `ExecutionSummaryItem`\n\n```ts\ntype ExecutionSummaryItem = {\n  execution_id?: string\n  execution_status?: string\n}\n```\n\n### `JobStatus`\n\n```ts\ntype JobStatus = {\n  status?: "queued" | "processing" | "finished" | "failed" | "cancelled" | "send_report"\n  execution_summary?: Array<{\n    execution_id?: string\n    execution_status?: string\n  }>\n}\n```\n\n### `Campaign`\n\n```ts\ntype Campaign = {\n  _id?: string // uuid\n  _org?: string\n  _owners?: Array<{\n    org_id: string\n    user_id?: string\n  }>\n  _schema?: string\n  _title?: string\n  _tags?: string[]\n  _created_at?: string // date-time\n  _updated_at?: string // date-time\n  _acl?: {\n    view?: string[]\n    edit?: string[]\n    delete?: string[]\n  }\n  name?: string\n  goal?: string\n  status?: "draft" | "activating" | "active" | "inactive"\n  start_date?: string // date\n  end_date?: string // date\n  flow_id?: string\n  job_id?: string\n  target?: {\n    $relation?: Array<{\n      entity_id?: { ... }\n      _tags?: { ... }\n    }>\n  }\n}\n```\n\n### `Target`\n\n```ts\ntype Target = {\n  _id?: string // uuid\n  _org?: string\n  _owners?: Array<{\n    org_id: string\n    user_id?: string\n  }>\n  _schema?: string\n  _title?: string\n  _tags?: string[]\n  _created_at?: string // date-time\n  _updated_at?: string // date-time\n  _acl?: {\n    view?: string[]\n    edit?: string[]\n    delete?: string[]\n  }\n  name?: string\n  description?: string\n  entity_schema?: string\n  entity_filters?: Record<string, unknown>\n}\n```\n\n### `MatchCampaignParams`\n\n```ts\ntype MatchCampaignParams = {\n  entity_refs: Array<{\n    entity_id: string // uuid\n    entity_schema: string\n  }>\n  campaign_ids: string // uuid[]\n}\n```\n\n### `NextBestAction`\n\nA Next Best Action configured on a campaign\'s Entity-UI channel.\nThis is the canonical NBA contract shared by discovery (this API), authoring, and rendering.\nNBA content is single-language in v1; text fields may contain `{{placeholders}}` resolved at render time.\n\n\n```ts\ntype NextBestAction = {\n  category?: string\n  icon?: {\n    name: string\n    color?: string\n  }\n  title: string\n  body?: string\n  priority?: "low" | "medium" | "high"\n  is_dismissable?: boolean\n  cta: {\n    type: "journey" | "workflow" | "url"\n    target: string\n    label?: string\n    context_params?: Array<{\n      key: { ... }\n      value: { ... }\n    }>\n  }\n}\n```\n\n### `DiscoverCampaignsParams`\n\n```ts\ntype DiscoverCampaignsParams = {\n  entity_id: string // uuid\n  entity_schema: string\n}\n```\n\n### `MatchTargetParams`\n\n```ts\ntype MatchTargetParams = {\n  entity_refs: Array<{\n    entity_id: string // uuid\n    entity_schema: string\n  }>\n  target_ids: string // uuid[]\n}\n```\n\n### `GetTargetQueriesParams`\n\n```ts\ntype GetTargetQueriesParams = {\n  target_ids: string // uuid[]\n}\n```\n\n### `TargetQueryResult`\n\n```ts\ntype TargetQueryResult = {\n  target_id: string // uuid\n  query: string\n  error?: string\n}\n```\n\n### `AutomationStatus`\n\n```ts\ntype AutomationStatus = "pending" | "in_progress" | "success" | "failed" | "cancelled"\n```\n\n### `PortalStatus`\n\n```ts\ntype PortalStatus = "sent" | "seen" | "dismissed" | "clicked"\n```\n\n### `EntityUiStatus`\n\nLifecycle status of a Next Best Action on the Entity-UI channel. Unlike the portal\nchannel there is no `sent` state: an NBA recipient is born at `seen`, the moment the\naction is first rendered to an agent.\n\n\n```ts\ntype EntityUiStatus = "seen" | "dismissed" | "clicked"\n```\n\n### `Resolution`\n\nCross-channel resolution of a campaign for a recipient. Unlike the per-channel `*_status`\nfields (where `dismissed` is channel-local), a resolution suppresses the campaign on EVERY\nchannel \u2014 the 360 Entity-UI card and the portal teaser alike. Server-managed and read-only:\nnever sent by a client. Abs\n\n```ts\ntype Resolution = "accepted"\n```\n\n### `Recipient`\n\n```ts\ntype Recipient = {\n  entity_id?: string // uuid\n  entity_schema?: string\n  title?: string\n  automation_status?: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id?: string\n  portal_status?: "sent" | "seen" | "dismissed" | "clicked"\n  portal_status_updated_at?: string // date-time\n  portal_state?: Record<string, unknown>\n  entity_ui_status?: "seen" | "dismissed" | "clicked"\n  entity_ui_status_updated_at?: string // date-time\n  resolution?: "accepted"\n  updated_at?: string // date-time\n}\n```\n\n### `BaseRecipientPayload`\n\n```ts\ntype BaseRecipientPayload = {\n  entity_id: string // uuid\n  entity_schema: string\n}\n```\n\n### `AutomationRecipientPayload`\n\n```ts\ntype AutomationRecipientPayload = {\n  automation_status: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id: string\n}\n```\n\n### `PortalRecipientPayload`\n\n```ts\ntype PortalRecipientPayload = {\n  portal_status: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n}\n```\n\n### `CreateRecipientPayload`\n\n```ts\ntype CreateRecipientPayload = {\n  entity_id: string // uuid\n  entity_schema: string\n  automation_status: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id: string\n} | {\n  entity_id: string // uuid\n  entity_schema: string\n  portal_status: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n} | {\n  entity_id: string // uuid\n  entity_schema: string\n  automation_status: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id: string\n  portal_status: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n}\n```\n\n### `UpdateRecipientPayload`\n\n```ts\ntype UpdateRecipientPayload = {\n  automation_status?: "pending" | "in_progress" | "success" | "failed" | "cancelled"\n  automation_execution_id?: string\n  portal_status?: "sent" | "seen" | "dismissed" | "clicked"\n  portal_state?: Record<string, unknown>\n}\n```\n\n### `RetriggerAutomationsRequest`\n\n```ts\ntype RetriggerAutomationsRequest = {\n  recipient_ids: string // uuid[]\n}\n```\n\n### `RetriggerAutomationsResult`\n\n```ts\ntype RetriggerAutomationsResult = {\n  recipient_id: string // uuid\n  result: "success" | "failure" | "not_found" | "invalid_status"\n  execution_id?: string\n  error?: string\n}\n```\n\n### `UpdatePortalStatusRequest`\n\n```ts\ntype UpdatePortalStatusRequest = {\n  status: "sent" | "seen" | "dismissed" | "clicked"\n}\n```\n\n### `UpdateEntityUiStatusRequest`\n\n```ts\ntype UpdateEntityUiStatusRequest = {\n  status: "seen" | "dismissed" | "clicked"\n  entity_schema?: string\n}\n```\n\n### `SetupCampaignRequest`\n\nDiscriminated by `type`. Each campaign variant has its own request shape;\nnew variants are added by introducing a new schema and extending the `oneOf` list.\n\n\n```ts\ntype SetupCampaignRequest = {\n  type: "tariff_change"\n  product_recommendation: {\n    name?: string\n    source_product_id?: string // uuid\n    source_price_id?: string // uuid\n    offers?: Array<{\n      target_id?: { ... }\n      items: { ... }\n    }>\n  }\n  campaign: {\n    name: string\n    goal?: string\n    target_ids: string // uuid[]\n  }\n  journey?: {\n    journey_id: string // uuid\n  }\n  channels?: {\n    portal_widget?: {\n      portal_id: { ... }\n      block_id: { ... }\n    }\n    email?: {\n      automation_id?: { ... }\n      template_id?: { ... }\n    }\n  }\n}\n```\n\n### `SetupTariffChangeCampaignRequest`\n\n```ts\ntype SetupTariffChangeCampaignRequest = {\n  type: "tariff_change"\n  product_recommendation: {\n    name?: string\n    source_product_id?: string // uuid\n    source_price_id?: string // uuid\n    offers?: Array<{\n      target_id?: { ... }\n      items: { ... }\n    }>\n  }\n  campaign: {\n    name: string\n    goal?: string\n    target_ids: string // uuid[]\n  }\n  journey?: {\n    journey_id: string // uuid\n  }\n  channels?: {\n    portal_widget?: {\n      portal_id: { ... }\n      block_id: { ... }\n    }\n    email?: {\n      automation_id?: { ... }\n      template_id?: { ... }\n    }\n  }\n}\n```\n\n### `SetupTariffChangeCampaignResponse`\n\n```ts\ntype SetupTariffChangeCampaignResponse = {\n  type: "tariff_change"\n  product_recommendation_id: string // uuid\n  campaign_id: string // uuid\n  journey_id?: string // uuid\n  portal_widget_id?: string // uuid\n}\n```\n';
-
-
-exports.default = targeting_default;