@trillboards/api-client 3.2.5 → 3.2.8

package/dist/generated.d.mts

@@ -309,7 +309,7 @@ type AudienceSegment = {
     /** Stored and echoed but **nothing reads it** — `POST /segments/{id}/match` runs a segment regardless, and the list endpoint does not filter on it. Treat it as a caller-owned label, not a gate. */
     is_active?: boolean;
     /** When `POST /segments/{id}/match` last ran. The update is fire-and-forget after the response is sent, so a failed write leaves this stale or `null` with no error surfaced to the caller. */
-    last_matched_at?: string;
+    last_matched_at?: string | null;
     /** Number of SCREENS returned by the most recent `POST /segments/{id}/match`, capped by that call's `limit` (default 50, max 100) — so it is the size of the last result page, not the segment's reach. `null` until the first match call. */
     last_matched_count?: number;
     /** Trimmed on write, max 100 characters, and unique per partner — a repeat name is rejected `409 duplicate_segment_name` rather than upserting the existing segment. */
@@ -333,6 +333,8 @@ type AudienceSegment = {
 type AudienceSocialAttention = {
     amplification_evidence: string;
     cascade_depth: number;
+    data_projection_version: number;
+    data_projection_xid: string;
     /** All 5 columns NOT NULL except primary_attention_anchor_face_index (only legit NULL: no anchor or solo scene). */
     primary_attention_anchor_face_index?: number | null;
     /** NUMERIC(4,3). */
@@ -1376,7 +1378,7 @@ type EarningsBreakdownResponse = {
     }>;
     /** **Both fields are hardcoded** — `estimated_cents` is always `0` and `confirmation_date` always `null`. Read `EarningsResponse.pending_confirmation_cents` for the real Net-60 pending figure. */
     pending_programmatic?: {
-        confirmation_date?: string;
+        confirmation_date?: string | null;
         estimated_cents?: number;
     };
     /** `start`/`end` echo the request; with neither supplied the window is the last 30 days ending now. The end bound is EXCLUSIVE in the underlying query (`period_date < end`), so passing today's date omits today. */
@@ -2405,23 +2407,23 @@ type PartnerDefaultStream = {
     /** The stream's 24-hex id, minted server-side with `newObjectId()` at create and stored as `default_streams.mongo_default_stream_id`. It is the value every other default-stream route takes as `{streamId}`; the shape is Mongo's but PostgreSQL is the store of record. */
     _id?: string;
     /** Accepted with no required-field check, same as `google_slides_url`. The derived `canva_design_id` is returned alongside it although this schema does not declare it. */
-    canva_url?: string;
+    canva_url?: string | null;
     /** Mapped from `default_streams.created_at`. It is the list endpoint's secondary sort key, so two streams sharing a `playback_order` play oldest-first. */
     createdAt?: string;
     /** Falls back to `name`, then to `Background content`; the upload and image routes use `Uploaded video content` / `Image carousel content` instead. */
     description?: string;
     /** Seconds one pass of this stream occupies. It is computed as `images.length x image_duration` when you send images without it; for every other type it is only ever what you sent — nothing probes a YouTube or uploaded video to fill it in on this path. */
-    duration_seconds?: number;
+    duration_seconds?: number | null;
     /** The URL the player actually loads into the iframe. It defaults to `generic_iframe_url` when you do not send it, so on an iframe stream the two are usually equal. */
-    embed_url?: string;
+    embed_url?: string | null;
     /** The iframe source for the `generic_iframe` type. It also seeds `embed_url` when that is omitted, so sending only this one populates both fields. */
-    generic_iframe_url?: string;
+    generic_iframe_url?: string | null;
     /** Unlike `youtube`/`twitch`/`uploaded`/`images`, the `google_slides` type has NO required-field check — a create naming that type with no URL is accepted, stores null, and the screen then renders an empty frame. */
-    google_slides_url?: string;
+    google_slides_url?: string | null;
     /** Only five keys survive: `auto_advance`, `slide_delay_ms`, `refresh_interval_seconds`, `sandbox_flags`, `allow_flags` — anything else is silently discarded and a non-object is discarded whole. On update it is MERGED over the stored config rather than replacing it, so a key cannot be cleared by omitting it. */
-    iframe_config?: Record<string, unknown>;
+    iframe_config?: Record<string, unknown> | null;
     /** Seconds each image is held before advancing. The multipart image route defaults it to 10 when omitted and uses it to compute `duration_seconds`; the JSON create leaves it unset unless you send it. */
-    image_duration?: number;
+    image_duration?: number | null;
     /** Ordered image URLs, each held for `image_duration` seconds. Required and non-empty when `stream_type` is `images` (400 otherwise), null for every other type; the create accepts a real array, a JSON-encoded array string, or a comma-separated string. */
     images?: Array<string>;
     /** Soft-deactivation flag. The list filters `is_active = true`, so it is always `true` on anything this API returns; the partner DELETE removes the row outright rather than clearing this flag, which is instead used by the screen-wide deactivate paths. */
@@ -2441,13 +2443,13 @@ type PartnerDefaultStream = {
     /** Which renderer the screen uses. When omitted at create it is DERIVED from whichever content field you sent, in this fixed order: `images`, `youtube_url`, `twitch_url`, `google_slides_url`, `canva_url`, `social_wall_url`, `generic_iframe_url`/`embed_url`, `video_url` (`uploaded`), `local_file_path` (`local`) — and the create is rejected 400 if none resolves. Only `youtube`, `uploaded`, `images` and `twitch` are ever content-analyzed; the four embed types deliberately keep `gemini_analyzed_at` NULL. */
     stream_type?: string;
     /** Required when `stream_type` is `twitch` (400 otherwise). The response also carries the undeclared `twitch_embed_url`, `twitch_content_type` and `twitch_id` companions that the PG reshape returns. */
-    twitch_url?: string;
+    twitch_url?: string | null;
     /** Mapped from `default_streams.updated_at`. Playback bookkeeping writes it — marking a stream current, clearing a stale current flag, or stamping `last_played_at` — so it moves without anyone editing the stream content. */
     updatedAt?: string;
     /** Required when `stream_type` is `uploaded`. The `/default-streams/upload` route sets it for you to the stored object URL of the file you posted (`req.file.location`), so you never send it on that path. */
-    video_url?: string;
+    video_url?: string | null;
     /** Required when `stream_type` is `youtube` — the create is rejected 400 (`youtube_url is required for youtube streams`) without it. Null on every other stream type. */
-    youtube_url?: string;
+    youtube_url?: string | null;
 };
 type PartnerDefaultStreamCreate = {
     /** Accepted with no required-field check, same as `google_slides_url` — a `canva` create with this omitted succeeds and renders nothing. */
@@ -2886,7 +2888,7 @@ type PartnerLBarContent = {
 };
 type PartnerLBarDisplayPreferences = {
     /** Which surfaces ads may occupy; `null` by default, in which case it is derived from `display_mode` + `l_bar_ads_enabled`. Setting `lbar` also flips `display_mode` to `l-bar` when the same request does not set it, and narrows the fullscreen surface to `self_promo` only — paid and programmatic demand stops running full screen. */
-    ad_surface_mode?: "fullscreen" | "lbar" | "pip" | "all";
+    ad_surface_mode?: "fullscreen" | "lbar" | "pip" | "all" | null | null;
     /** Default `fullscreen`. Writing it has side effects: `fullscreen` also forces `l_bar_ads_enabled` and `l_bar_content.enabled` to `false`, and `l-bar` forces both to `true` unless the same request sets them explicitly. A change also emits a `refresh` control event so the kiosk reloads and swaps surfaces. */
     display_mode?: "fullscreen" | "l-bar";
     /** Seconds one L-bar ad is held; default 8, accepted range 3-30. It must be strictly LESS than `l_bar_ad_interval`, and the check falls back to the stored interval when this request does not send one. */
@@ -2909,8 +2911,20 @@ type PartnerLBarDisplayPreferences = {
     };
 };
 type PartnerLBarSettings = {
-    /** The resolved renderable ad surfaces. Two caveats: it is present ONLY on the PUT response (the GET does not compute it), and despite the declared `object` type it is an ARRAY — one entry per surface (`fullscreen`, `lbar_slot_1..N`, `pip`) carrying `id`, `surface_type`, `enabled`, `display_area_ratio`, `dimensions` and `allowed_ad_types`. */
-    ad_surfaces?: Record<string, unknown>;
+    /** The resolved renderable ad surfaces, one entry per surface (`fullscreen`, `lbar_slot_1..N`, `pip`). Present ONLY on the PUT response; the GET does not compute it. */
+    ad_surfaces?: Array<{
+        allowed_ad_types?: Array<string>;
+        dimensions?: {
+            height?: number;
+            width?: number;
+        };
+        display_area_ratio?: number;
+        display_mode?: string;
+        enabled?: boolean;
+        id?: string;
+        surface_group?: string;
+        surface_type?: string;
+    }>;
     display_preferences?: PartnerLBarDisplayPreferences;
     l_bar_content?: PartnerLBarContent;
     /** The screen's resolved pacing contract, present only on the PUT response. `policy_version` is `v1` and every interval is in MILLISECONDS (`paid_interval_ms`, `self_promo_interval_ms`, `image_ad_total_ms`, `image_ad_min_ms`); it also carries `max_paid_share` (null unless a loop share cap is enabled), `surface_policy`, `schedule_policy`, `pip_settings` and `lbar_settings`. */
@@ -3845,13 +3859,13 @@ type SensingRouteAction = {
     /** E.164 phone number (channel=whatsapp|sms). */
     recipientE164?: string;
     /** Recipient email (channel=email). */
-    recipientEmail?: string;
+    recipientEmail?: string | null;
     /** Slack channel id (channel=slack). */
-    slackChannelId?: string;
+    slackChannelId?: string | null;
     /** Message template name (managed WhatsApp/SMS). */
     templateName?: string;
     /** Target webhook endpoint id (channel=webhook). */
-    webhookId?: string;
+    webhookId?: string | null;
 };
 /**
  * A threshold condition — the route fires when the sensed field crosses the value.
@@ -4980,7 +4994,8 @@ interface getFleetHourlyOperation {
         timeRange?: "today" | "last_7d" | "last_30d";
     };
     response: {
-        data?: {
+        /** One entry per hour of the day. A partner with no screens gets the empty form `{ hours: [], timeRange }` instead of an array. */
+        data?: Array<Record<string, unknown>> | {
             hours?: Array<Record<string, unknown>>;
             timeRange?: string;
         };
@@ -5068,7 +5083,8 @@ interface getNetworkTrendOperation {
         timeRange?: "today" | "last_7d" | "last_30d";
     };
     response: {
-        data?: {
+        /** One bucket per `interval`. A partner with no screens gets the empty form `{ series: [], interval, timeRange }` instead of an array. */
+        data?: Array<Record<string, unknown>> | {
             interval?: string;
             series?: Array<Record<string, unknown>>;
             timeRange?: string;
@@ -5167,7 +5183,7 @@ interface getSceneIntelligenceOperation {
                 /** True when the scene read completed and `scenes` reflects the fleet. False when it did not run to completion — `scenes` is then empty for want of an answer, not because the fleet is quiet. */
                 measured: boolean;
                 /** Null when `measured` is true. Otherwise names the operational failure. */
-                reason: "timeout" | "error" | "dependency_disabled" | "unknown" | null;
+                reason: "timeout" | "error" | "dependency_disabled" | "unknown" | null | null;
             };
             scenes: Array<Record<string, unknown>>;
         };
@@ -5277,7 +5293,8 @@ interface getLiveAudienceOperation {
             mood?: string | null;
             noise_level?: number | null;
             occupancy?: string | null;
-            purchase_intent?: "NONE" | "BROWSING" | "CONSIDERING" | "COMPARING" | "READY_TO_BUY" | null;
+            /** The speech classifier's reading when the screen reported one (`BROWSING`, `RESEARCHING`, `COMPARING`, `READY_TO_BUY`, `POST_PURCHASE`, `COMPLAINING`, `NONE`), otherwise the segment the purchase-journey stage maps to (`high`, `medium`, `low`), otherwise null. */
+            purchase_intent?: "BROWSING" | "RESEARCHING" | "COMPARING" | "READY_TO_BUY" | "POST_PURCHASE" | "COMPLAINING" | "NONE" | "high" | "medium" | "low" | null | null;
         } | null;
         last_updated?: string | null;
         /** Present when screen is offline */
@@ -9332,7 +9349,7 @@ interface requestStripePayoutOperation {
             currency?: string;
             description?: string;
             destination?: string;
-            /** Estimated arrival (2-3 business days) */
+            /** Estimated arrival date (2-3 business days) */
             estimated_arrival?: string;
             status?: "pending" | "reversed";
             transfer_id?: string;
@@ -9681,6 +9698,7 @@ interface getUsageSummaryOperation {
         avgResponseTime?: number;
         dailyBreakdown?: Array<{
             avg_response_ms?: number;
+            /** The UTC day, sent as the timestamp of its midnight. */
             date?: string;
             total_calls?: number;
             total_errors?: number;
@@ -9717,6 +9735,7 @@ interface getUsageDashboardOperation {
             avg_response_ms?: number;
             daily_breakdown?: Array<{
                 avg_response_ms?: number;
+                /** The UTC day, sent as the timestamp of its midnight. */
                 date?: string;
                 total_calls?: number;
                 total_errors?: number;
@@ -10064,7 +10083,7 @@ interface testWebhookOperation {
     query: Record<string, unknown>;
     response: {
         data?: {
-            error?: string;
+            error?: string | null;
             response_time_ms?: number;
             status?: number;
         };

package/dist/generated.d.ts

@@ -309,7 +309,7 @@ type AudienceSegment = {
     /** Stored and echoed but **nothing reads it** — `POST /segments/{id}/match` runs a segment regardless, and the list endpoint does not filter on it. Treat it as a caller-owned label, not a gate. */
     is_active?: boolean;
     /** When `POST /segments/{id}/match` last ran. The update is fire-and-forget after the response is sent, so a failed write leaves this stale or `null` with no error surfaced to the caller. */
-    last_matched_at?: string;
+    last_matched_at?: string | null;
     /** Number of SCREENS returned by the most recent `POST /segments/{id}/match`, capped by that call's `limit` (default 50, max 100) — so it is the size of the last result page, not the segment's reach. `null` until the first match call. */
     last_matched_count?: number;
     /** Trimmed on write, max 100 characters, and unique per partner — a repeat name is rejected `409 duplicate_segment_name` rather than upserting the existing segment. */
@@ -333,6 +333,8 @@ type AudienceSegment = {
 type AudienceSocialAttention = {
     amplification_evidence: string;
     cascade_depth: number;
+    data_projection_version: number;
+    data_projection_xid: string;
     /** All 5 columns NOT NULL except primary_attention_anchor_face_index (only legit NULL: no anchor or solo scene). */
     primary_attention_anchor_face_index?: number | null;
     /** NUMERIC(4,3). */
@@ -1376,7 +1378,7 @@ type EarningsBreakdownResponse = {
     }>;
     /** **Both fields are hardcoded** — `estimated_cents` is always `0` and `confirmation_date` always `null`. Read `EarningsResponse.pending_confirmation_cents` for the real Net-60 pending figure. */
     pending_programmatic?: {
-        confirmation_date?: string;
+        confirmation_date?: string | null;
         estimated_cents?: number;
     };
     /** `start`/`end` echo the request; with neither supplied the window is the last 30 days ending now. The end bound is EXCLUSIVE in the underlying query (`period_date < end`), so passing today's date omits today. */
@@ -2405,23 +2407,23 @@ type PartnerDefaultStream = {
     /** The stream's 24-hex id, minted server-side with `newObjectId()` at create and stored as `default_streams.mongo_default_stream_id`. It is the value every other default-stream route takes as `{streamId}`; the shape is Mongo's but PostgreSQL is the store of record. */
     _id?: string;
     /** Accepted with no required-field check, same as `google_slides_url`. The derived `canva_design_id` is returned alongside it although this schema does not declare it. */
-    canva_url?: string;
+    canva_url?: string | null;
     /** Mapped from `default_streams.created_at`. It is the list endpoint's secondary sort key, so two streams sharing a `playback_order` play oldest-first. */
     createdAt?: string;
     /** Falls back to `name`, then to `Background content`; the upload and image routes use `Uploaded video content` / `Image carousel content` instead. */
     description?: string;
     /** Seconds one pass of this stream occupies. It is computed as `images.length x image_duration` when you send images without it; for every other type it is only ever what you sent — nothing probes a YouTube or uploaded video to fill it in on this path. */
-    duration_seconds?: number;
+    duration_seconds?: number | null;
     /** The URL the player actually loads into the iframe. It defaults to `generic_iframe_url` when you do not send it, so on an iframe stream the two are usually equal. */
-    embed_url?: string;
+    embed_url?: string | null;
     /** The iframe source for the `generic_iframe` type. It also seeds `embed_url` when that is omitted, so sending only this one populates both fields. */
-    generic_iframe_url?: string;
+    generic_iframe_url?: string | null;
     /** Unlike `youtube`/`twitch`/`uploaded`/`images`, the `google_slides` type has NO required-field check — a create naming that type with no URL is accepted, stores null, and the screen then renders an empty frame. */
-    google_slides_url?: string;
+    google_slides_url?: string | null;
     /** Only five keys survive: `auto_advance`, `slide_delay_ms`, `refresh_interval_seconds`, `sandbox_flags`, `allow_flags` — anything else is silently discarded and a non-object is discarded whole. On update it is MERGED over the stored config rather than replacing it, so a key cannot be cleared by omitting it. */
-    iframe_config?: Record<string, unknown>;
+    iframe_config?: Record<string, unknown> | null;
     /** Seconds each image is held before advancing. The multipart image route defaults it to 10 when omitted and uses it to compute `duration_seconds`; the JSON create leaves it unset unless you send it. */
-    image_duration?: number;
+    image_duration?: number | null;
     /** Ordered image URLs, each held for `image_duration` seconds. Required and non-empty when `stream_type` is `images` (400 otherwise), null for every other type; the create accepts a real array, a JSON-encoded array string, or a comma-separated string. */
     images?: Array<string>;
     /** Soft-deactivation flag. The list filters `is_active = true`, so it is always `true` on anything this API returns; the partner DELETE removes the row outright rather than clearing this flag, which is instead used by the screen-wide deactivate paths. */
@@ -2441,13 +2443,13 @@ type PartnerDefaultStream = {
     /** Which renderer the screen uses. When omitted at create it is DERIVED from whichever content field you sent, in this fixed order: `images`, `youtube_url`, `twitch_url`, `google_slides_url`, `canva_url`, `social_wall_url`, `generic_iframe_url`/`embed_url`, `video_url` (`uploaded`), `local_file_path` (`local`) — and the create is rejected 400 if none resolves. Only `youtube`, `uploaded`, `images` and `twitch` are ever content-analyzed; the four embed types deliberately keep `gemini_analyzed_at` NULL. */
     stream_type?: string;
     /** Required when `stream_type` is `twitch` (400 otherwise). The response also carries the undeclared `twitch_embed_url`, `twitch_content_type` and `twitch_id` companions that the PG reshape returns. */
-    twitch_url?: string;
+    twitch_url?: string | null;
     /** Mapped from `default_streams.updated_at`. Playback bookkeeping writes it — marking a stream current, clearing a stale current flag, or stamping `last_played_at` — so it moves without anyone editing the stream content. */
     updatedAt?: string;
     /** Required when `stream_type` is `uploaded`. The `/default-streams/upload` route sets it for you to the stored object URL of the file you posted (`req.file.location`), so you never send it on that path. */
-    video_url?: string;
+    video_url?: string | null;
     /** Required when `stream_type` is `youtube` — the create is rejected 400 (`youtube_url is required for youtube streams`) without it. Null on every other stream type. */
-    youtube_url?: string;
+    youtube_url?: string | null;
 };
 type PartnerDefaultStreamCreate = {
     /** Accepted with no required-field check, same as `google_slides_url` — a `canva` create with this omitted succeeds and renders nothing. */
@@ -2886,7 +2888,7 @@ type PartnerLBarContent = {
 };
 type PartnerLBarDisplayPreferences = {
     /** Which surfaces ads may occupy; `null` by default, in which case it is derived from `display_mode` + `l_bar_ads_enabled`. Setting `lbar` also flips `display_mode` to `l-bar` when the same request does not set it, and narrows the fullscreen surface to `self_promo` only — paid and programmatic demand stops running full screen. */
-    ad_surface_mode?: "fullscreen" | "lbar" | "pip" | "all";
+    ad_surface_mode?: "fullscreen" | "lbar" | "pip" | "all" | null | null;
     /** Default `fullscreen`. Writing it has side effects: `fullscreen` also forces `l_bar_ads_enabled` and `l_bar_content.enabled` to `false`, and `l-bar` forces both to `true` unless the same request sets them explicitly. A change also emits a `refresh` control event so the kiosk reloads and swaps surfaces. */
     display_mode?: "fullscreen" | "l-bar";
     /** Seconds one L-bar ad is held; default 8, accepted range 3-30. It must be strictly LESS than `l_bar_ad_interval`, and the check falls back to the stored interval when this request does not send one. */
@@ -2909,8 +2911,20 @@ type PartnerLBarDisplayPreferences = {
     };
 };
 type PartnerLBarSettings = {
-    /** The resolved renderable ad surfaces. Two caveats: it is present ONLY on the PUT response (the GET does not compute it), and despite the declared `object` type it is an ARRAY — one entry per surface (`fullscreen`, `lbar_slot_1..N`, `pip`) carrying `id`, `surface_type`, `enabled`, `display_area_ratio`, `dimensions` and `allowed_ad_types`. */
-    ad_surfaces?: Record<string, unknown>;
+    /** The resolved renderable ad surfaces, one entry per surface (`fullscreen`, `lbar_slot_1..N`, `pip`). Present ONLY on the PUT response; the GET does not compute it. */
+    ad_surfaces?: Array<{
+        allowed_ad_types?: Array<string>;
+        dimensions?: {
+            height?: number;
+            width?: number;
+        };
+        display_area_ratio?: number;
+        display_mode?: string;
+        enabled?: boolean;
+        id?: string;
+        surface_group?: string;
+        surface_type?: string;
+    }>;
     display_preferences?: PartnerLBarDisplayPreferences;
     l_bar_content?: PartnerLBarContent;
     /** The screen's resolved pacing contract, present only on the PUT response. `policy_version` is `v1` and every interval is in MILLISECONDS (`paid_interval_ms`, `self_promo_interval_ms`, `image_ad_total_ms`, `image_ad_min_ms`); it also carries `max_paid_share` (null unless a loop share cap is enabled), `surface_policy`, `schedule_policy`, `pip_settings` and `lbar_settings`. */
@@ -3845,13 +3859,13 @@ type SensingRouteAction = {
     /** E.164 phone number (channel=whatsapp|sms). */
     recipientE164?: string;
     /** Recipient email (channel=email). */
-    recipientEmail?: string;
+    recipientEmail?: string | null;
     /** Slack channel id (channel=slack). */
-    slackChannelId?: string;
+    slackChannelId?: string | null;
     /** Message template name (managed WhatsApp/SMS). */
     templateName?: string;
     /** Target webhook endpoint id (channel=webhook). */
-    webhookId?: string;
+    webhookId?: string | null;
 };
 /**
  * A threshold condition — the route fires when the sensed field crosses the value.
@@ -4980,7 +4994,8 @@ interface getFleetHourlyOperation {
         timeRange?: "today" | "last_7d" | "last_30d";
     };
     response: {
-        data?: {
+        /** One entry per hour of the day. A partner with no screens gets the empty form `{ hours: [], timeRange }` instead of an array. */
+        data?: Array<Record<string, unknown>> | {
             hours?: Array<Record<string, unknown>>;
             timeRange?: string;
         };
@@ -5068,7 +5083,8 @@ interface getNetworkTrendOperation {
         timeRange?: "today" | "last_7d" | "last_30d";
     };
     response: {
-        data?: {
+        /** One bucket per `interval`. A partner with no screens gets the empty form `{ series: [], interval, timeRange }` instead of an array. */
+        data?: Array<Record<string, unknown>> | {
             interval?: string;
             series?: Array<Record<string, unknown>>;
             timeRange?: string;
@@ -5167,7 +5183,7 @@ interface getSceneIntelligenceOperation {
                 /** True when the scene read completed and `scenes` reflects the fleet. False when it did not run to completion — `scenes` is then empty for want of an answer, not because the fleet is quiet. */
                 measured: boolean;
                 /** Null when `measured` is true. Otherwise names the operational failure. */
-                reason: "timeout" | "error" | "dependency_disabled" | "unknown" | null;
+                reason: "timeout" | "error" | "dependency_disabled" | "unknown" | null | null;
             };
             scenes: Array<Record<string, unknown>>;
         };
@@ -5277,7 +5293,8 @@ interface getLiveAudienceOperation {
             mood?: string | null;
             noise_level?: number | null;
             occupancy?: string | null;
-            purchase_intent?: "NONE" | "BROWSING" | "CONSIDERING" | "COMPARING" | "READY_TO_BUY" | null;
+            /** The speech classifier's reading when the screen reported one (`BROWSING`, `RESEARCHING`, `COMPARING`, `READY_TO_BUY`, `POST_PURCHASE`, `COMPLAINING`, `NONE`), otherwise the segment the purchase-journey stage maps to (`high`, `medium`, `low`), otherwise null. */
+            purchase_intent?: "BROWSING" | "RESEARCHING" | "COMPARING" | "READY_TO_BUY" | "POST_PURCHASE" | "COMPLAINING" | "NONE" | "high" | "medium" | "low" | null | null;
         } | null;
         last_updated?: string | null;
         /** Present when screen is offline */
@@ -9332,7 +9349,7 @@ interface requestStripePayoutOperation {
             currency?: string;
             description?: string;
             destination?: string;
-            /** Estimated arrival (2-3 business days) */
+            /** Estimated arrival date (2-3 business days) */
             estimated_arrival?: string;
             status?: "pending" | "reversed";
             transfer_id?: string;
@@ -9681,6 +9698,7 @@ interface getUsageSummaryOperation {
         avgResponseTime?: number;
         dailyBreakdown?: Array<{
             avg_response_ms?: number;
+            /** The UTC day, sent as the timestamp of its midnight. */
             date?: string;
             total_calls?: number;
             total_errors?: number;
@@ -9717,6 +9735,7 @@ interface getUsageDashboardOperation {
             avg_response_ms?: number;
             daily_breakdown?: Array<{
                 avg_response_ms?: number;
+                /** The UTC day, sent as the timestamp of its midnight. */
                 date?: string;
                 total_calls?: number;
                 total_errors?: number;
@@ -10064,7 +10083,7 @@ interface testWebhookOperation {
     query: Record<string, unknown>;
     response: {
         data?: {
-            error?: string;
+            error?: string | null;
             response_time_ms?: number;
             status?: number;
         };