@trillboards/api-client 0.2.0 → 0.4.1

package/dist/index.d.mts

@@ -45,6 +45,43 @@ interface ListResponse<T> {
         has_more: boolean;
     };
 }
+type ContentFitMode = 'fit' | 'fill';
+interface ContentFitSettings {
+    /** Direct and programmatic advertisements. */
+    advertisements?: ContentFitMode;
+    /** Default/background streams. */
+    default_streams?: ContentFitMode;
+    /** Self-promotion and QR-code house ads. */
+    self_promo?: ContentFitMode;
+}
+interface PartnerDisplaySettingsInput {
+    content_fit?: ContentFitSettings;
+    [key: string]: unknown;
+}
+interface PartnerDisplaySettingsResponse {
+    object: 'display_settings' | string;
+    screen_id: string;
+    content_fit: Required<ContentFitSettings>;
+    [key: string]: unknown;
+}
+interface PartnerDeviceRegistrationInput {
+    /** Stable partner-owned device identifier. */
+    device_id?: string;
+    /** Legacy SDK alias retained for backwards compatibility. */
+    device_name?: string;
+    device_type?: string;
+    name?: string;
+    display?: Record<string, unknown>;
+    display_settings?: PartnerDisplaySettingsInput;
+    location?: Record<string, unknown>;
+    venue?: Record<string, unknown>;
+    placement?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface PartnerDeviceBatchRegistrationInput {
+    devices: PartnerDeviceRegistrationInput[];
+    defaults?: Omit<PartnerDeviceRegistrationInput, 'device_id' | 'device_name'>;
+}
 interface Screen {
     screen_id: string;
     name: string;
@@ -160,6 +197,128 @@ interface BillingInfo {
     usage_this_month: Record<string, number>;
     stripe_connected: boolean;
 }
+/**
+ * Comparison operators accepted for a Route threshold condition — the same set
+ * the API validates against (services/fein/clipTriggerSchema VALID_OPERATORS).
+ */
+type RouteConditionOp = 'gt' | 'gte' | 'lt' | 'lte' | 'eq' | 'neq';
+/** A threshold condition: fires when `field` crosses `value` via `op`. */
+interface RouteCondition {
+    field: string;
+    op?: RouteConditionOp;
+    value?: number | string | boolean;
+}
+/** Channels a Route action can fire on. */
+type RouteChannel = 'webhook' | 'whatsapp' | 'sms' | 'slack' | 'email' | 'clip';
+/** One channel action fired when a Route matches. */
+interface RouteAction {
+    channel: RouteChannel;
+    webhookId?: string;
+    recipientE164?: string;
+    recipientEmail?: string;
+    slackChannelId?: string;
+    templateName?: string;
+    attachClip?: boolean;
+}
+/** Scheduled-digest config (mode = 'digest'). */
+interface RouteDigest {
+    metric: 'count' | 'avg' | 'max';
+    windowMinutes: number;
+    intervalMinutes: number;
+    nextRunAt?: string;
+}
+/** A Sense Anything Route — a (condition -> channel actions) alert/automation rule. */
+interface SensingRoute {
+    routeId: string;
+    ownerKind: 'earner_user' | 'partner';
+    ownerId: string;
+    partnerId?: string | null;
+    name: string;
+    enabled: boolean;
+    profileName?: string | null;
+    mode: 'threshold' | 'digest';
+    condition: RouteCondition | null;
+    actions: RouteAction[];
+    screenMongoIds: string[];
+    sustainWindowSeconds?: number;
+    sustainMinSamples?: number;
+    debounceSeconds?: number;
+    activeTz?: string | null;
+    activeStartMinute?: number | null;
+    activeEndMinute?: number | null;
+    activeDaysMask?: number;
+    digest: RouteDigest | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Request body to create a Route. */
+interface CreateRouteParams {
+    name: string;
+    screenMongoIds: string[];
+    actions: RouteAction[];
+    mode?: 'threshold' | 'digest';
+    enabled?: boolean;
+    profileName?: string;
+    condition?: RouteCondition;
+    digest?: {
+        metric: 'count' | 'avg' | 'max';
+        field?: string;
+        windowMinutes: number;
+        intervalMinutes: number;
+    };
+    sustainWindowSeconds?: number;
+    sustainMinSamples?: number;
+    debounceSeconds?: number;
+    activeTz?: string;
+    activeStartMinute?: number;
+    activeEndMinute?: number;
+    activeDaysMask?: number;
+}
+/** Request body to update a Route (partial, non-clobbering). */
+type UpdateRouteParams = Partial<CreateRouteParams>;
+/**
+ * The webhook events a Route fire can deliver. The event type is in the
+ * `X-Trillboards-Event` request header: a custom sensed field delivers
+ * `sensing.threshold_crossed`, a known semantic delivers the matching
+ * `audience.*` / `venue.*` event, and a scheduled digest delivers
+ * `venue.traffic_summary`.
+ */
+type RouteWebhookEvent = 'sensing.threshold_crossed' | 'audience.spike' | 'audience.venue_busy' | 'audience.purchase_intent' | 'audience.demographics_update' | 'venue.traffic_summary';
+/**
+ * The aggregate summary delivered as the `observed` value of a digest Route fire
+ * (`venue.traffic_summary`). The digest runner builds it over the Route's window.
+ */
+interface RouteDigestSummary {
+    metric: 'count' | 'avg' | 'max';
+    field: string | null;
+    /** The headline value for `metric`. null for an avg/max window with no samples. */
+    value: number | null;
+    count: number;
+    avg: number | null;
+    max: number | null;
+    window_minutes: number;
+    window_end: string;
+}
+/**
+ * The FLAT webhook request body delivered when a Route fires. Unlike the
+ * device/programmatic events there is NO `{event,timestamp,data}` wrapper — the
+ * event type rides the `X-Trillboards-Event` header. Verify the
+ * `X-Trillboards-Signature` header over the raw body before trusting it.
+ *
+ * `observed` is a scalar for threshold Routes; for a digest Route
+ * (`venue.traffic_summary`) it is a {@link RouteDigestSummary} object.
+ */
+interface SensingThresholdCrossedEvent {
+    route_id: string;
+    route_name: string;
+    owner_kind: 'earner_user' | 'partner';
+    screen_id: string;
+    field: string | null;
+    op: RouteConditionOp | null;
+    threshold: number | string | boolean | null;
+    observed: number | string | boolean | RouteDigestSummary | null;
+    fired_at: string;
+}
 
 /**
  * Internal HTTP client for the Trillboards API.
@@ -173,6 +332,32 @@ interface HttpClientConfig {
     baseUrl: string;
     version?: string;
 }
+interface RetryOptions {
+    /** Maximum number of retry attempts after the initial call. Defaults to 6. */
+    retries?: number;
+    /** Base delay in ms for exponential backoff. Defaults to 1000. */
+    baseMs?: number;
+    /**
+     * Optional callback invoked when an attempt fails with a retryable error.
+     * `attempt` is 1-indexed (1 = first failure). Useful for observability —
+     * the CTV SDK uses this to emit `upload_error` events without coupling
+     * the retry loop to event emission.
+     */
+    onAttemptError?: (attempt: number, error: unknown) => void;
+}
+/**
+ * Wrap an async operation in retry-with-exponential-backoff.
+ *
+ * - Retries up to `retries` times on retryable errors (429, 5xx, TypeError network).
+ * - Honors `Retry-After` header on 429 responses (parsed into TrillboardsError.retryAfter).
+ * - Throws the last error after the budget is exhausted.
+ * - Permanent 4xx (auth, validation, not-found) throw immediately on first attempt.
+ *
+ * This is the SINGLE retry primitive in the SDK — every POST/PUT/DELETE is
+ * wrapped automatically by HttpClient. GET is left to the caller because
+ * idempotency assumptions vary by route.
+ */
+declare function retryWithBackoff<T>(operation: () => Promise<T>, opts?: RetryOptions): Promise<T>;
 declare class HttpClient {
     private readonly config;
     constructor(config: HttpClientConfig);
@@ -180,10 +365,33 @@ declare class HttpClient {
     get<T>(path: string, opts?: {
         params?: Record<string, unknown>;
     }): Promise<T>;
-    post<T>(path: string, body?: unknown): Promise<T>;
-    put<T>(path: string, body?: unknown): Promise<T>;
-    patch<T>(path: string, body?: unknown): Promise<T>;
-    delete<T>(path: string): Promise<T>;
+    /**
+     * POST / PUT / PATCH / DELETE auto-retry on 429 + 5xx + network TypeError
+     * via `retryWithBackoff()`. Callers can opt into observability by passing
+     * `retry.onAttemptError` to receive a callback per transient failure.
+     *
+     * The retry behavior is identical across all four methods because all of
+     * them are state-changing operations subject to the same transient-failure
+     * classes (rate limit, upstream-down, network-flap). The wire idempotency
+     * of POST vs DELETE is enforced server-side via Idempotency-Key headers,
+     * which the caller can attach via `opts.headers`.
+     */
+    post<T>(path: string, body?: unknown, opts?: {
+        retry?: RetryOptions;
+        headers?: Record<string, string>;
+    }): Promise<T>;
+    put<T>(path: string, body?: unknown, opts?: {
+        retry?: RetryOptions;
+        headers?: Record<string, string>;
+    }): Promise<T>;
+    patch<T>(path: string, body?: unknown, opts?: {
+        retry?: RetryOptions;
+        headers?: Record<string, string>;
+    }): Promise<T>;
+    delete<T>(path: string, opts?: {
+        retry?: RetryOptions;
+        headers?: Record<string, string>;
+    }): Promise<T>;
     private buildUrl;
 }
 
@@ -207,18 +415,18 @@ declare class ScreensClient {
         data: Screen;
     }>;
     /** Register a new device/screen. */
-    create(body: {
-        device_name: string;
-        device_type?: string;
-        venue_type?: string;
-        country?: string;
-        city?: string;
-        timezone?: string;
-        resolution?: string;
-    }): Promise<{
+    create(body: PartnerDeviceRegistrationInput): Promise<{
         success: boolean;
         data: Screen;
     }>;
+    /** Get the resolved display settings for one screen. */
+    getDisplaySettings(screenId: string): Promise<PartnerDisplaySettingsResponse>;
+    /** Partially update display settings; omitted content-fit keys are preserved. */
+    patchDisplaySettings(screenId: string, settings: PartnerDisplaySettingsInput): Promise<PartnerDisplaySettingsResponse>;
+    /** Update display settings through the PUT endpoint. */
+    updateDisplaySettings(screenId: string, settings: PartnerDisplaySettingsInput): Promise<PartnerDisplaySettingsResponse>;
+    /** Apply a partial display-settings update to up to 100 screens. */
+    batchUpdateDisplaySettings(screenIds: string[], settings: PartnerDisplaySettingsInput): Promise<Record<string, unknown>>;
     /** Delete a screen/device. */
     delete(screenId: string): Promise<{
         success: boolean;
@@ -245,20 +453,32 @@ declare class DevicesClient {
         data: Device;
     }>;
     /** Register a new device. */
-    create(body: {
-        device_name: string;
-        device_type?: string;
-        platform?: string;
-    }): Promise<{
+    create(body: PartnerDeviceRegistrationInput): Promise<{
         success: boolean;
         data: Device;
     }>;
+    /** Register or re-register up to 100 devices with optional fleet defaults. */
+    createBatch(body: PartnerDeviceBatchRegistrationInput): Promise<{
+        success: boolean;
+        summary: Record<string, number>;
+        devices: Array<Record<string, unknown>>;
+        errors: Array<Record<string, unknown>>;
+    }>;
     /** Delete a device. */
     delete(deviceId: string): Promise<{
         success: boolean;
     }>;
-    /** Send heartbeat for a device. */
-    heartbeat(deviceId: string, body?: Record<string, unknown>): Promise<{
+    /**
+     * Send heartbeat for a device.
+     *
+     * Auto-retries on 429 + 5xx + network TypeError via the shared
+     * retryWithBackoff() helper (see http.ts). Pass `opts.retry.onAttemptError`
+     * to observe transient failures (e.g. emit an `upload_error` event from
+     * the CTV SDK without coupling the retry loop to its event emitter).
+     */
+    heartbeat(deviceId: string, body?: Record<string, unknown>, opts?: {
+        retry?: RetryOptions;
+    }): Promise<{
         success: boolean;
     }>;
 }
@@ -515,6 +735,57 @@ declare class BillingClient {
     }>;
 }
 
+/**
+ * RoutesClient — Sense Anything "Routes": alerting + automation on the sensing
+ * stream. A Route fires channel actions (webhook / managed WhatsApp / SMS /
+ * Slack / email) when a sensed field crosses a threshold on a set of your
+ * screens, or on a scheduled digest.
+ *
+ * Base path: /v1/partner/sensing/routes
+ */
+
+declare class RoutesClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Create a Route. Every screen in `screenMongoIds` must be one you own. */
+    create(body: CreateRouteParams): Promise<{
+        success: boolean;
+        data: {
+            route: SensingRoute;
+        };
+    }>;
+    /** List your Routes. Pass `includeDisabled: false` to return only enabled Routes. */
+    list(params?: {
+        includeDisabled?: boolean;
+    }): Promise<{
+        success: boolean;
+        data: {
+            routes: SensingRoute[];
+        };
+    }>;
+    /** Get one Route by id. */
+    get(routeId: string): Promise<{
+        success: boolean;
+        data: {
+            route: SensingRoute;
+        };
+    }>;
+    /** Update a Route (partial, non-clobbering — only the fields you send change). */
+    update(routeId: string, body: UpdateRouteParams): Promise<{
+        success: boolean;
+        data: {
+            route: SensingRoute;
+        };
+    }>;
+    /** Soft-delete a Route. */
+    delete(routeId: string): Promise<{
+        success: boolean;
+        data: {
+            routeId: string;
+        };
+    }>;
+}
+
 /**
  * TrillboardsClient — main entry point for the Trillboards Partner API SDK.
  *
@@ -537,6 +808,7 @@ declare class TrillboardsClient {
     readonly data: DataClient;
     readonly errors: ErrorsClient;
     readonly billing: BillingClient;
+    readonly routes: RoutesClient;
     /** The underlying HTTP client (exposed for advanced use cases). */
     readonly _http: HttpClient;
     constructor(options: ClientOptions);
@@ -600,46 +872,133 @@ declare class TrillboardsError extends Error {
 }
 
 /**
- * Webhook signature verification for Trillboards Partner API webhooks.
+ * Webhook signature verification for Trillboards webhooks.
+ *
+ * Header format produced by the server (matches Stripe-style compound shape):
+ *
+ *   X-Trillboards-Signature: t=<unix_seconds>,v0=<hex>,v1=<hex>
+ *   X-Trillboards-Timestamp: <unix_seconds>     // redundant; same value as t=
+ *   X-Trillboards-Event:     <event_name>
+ *   X-Trillboards-Webhook-Id: <subscription_id>
+ *
+ * Where v1 = HMAC-SHA256(secret, `${timestamp}.${payload}`)
+ *       v0 = HMAC-SHA256(secret, payload)   ← legacy body-only, emitted for back-compat
  *
- * Uses HMAC-SHA256 with timing-safe comparison to prevent signature
- * forgery and timing attacks.
+ * `constructEvent` prefers v1 (replay-protected); falls back to v0 when v1 is
+ * absent (server in pre-migration state) or when only the legacy
+ * `sha256=<hex>` form is present.
+ *
+ * Replay protection: a configurable tolerance window (default 300s, Stripe-
+ * aligned) rejects payloads whose timestamp is too far from the verifier's
+ * clock. Adjust via the `tolerance` option.
+ *
+ * Migration note (since 0.3.0):
+ *   The 0.2.0-shape `constructEvent(payload, signatureString, secret)` is kept
+ *   as `constructEventLegacy` for one minor version. It does NOT verify the
+ *   timestamp (the 0.2.0 verifier had no access to one). Migrate to the new
+ *   call shape `constructEvent(payload, req.headers, secret)` to gain replay
+ *   protection and compound-header support.
  */
 
+interface ConstructEventOptions {
+    /** Maximum allowed age (seconds) of a signed payload. Default 300 (Stripe-aligned). */
+    tolerance?: number;
+    /** Override the verifier's current time (seconds). Tests only. */
+    nowSec?: number;
+}
+/**
+ * Headers carried by a Trillboards webhook delivery. Accepts either the
+ * canonical Node `IncomingHttpHeaders` shape (lowercase keys) or any
+ * Record<string, string|string[]> with case-insensitive lookup.
+ */
+type WebhookHeaders = Record<string, string | string[] | undefined> | {
+    [key: string]: string | string[] | undefined;
+};
+/**
+ * Parsed signature-header components.
+ */
+interface ParsedSignatureHeader {
+    /** Unix seconds from `t=` if present. */
+    timestamp?: number;
+    /** Algorithm → hex-digest map. Standard keys: `v0`, `v1`. */
+    versions: Map<string, string>;
+    /** Set when the raw input matched the legacy `sha256=<hex>` shape. */
+    legacy?: string;
+}
+/**
+ * Parse a Trillboards `X-Trillboards-Signature` header into its component
+ * algorithm-keyed digests.
+ *
+ * Accepts:
+ *   "t=<ts>,v1=<hex>"                       → canonical
+ *   "t=<ts>,v0=<hex>,v1=<hex>"              → canonical with legacy companion
+ *   "sha256=<hex>"                          → pre-migration emitter (single value)
+ *
+ * @public
+ */
+declare function parseSignatureHeader(rawSig: string): ParsedSignatureHeader;
 /**
  * Verify a webhook payload signature and parse the event.
  *
- * @param payload  - Raw request body as string or Buffer.
- * @param signature - The signature from the `X-Trillboards-Signature` header.
- * @param secret   - The webhook secret from your webhook subscription.
- * @returns The parsed WebhookEvent if signature is valid.
- * @throws TrillboardsError if the signature does not match.
+ * @param payload — raw request body (string or Buffer). Must be EXACTLY the
+ *                  bytes the server signed — do NOT re-stringify after JSON.parse.
+ * @param headers — IncomingHttpHeaders or any Record<string, string|string[]>
+ *                  produced by your HTTP framework. Case-insensitive lookup.
+ *                  For Express, pass `req.headers`. For Next.js, `req.headers`.
+ *                  Backwards-compat: a raw signature string (the 0.2.0 shape)
+ *                  is also accepted and parsed as if it were the value of
+ *                  `X-Trillboards-Signature`; in that case the verifier looks
+ *                  for the timestamp in the compound header itself, OR throws.
+ * @param secret  — webhook subscription secret (whsec_...).
+ * @param opts.tolerance — replay-window in seconds. Default 300.
+ * @returns parsed WebhookEvent if signature valid AND timestamp within tolerance.
+ * @throws TrillboardsError(authentication_error / webhook_signature_invalid)
  *
  * @example
- * ```typescript
  * import { Webhooks } from '@trillboards/api-client';
  *
- * app.post('/webhooks', (req, res) => {
- *   const event = Webhooks.constructEvent(
- *     req.body,
- *     req.headers['x-trillboards-signature'],
- *     process.env.WEBHOOK_SECRET
- *   );
- *   console.log('Received event:', event.type);
- *   res.sendStatus(200);
+ * app.post('/webhooks', express.raw({ type: 'application/json' }), (req, res) => {
+ *   try {
+ *     const event = Webhooks.constructEvent(
+ *       req.body,                              // raw Buffer or string
+ *       req.headers,                           // IncomingHttpHeaders
+ *       process.env.WEBHOOK_SECRET!,           // your subscription secret
+ *     );
+ *     console.log('Received', event.type);
+ *     res.sendStatus(200);
+ *   } catch (err) {
+ *     // TrillboardsError with code "webhook_signature_invalid"
+ *     res.sendStatus(401);
+ *   }
  * });
- * ```
  */
-declare function constructEvent(payload: string | Buffer, signature: string, secret: string): WebhookEvent;
+declare function constructEvent(payload: string | Buffer, headers: WebhookHeaders | string, secret: string, opts?: ConstructEventOptions): WebhookEvent;
+/**
+ * @deprecated since 0.3.0 — kept for one minor version for partners stuck on
+ *   the 0.2.0 call shape. Use `constructEvent(payload, req.headers, secret)`
+ *   instead — it gains replay protection and compound-header support.
+ *
+ * Reproduces the 0.2.0 verifier exactly:
+ *   HMAC-SHA256(secret, payload) compared (constant-time) against the
+ *   supplied raw-hex signature string.
+ *
+ * Does NOT verify any timestamp. The 0.2.0 SDK never had access to one and
+ * silently accepted any age of payload — that is a vulnerability this
+ * legacy shim preserves only for migration compatibility.
+ */
+declare function constructEventLegacy(payload: string | Buffer, signature: string, secret: string): WebhookEvent;
+/** Namespaced export — matches the Stripe-style API. */
 declare const Webhooks: {
     constructEvent: typeof constructEvent;
+    constructEventLegacy: typeof constructEventLegacy;
+    parseSignatureHeader: typeof parseSignatureHeader;
 };
 
 /**
  * SDK version constant. Sent in User-Agent and X-Trillboards-Client headers.
  * Keep in sync with package.json version.
  */
-declare const VERSION = "0.1.3";
+declare const VERSION = "0.4.1";
 
 type BleScanResultData = {
     appleContinuitySubtype?: number | null;
@@ -861,6 +1220,32 @@ type PartnerHeartbeatRequest = {
     last_vast_error_code?: number;
     last_vast_request_at?: string;
     last_vast_response_at?: string;
+    /** Current GPS fix for a moving screen. Processed only for screens whose `mobility_type` is `mobile` or `semi_mobile` (declare it at registration or via PATCH /device/{deviceId}), OR for any screen still missing coordinates (a one-time self-heal that also kicks off venue classification). Static screens with valid coordinates ignore it. Updates live geo-targeting, geofencing and analytics. Fully optional — omit it on stationary screens. */
+    location?: {
+        /** Horizontal accuracy radius in meters. Fixes above ~500m are clamped. */
+        accuracy_m?: number;
+        /** Up to 200 fixes recorded while the device was offline, replayed as a historical track. Timestamps MUST be in ascending order — a non-chronological batch is rejected with HTTP 400. Only the top-level `location` updates the live serving position. */
+        buffered_locations?: Array<{
+            accuracy_m?: number;
+            heading?: number;
+            lat: number;
+            lng: number;
+            speed_mps?: number;
+            timestamp?: number;
+        }>;
+        /** Bearing in degrees (0–360, 0 = true north). Omit if unavailable. */
+        heading?: number;
+        /** Latitude in decimal degrees (WGS 84). */
+        lat?: number;
+        /** Longitude in decimal degrees (WGS 84). */
+        lng?: number;
+        /** `gps` — a live on-device fix. `gps_buffered` — a fix recorded while offline and replayed on reconnect. */
+        source?: "gps" | "gps_buffered";
+        /** Ground speed in meters per second. Omit if unavailable. */
+        speed_mps?: number;
+        /** Unix epoch milliseconds of the on-device fix. Send the device clock value; the server tolerates up to 10 minutes of skew. A position jump implying > 320 km/h between consecutive fixes is rejected. */
+        timestamp?: number;
+    };
     /** Alternate namespace for telemetry keys (legacy support). */
     metadata?: Record<string, unknown>;
     muted?: boolean;
@@ -1018,12 +1403,12 @@ interface heartbeatOperation {
     response: PartnerHeartbeatResponse;
 }
 declare const generatedTypes: {
-    readonly schemaCount: 67;
-    readonly operationCount: 132;
-    readonly schemas: readonly ["Ad", "AdSettings", "AudienceAnalyticsResponse", "AudienceExportResponse", "AudienceMetricsResponse", "AudienceSegment", "BatchResult", "BleScanResultData", "ChangelogEntry", "ChangelogResponse", "ContentPreferencesInput", "ContentPreferencesResponse", "ContentPreset", "DashboardResponse", "DemographicsResponse", "Device", "DeviceCapabilityPayload", "DeviceSummary", "DisplaySettingsInput", "DisplaySettingsResponse", "EarningsBreakdownResponse", "EarningsResponse", "Error", "HeaderBiddingSettings", "HttpProbeResult", "MdnsNetworkDevice", "Pagination", "Partner", "PartnerAdDeliveryProfile", "PartnerDefaultStream", "PartnerDefaultStreamCreate", "PartnerDefaultStreamUpdate", "PartnerDeviceHeartbeatBody", "PartnerHeartbeatCommand", "PartnerHeartbeatData", "PartnerHeartbeatMeasurementMetadata", "PartnerHeartbeatQueryData", "PartnerHeartbeatQueryResponse", "PartnerHeartbeatRequest", "PartnerHeartbeatResponse", "PartnerHeartbeatTelemetry", "PartnerLBarContent", "PartnerLBarDisplayPreferences", "PartnerLBarSettings", "PartnerSafeHeartbeatTelemetry", "PartnerSelfPromoAd", "PartnerSelfPromoCreate", "PartnerSelfPromoPlacement", "PartnerStats", "PayoutResponse", "PlaygroundResult", "PlaygroundValidationError", "ProgrammaticSettingsInput", "ProgrammaticSettingsResponse", "RequestMetadataResponse", "RolePermissions", "SDKConfig", "ScreenAnalyticsResponse", "SsdpDeviceInfo", "TeamInviteResponse", "TeamMember", "Transaction", "Webhook", "WebhookDelivery", "WebhookEvent", "WifiEnvironmentSnapshot", "WifiScanResult"];
-    readonly operations: readonly ["listPartnerSelfPromoAds", "createPartnerSelfPromoAd", "listPartnerSelfPromoPlacements", "schedulePartnerSelfPromo", "createPartnerSelfPromoUpload", "disablePartnerSelfPromo", "registerAgent", "getAnalytics", "rotateApiKey", "getAudienceAnalytics", "exportAudienceData", "getAudienceHeatmap", "getLiveAudience", "getLookalikeScreens", "predictScreenAudience", "listAudienceSegments", "createAudienceSegment", "deleteAudienceSegment", "getAudienceSegment", "updateAudienceSegment", "matchAudienceSegment", "estimateSegmentReach", "generateSegmentVastTag", "getAudienceStats", "purchaseCredits", "createCreditCheckout", "setupBilling", "getUsageSummary", "getConnectDashboard", "getConnectEarningsChart", "getConnectScreenHealth", "listContentPresets", "getContentPreset", "getDashboard", "registerDevice", "deleteDevice", "getDevice", "updateDevice", "getAdsForDevice", "ackDeviceCommand", "getDeviceHeartbeat", "heartbeat", "recordProgrammaticEvent", "listDevices", "registerDevicesBatch", "batchUpdateDeviceOrientation", "getEarnings", "getEarningsBreakdown", "requestPayout", "getTransactions", "getActiveSSEConnections", "subscribeToEvents", "getFleetAnalytics", "pushFleetCommand", "getFleetOverview", "updateFleetSettings", "recordImpressionGet", "recordImpressionPost", "recordImpressionsBatch", "getPartnerInfo", "listIntentCategories", "getIntentCategory", "getIntentPricing", "getNetworkConfig", "patchNetworkConfig", "updateNetworkConfig", "recordAdComplete", "getPricing", "quickStart", "registerPartner", "generateSandboxEvent", "resetSandbox", "createSandboxScreen", "getSandboxStatus", "batchUpdateContentPreferences", "batchUpdateDisplaySettings", "batchUpdateProgrammaticSettings", "resolvePartnerScreen", "getScreenAnalytics", "applyContentPreset", "getAudienceMetrics", "getContentPreferences", "patchContentPreferences", "updateContentPreferences", "listPartnerDefaultStreams", "createPartnerDefaultStream", "createPartnerDefaultStreamImages", "reorderPartnerDefaultStreams", "createPartnerDefaultStreamUpload", "deletePartnerDefaultStream", "updatePartnerDefaultStream", "getScreenDemographics", "getDisplaySettings", "patchDisplaySettings", "updateDisplaySettings", "getPartnerLBarSettings", "updatePartnerLBarSettings", "updatePartnerLBarLiveUpdates", "getProgrammaticSettings", "patchProgrammaticSettings", "updateProgrammaticSettings", "createStripeConnectAccount", "getStripeLoginLink", "getStripeOnboardingLink", "requestStripePayout", "getStripePayoutHistory", "getStripeAccountStatus", "handleStripeWebhook", "listTeamMembers", "acceptInvitation", "inviteTeamMember", "getInvitationByToken", "resendInvitation", "removeTeamMember", "changeTeamMemberRole", "getTrackingPublicKey", "recordTrackingBatch", "upgradeToPartner", "getUsageSummary__get__usage", "getUsageDashboard", "getRateLimitStatus", "queryChangelog", "playgroundDryRun", "getRequestMetadata", "getVastConfig", "getVenueIntelligence", "listWebhooks", "createWebhook", "deleteWebhook", "updateWebhook", "getWebhookDeliveries", "testWebhook"];
+    readonly schemaCount: 99;
+    readonly operationCount: 210;
+    readonly schemas: readonly ["Ad", "AdSettings", "AudienceAnalyticsResponse", "AudienceAttentionPrediction", "AudienceExportResponse", "AudienceLoyaltyFeaturesRow", "AudienceMetricsResponse", "AudienceSegment", "AudienceSocialAttention", "BatchResult", "BleScanResultData", "ChangelogEntry", "ChangelogResponse", "ContentFitSettings", "ContentPreferencesInput", "ContentPreferencesResponse", "ContentPreset", "CreatePartnerSensingRouteRequest", "CreativeClassification", "DashboardResponse", "DataExportSummaryResponse", "DemographicsResponse", "Device", "DeviceCapabilityPayload", "DeviceSummary", "DisplaySettingsInput", "DisplaySettingsResponse", "EarningsBreakdownResponse", "EarningsResponse", "Error", "FleetCommand", "FleetCommandEvent", "HeaderBiddingSettings", "HttpProbeResult", "MdnsNetworkDevice", "Pagination", "Partner", "PartnerAdDeliveryProfile", "PartnerDefaultStream", "PartnerDefaultStreamCreate", "PartnerDefaultStreamUpdate", "PartnerDeviceHeartbeatBody", "PartnerHeartbeatCommand", "PartnerHeartbeatData", "PartnerHeartbeatMeasurementMetadata", "PartnerHeartbeatQueryData", "PartnerHeartbeatQueryResponse", "PartnerHeartbeatRequest", "PartnerHeartbeatResponse", "PartnerHeartbeatTelemetry", "PartnerLBarContent", "PartnerLBarDisplayPreferences", "PartnerLBarSettings", "PartnerMonetizationRequirements", "PartnerNetworkConfig", "PartnerNetworkConfigUpdate", "PartnerPlay", "PartnerRegistrationDisplaySettings", "PartnerRequirement", "PartnerSafeHeartbeatTelemetry", "PartnerSelfPromoAd", "PartnerSelfPromoCreate", "PartnerSelfPromoPlacement", "PartnerStats", "PayoutResponse", "PlaygroundResult", "PlaygroundValidationError", "ProgrammaticSettingsInput", "ProgrammaticSettingsResponse", "RequestMetadataResponse", "ResolvedContentPolicy", "ResolvedSensingConfig", "RolePermissions", "SDKConfig", "ScreenAnalyticsResponse", "ScreenGroup", "ScreenGroupContentPolicy", "ScreenGroupContentPolicyInput", "ScreenGroupEvent", "ScreenGroupSensingConfig", "ScreenGroupSensingConfigInput", "SensingPerformanceMode", "SensingRoute", "SensingRouteAction", "SensingRouteCondition", "SensingSettingsResponse", "SensingThresholdCrossedEvent", "SsdpDeviceInfo", "TeamInviteResponse", "TeamMember", "Transaction", "UpdatePartnerSensingRouteRequest", "VastWaterfall", "VastWaterfallSource", "Webhook", "WebhookDelivery", "WebhookEvent", "WifiEnvironmentSnapshot", "WifiScanResult"];
+    readonly operations: readonly ["listPartnerSelfPromoAds", "createPartnerSelfPromoAd", "listPartnerSelfPromoPlacements", "schedulePartnerSelfPromo", "createPartnerSelfPromoUpload", "disableSelfPromoAd", "registerAgent", "getAnalytics", "getAudienceContinuity", "getAudienceProfile", "getBleSummary", "getContentPerformance", "searchCreativeCatalog", "getCreativeScenes", "getCrossScreenFlow", "getPartnerAnalyticsDashboard", "getDeviceSuiteSignature", "exportPartnerAnalytics", "exportPartnerAdsByDay", "getFleetHourly", "getHaloFunnel", "getLoyaltyClock", "getNetworkSummary", "getNetworkTrend", "getProximitySummary", "getRevenueAttentionCorrelation", "getSceneFeed", "getSceneIntelligence", "rotateApiKey", "getAudienceAnalytics", "exportAudienceData", "getAudienceHeatmap", "getLiveAudience", "getLookalikeScreens", "predictScreenAudience", "getResolvedHouseholdReach", "listAudienceSegments", "createAudienceSegment", "deleteAudienceSegment", "getAudienceSegment", "updateAudienceSegment", "matchAudienceSegment", "estimateSegmentReach", "generateSegmentVastTag", "getAudienceStats", "cancelBillingSubscription", "purchaseCredits", "createCreditCheckout", "listBillingPlans", "setupBilling", "createBillingSubscription", "getBillingSubscription", "getBillingUsage", "getUsageSummary", "stripeWebhookCallback", "getConnectDashboard", "getConnectEarningsChart", "getConnectScreenHealth", "listContentPresets", "getContentPreset", "submitPartnerCreative", "getPartnerCreative", "getDashboard", "exportProximityGraphEdges", "getDataExportSummary", "exportDataset", "getGeohashAudiencePanel", "getOutcomeAttribution", "registerDevice", "deleteDevice", "getDevice", "updateDevice", "getAdsForDevice", "ackDeviceCommand", "getDeviceHeartbeat", "heartbeat", "recordProgrammaticEvent", "listDevices", "registerDeviceV2", "registerDevicesBatch", "batchUpdateDeviceOrientation", "reconcileDevices", "partnerDocsBrowser", "getEarnings", "getEarningsBreakdown", "requestPayout", "getTransactions", "getActiveSSEConnections", "subscribeToEvents", "getFleetCommand", "getFleetAnalytics", "pushFleetCommand", "getFleetOverview", "updateFleetSettings", "recordImpressionGet", "recordImpressionPost", "recordImpressionsBatch", "getPartnerInfo", "listIntentCategories", "getIntentCategory", "getIntentPricing", "getMeasurementMethodology", "getNetworkConfig", "patchNetworkConfig", "updateNetworkConfig", "getNetworkTrends", "partnerPing", "partnerPingAuth", "recordPartnerPlay", "recordPartnerPlaysBatch", "getPricing", "recordProgrammaticEventLegacyAlias", "quickStart", "registerPartner", "generateSandboxEvent", "resetSandbox", "createSandboxScreen", "getSandboxStatus", "listScreenGroups", "createScreenGroup", "deleteScreenGroup", "getScreenGroup", "updateScreenGroup", "getScreenGroupAnalytics", "createScreenGroupCommand", "getScreenGroupContentPolicy", "updateScreenGroupContentPolicy", "removeScreenGroupMembers", "listScreenGroupMembers", "addScreenGroupMembers", "getScreenGroupSensingConfig", "updateScreenGroupSensingConfig", "getScreenAudienceSegments", "batchUpdateContentPreferences", "batchUpdateDisplaySettings", "batchUpdateProgrammaticSettings", "resolvePartnerScreen", "getScreenAnalytics", "getPartnerScreenAtmosphere", "getPartnerScreenIntelligence", "getPartnerScreenTasteProfile", "getPartnerScreenTraffic", "getPartnerScreenVAS", "applyContentPreset", "getAudienceMetrics", "getContentPreferences", "patchContentPreferences", "updateContentPreferences", "listPartnerDefaultStreams", "createPartnerDefaultStream", "createPartnerDefaultStreamImages", "reorderPartnerDefaultStreams", "createPartnerDefaultStreamUpload", "deletePartnerDefaultStream", "updatePartnerDefaultStream", "getScreenDemographics", "getDisplaySettings", "patchDisplaySettings", "updateDisplaySettings", "getPartnerLBarSettings", "updatePartnerLBarSettings", "updatePartnerLBarLiveUpdates", "getProgrammaticSettings", "patchProgrammaticSettings", "updateProgrammaticSettings", "getResolvedContentPolicy", "getResolvedSensingConfig", "getScreenSensingChips", "interpretScreenSensingIntent", "deployScreenSensingProfile", "getScreenSensingSettings", "updateScreenSensingSettings", "listPartnerSensingRoutes", "createPartnerSensingRoute", "deletePartnerSensingRoute", "getPartnerSensingRoute", "updatePartnerSensingRoute", "createStripeConnectAccount", "getStripeLoginLink", "getStripeOnboardingLink", "requestStripePayout", "getStripePayoutHistory", "getStripeAccountStatus", "handleStripeWebhook", "listTeamMembers", "acceptInvitation", "inviteTeamMember", "getInvitationByToken", "resendInvitation", "removeTeamMember", "changeTeamMemberRole", "getTrackingPublicKey", "recordTrackingBatch", "getUsageSummary__get__usage", "getUsageDashboard", "getRateLimitStatus", "queryChangelog", "playgroundDryRun", "getRequestMetadata", "getVastConfig", "getVenuesNearby", "getVenueAtmosphere", "getVenueTraffic", "getVenueIntelligence", "listWebhooks", "createWebhook", "deleteWebhook", "updateWebhook", "getWebhookDeliveries", "testWebhook"];
 };
 type GeneratedSchemaName = (typeof generatedTypes.schemas)[number];
 type GeneratedOperationName = (typeof generatedTypes.operations)[number];
 
-export { AnalyticsClient, type AnalyticsData, type ApiErrorType, AudienceClient, type AudienceData, BillingClient, type BillingInfo, type BleScanResultData, type ClientOptions, DataClient, type Device, type DeviceCapabilityPayload, DevicesClient, EarningsClient, type EarningsData, type ErrorDetail, type ErrorEntry, type ErrorResponseBody, ErrorsClient, FleetClient, type FleetCommand, type GeneratedOperationName, type GeneratedSchemaName, type HttpProbeResult, type Impression, ImpressionsClient, type ListResponse, type MdnsNetworkDevice, type PartnerAdDeliveryProfile, type PartnerDeviceHeartbeatBody, type PartnerHeartbeatMeasurementMetadata, type PartnerHeartbeatQueryData, type PartnerHeartbeatQueryResponse, type PartnerHeartbeatRequest, type PartnerHeartbeatResponse, type PartnerSafeHeartbeatTelemetry, type RequestOptions, type Screen, ScreensClient, type SsdpDeviceInfo, TrillboardsClient, TrillboardsError, type TrillboardsErrorOptions, VERSION, type Webhook, type WebhookEvent, Webhooks, WebhooksClient, type WifiEnvironmentSnapshot, type WifiScanResult, constructEvent, generatedTypes, type getDeviceHeartbeatOperation, type heartbeatOperation };
+export { AnalyticsClient, type AnalyticsData, type ApiErrorType, AudienceClient, type AudienceData, BillingClient, type BillingInfo, type BleScanResultData, type ClientOptions, type ConstructEventOptions, type ContentFitMode, type ContentFitSettings, type CreateRouteParams, DataClient, type Device, type DeviceCapabilityPayload, DevicesClient, EarningsClient, type EarningsData, type ErrorDetail, type ErrorEntry, type ErrorResponseBody, ErrorsClient, FleetClient, type FleetCommand, type GeneratedOperationName, type GeneratedSchemaName, type HttpProbeResult, type Impression, ImpressionsClient, type ListResponse, type MdnsNetworkDevice, type ParsedSignatureHeader, type PartnerAdDeliveryProfile, type PartnerDeviceBatchRegistrationInput, type PartnerDeviceHeartbeatBody, type PartnerDeviceRegistrationInput, type PartnerDisplaySettingsInput, type PartnerDisplaySettingsResponse, type PartnerHeartbeatMeasurementMetadata, type PartnerHeartbeatQueryData, type PartnerHeartbeatQueryResponse, type PartnerHeartbeatRequest, type PartnerHeartbeatResponse, type PartnerSafeHeartbeatTelemetry, type RequestOptions, type RetryOptions, type RouteAction, type RouteChannel, type RouteCondition, type RouteConditionOp, type RouteDigest, type RouteDigestSummary, type RouteWebhookEvent, RoutesClient, type Screen, ScreensClient, type SensingRoute, type SensingThresholdCrossedEvent, type SsdpDeviceInfo, TrillboardsClient, TrillboardsError, type TrillboardsErrorOptions, type UpdateRouteParams, VERSION, type Webhook, type WebhookEvent, type WebhookHeaders, Webhooks, WebhooksClient, type WifiEnvironmentSnapshot, type WifiScanResult, constructEvent, constructEventLegacy, generatedTypes, type getDeviceHeartbeatOperation, type heartbeatOperation, parseSignatureHeader, retryWithBackoff };