@trillboards/api-client 0.4.1 → 1.1.0

package/dist/index.d.ts

@@ -1,8 +1,26 @@
+import { Screen, PartnerDeviceRegistrationInput, DisplaySettingsResponse, DisplaySettingsInput, Device, PartnerDeviceBatchRegistrationInput, Impression, AnalyticsData, EarningsData, ErrorEntry, Webhook, FleetCommand, AudienceData, BillingInfo, CreatePartnerSensingRouteRequest, SensingRoute, UpdatePartnerSensingRouteRequest, WebhookEvent } from './generated.js';
+export { BleScanResultData, ContentFitSettings, DeviceCapabilityPayload, GeneratedOperationName, GeneratedSchemaName, HttpProbeResult, MdnsNetworkDevice, PartnerAdDeliveryProfile, PartnerDeviceHeartbeatBody, PartnerHeartbeatMeasurementMetadata, PartnerHeartbeatQueryData, PartnerHeartbeatQueryResponse, PartnerHeartbeatRequest, PartnerHeartbeatResponse, PartnerSafeHeartbeatTelemetry, SsdpDeviceInfo, WifiEnvironmentSnapshot, WifiScanResult, generatedTypes, getDeviceHeartbeatOperation, heartbeatOperation } from './generated.js';
+
 /**
- * Core type definitions for the Trillboards API Client SDK.
+ * Non-wire type definitions for the Trillboards API Client SDK.
+ *
+ * This file is DELIBERATELY narrow. Every type that has an on-the-wire peer in
+ * the OpenAPI contract lives in `./generated` (emitted from
+ * trillboard-api/docs/openapi/merged/partner-api.json via `npm run generate`)
+ * and is re-exported from `./index`. What remains here is the set of types that
+ * CANNOT be generated from the spec and are the SDK's own hand-crafted surface:
+ *
+ *   - the error contract (mirrors trillboard-api/utils/apiErrors.ts),
+ *   - client/request ergonomics (`ClientOptions`, `RequestOptions`),
+ *   - the generic pagination envelope (`ListResponse<T>`),
+ *   - the Sense Anything "Route" ergonomics + the FLAT route-fire webhook body
+ *     (richer than the spec can express — the digest summary is a typed object,
+ *     not the spec's `observed: unknown`),
+ *   - the `ContentFitMode` literal helper.
  *
- * Mirrors the canonical error contract from trillboard-api/utils/apiErrors.ts
- * and the OpenAPI schema at trillboard-api/docs/openapi/partner-api.yaml.
+ * Entity/wire types (`Screen`, `Device`, `Webhook`, `WebhookEvent`, `SensingRoute`,
+ * display-settings + device-registration inputs, etc.) are NOT here — import them
+ * from `@trillboards/api-client` (re-exported from `./generated`).
  */
 type ApiErrorType = 'invalid_request_error' | 'authentication_error' | 'permission_error' | 'rate_limit_error' | 'idempotency_error' | 'api_error';
 interface ErrorDetail {
@@ -45,158 +63,12 @@ interface ListResponse<T> {
         has_more: boolean;
     };
 }
+/**
+ * Per-content-type sizing mode. `fit` preserves the entire creative and may
+ * letterbox; `fill` covers the screen and may crop edges. A convenience literal
+ * for callers building `ContentFitSettings` values; the spec inlines this union.
+ */
 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;
-    status: string;
-    device_id?: string;
-    venue_type?: string;
-    country?: string;
-    city?: string;
-    timezone?: string;
-    resolution?: string;
-    embed_url?: string;
-    created_at: string;
-    updated_at: string;
-}
-interface Device {
-    device_id: string;
-    device_name: string;
-    device_type?: string;
-    platform?: string;
-    screen_id?: string;
-    status: string;
-    last_heartbeat?: string;
-    created_at: string;
-    updated_at: string;
-}
-interface Impression {
-    impression_id: string;
-    screen_id: string;
-    device_id: string;
-    ad_type?: string;
-    advertiser_name?: string;
-    cpm?: number;
-    earnings?: number;
-    played_at: string;
-    duration_seconds?: number;
-}
-interface AnalyticsData {
-    period: string;
-    total_impressions: number;
-    total_earnings: number;
-    average_cpm: number;
-    fill_rate: number;
-    screens_active: number;
-    screens_total: number;
-    by_screen?: Array<{
-        screen_id: string;
-        name: string;
-        impressions: number;
-        earnings: number;
-    }>;
-}
-interface EarningsData {
-    period: string;
-    total_earnings: number;
-    total_impressions: number;
-    average_cpm: number;
-    daily?: Array<{
-        date: string;
-        earnings: number;
-        impressions: number;
-    }>;
-    pending_payout: number;
-    last_payout_date?: string;
-    last_payout_amount?: number;
-}
-interface WebhookEvent {
-    id: string;
-    type: string;
-    created_at: string;
-    data: Record<string, unknown>;
-    partner_id: string;
-}
-interface Webhook {
-    id: string;
-    url: string;
-    events: string[];
-    status: string;
-    secret: string;
-    created_at: string;
-    updated_at: string;
-}
-interface ErrorEntry {
-    id: string;
-    code: string;
-    type: ApiErrorType;
-    message: string;
-    param?: string;
-    doc_url: string;
-    timestamp: string;
-    request_id: string;
-    endpoint: string;
-    method: string;
-}
-interface FleetCommand {
-    command_id: string;
-    command: string;
-    status: string;
-    target_screens: string[];
-    created_at: string;
-    completed_at?: string;
-}
-interface AudienceData {
-    screen_id: string;
-    timestamp: string;
-    attention_count: number;
-    dwell_time_avg: number;
-    demographics?: Record<string, unknown>;
-}
-interface BillingInfo {
-    plan: string;
-    credits_remaining: number;
-    credits_used: number;
-    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).
@@ -227,55 +99,6 @@ interface RouteDigest {
     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
@@ -307,6 +130,10 @@ interface RouteDigestSummary {
  *
  * `observed` is a scalar for threshold Routes; for a digest Route
  * (`venue.traffic_summary`) it is a {@link RouteDigestSummary} object.
+ *
+ * Kept hand-authored (not routed to the generated `SensingThresholdCrossedEvent`)
+ * because the emitter's flat-property-bag walker can only type `observed`/`threshold`
+ * as `unknown`; the typed unions here are a deliberate ergonomic improvement.
  */
 interface SensingThresholdCrossedEvent {
     route_id: string;
@@ -420,13 +247,13 @@ declare class ScreensClient {
         data: Screen;
     }>;
     /** Get the resolved display settings for one screen. */
-    getDisplaySettings(screenId: string): Promise<PartnerDisplaySettingsResponse>;
+    getDisplaySettings(screenId: string): Promise<DisplaySettingsResponse>;
     /** Partially update display settings; omitted content-fit keys are preserved. */
-    patchDisplaySettings(screenId: string, settings: PartnerDisplaySettingsInput): Promise<PartnerDisplaySettingsResponse>;
+    patchDisplaySettings(screenId: string, settings: DisplaySettingsInput): Promise<DisplaySettingsResponse>;
     /** Update display settings through the PUT endpoint. */
-    updateDisplaySettings(screenId: string, settings: PartnerDisplaySettingsInput): Promise<PartnerDisplaySettingsResponse>;
+    updateDisplaySettings(screenId: string, settings: DisplaySettingsInput): Promise<DisplaySettingsResponse>;
     /** Apply a partial display-settings update to up to 100 screens. */
-    batchUpdateDisplaySettings(screenIds: string[], settings: PartnerDisplaySettingsInput): Promise<Record<string, unknown>>;
+    batchUpdateDisplaySettings(screenIds: string[], settings: DisplaySettingsInput): Promise<Record<string, unknown>>;
     /** Delete a screen/device. */
     delete(screenId: string): Promise<{
         success: boolean;
@@ -598,7 +425,14 @@ declare class WebhooksClient {
     constructor(http: HttpClient);
     /** List all webhook subscriptions. */
     list(): Promise<ListResponse<Webhook>>;
-    /** Create a new webhook subscription. */
+    /**
+     * Create a new webhook subscription.
+     *
+     * The created `Webhook` carries its signing `secret` (`whsec_…`) — this is the
+     * ONLY time it is returned. Persist it securely and pass it to
+     * `Webhooks.constructEvent()` to verify the compound `X-Trillboards-Signature`
+     * header over the raw delivery body.
+     */
     create(body: {
         url: string;
         events: string[];
@@ -748,7 +582,7 @@ 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<{
+    create(body: CreatePartnerSensingRouteRequest): Promise<{
         success: boolean;
         data: {
             route: SensingRoute;
@@ -771,7 +605,7 @@ declare class RoutesClient {
         };
     }>;
     /** Update a Route (partial, non-clobbering — only the fields you send change). */
-    update(routeId: string, body: UpdateRouteParams): Promise<{
+    update(routeId: string, body: UpdatePartnerSensingRouteRequest): Promise<{
         success: boolean;
         data: {
             route: SensingRoute;
@@ -964,7 +798,7 @@ declare function parseSignatureHeader(rawSig: string): ParsedSignatureHeader;
  *       req.headers,                           // IncomingHttpHeaders
  *       process.env.WEBHOOK_SECRET!,           // your subscription secret
  *     );
- *     console.log('Received', event.type);
+ *     console.log('Received', event.event);
  *     res.sendStatus(200);
  *   } catch (err) {
  *     // TrillboardsError with code "webhook_signature_invalid"
@@ -987,428 +821,80 @@ declare function constructEvent(payload: string | Buffer, headers: WebhookHeader
  * legacy shim preserves only for migration compatibility.
  */
 declare function constructEventLegacy(payload: string | Buffer, signature: string, secret: string): WebhookEvent;
+/** RFC 9421 `tag` Trillboards stamps on outbound AdCP webhooks. */
+declare const ADCP_WEBHOOK_SIGNING_TAG = "adcp/webhook-signing/v1";
+/** An Ed25519 public key from the Trillboards JWKS. */
+interface AdcpJwk {
+    kty: string;
+    crv: string;
+    x: string;
+    kid: string;
+    alg?: string;
+    use?: string;
+    key_ops?: string[];
+    adcp_use?: string;
+}
+interface VerifyAdcpWebhookOptions {
+    /** Absolute URL the webhook was delivered to. Must be the URL you published. */
+    url: string;
+    /** HTTP method of the delivery. Defaults to POST. */
+    method?: string;
+    /** Delivery headers (case-insensitive). */
+    headers: WebhookHeaders;
+    /** Raw request body — EXACTLY the bytes received, never a re-stringify. */
+    payload: string | Buffer;
+    /** Keys from https://api.trillboards.com/.well-known/jwks.json */
+    keys: AdcpJwk[];
+    /** Override the verifier's clock (seconds). Tests only. */
+    nowSec?: number;
+}
+/**
+ * Verify an AdCP RFC 9421 webhook signature and parse the event.
+ *
+ * Checks, in order: header pair present → covered components complete → tag is
+ * the webhook tag → signature window sane and unexpired → key resolvable and
+ * purpose-valid → body digest matches → signature verifies.
+ *
+ * Replay defence beyond the window (per-`nonce` dedup) is the caller's — the
+ * nonce is exposed on the return value for exactly that.
+ *
+ * @throws TrillboardsError(authentication_error / webhook_signature_invalid)
+ *
+ * @example
+ * import { Webhooks } from '@trillboards/api-client';
+ *
+ * const { keys } = await (await fetch(
+ *   'https://api.trillboards.com/.well-known/jwks.json',
+ * )).json();
+ *
+ * app.post('/adcp/webhook', express.raw({ type: 'application/json' }), (req, res) => {
+ *   const { event } = Webhooks.verifyAdcpWebhook({
+ *     url: `https://buyer.example.com${req.originalUrl}`,
+ *     headers: req.headers,
+ *     payload: req.body,
+ *     keys,
+ *   });
+ *   res.sendStatus(200);
+ * });
+ */
+declare function verifyAdcpWebhook(opts: VerifyAdcpWebhookOptions): {
+    event: WebhookEvent;
+    keyid: string;
+    nonce: string;
+    expires: number;
+};
 /** Namespaced export — matches the Stripe-style API. */
 declare const Webhooks: {
     constructEvent: typeof constructEvent;
     constructEventLegacy: typeof constructEventLegacy;
     parseSignatureHeader: typeof parseSignatureHeader;
+    verifyAdcpWebhook: typeof verifyAdcpWebhook;
 };
 
 /**
  * SDK version constant. Sent in User-Agent and X-Trillboards-Client headers.
  * Keep in sync with package.json version.
  */
-declare const VERSION = "0.4.1";
-
-type BleScanResultData = {
-    appleContinuitySubtype?: number | null;
-    deviceType?: number | null;
-    ibeaconMajor?: number | null;
-    ibeaconMinor?: number | null;
-    ibeaconUuid?: string | null;
-    manufacturerCompanyId?: number | null;
-    rawAddress: string;
-    rssi: number;
-    serviceUuids?: Array<string> | null;
-    stableManufacturerPayloadHex?: string | null;
-    txPowerDbm?: number | null;
-    [key: string]: unknown;
-};
-type DeviceCapabilityPayload = {
-    agentType?: string | null;
-    agentVersion?: string | null;
-    audienceSensing?: {
-        cameraAvailable?: boolean | null;
-        cameraCount?: number | null;
-        cameraHealth?: {
-            lastFailureClass?: string | null;
-            lastFailureMessage?: string | null;
-            lastFrameAtMs?: number | null;
-            retryCount?: number | null;
-            state?: string | null;
-            [key: string]: unknown;
-        } | null;
-        cameraType?: string | null;
-        microphoneAvailable?: boolean | null;
-        sensingMode?: string | null;
-        [key: string]: unknown;
-    } | null;
-    audioControl?: {
-        mute?: boolean | null;
-        volume?: boolean | null;
-        [key: string]: unknown;
-    } | null;
-    capabilitiesVersion?: number | null;
-    environmentSensors?: {
-        ambientLight?: boolean | null;
-        temperature?: boolean | null;
-        [key: string]: unknown;
-    } | null;
-    inputControl?: {
-        appSwitch?: boolean | null;
-        hdmi?: boolean | null;
-        [key: string]: unknown;
-    } | null;
-    isDeviceOwner?: boolean | null;
-    managementCapabilities?: {
-        clearCache?: boolean | null;
-        installApk?: boolean | null;
-        kioskMode?: boolean | null;
-        reboot?: boolean | null;
-        restart?: boolean | null;
-        screenshot?: boolean | null;
-        wipe?: boolean | null;
-        [key: string]: unknown;
-    } | null;
-    mlCapabilities?: {
-        availableRamMb?: number | null;
-        chipsetName?: string | null;
-        chipsetVendor?: string | null;
-        cpuAbi?: string | null;
-        densityDpi?: number | null;
-        gpuDelegateSupported?: boolean | null;
-        gpuName?: string | null;
-        hasNpu?: boolean | null;
-        maxVlmSizeMb?: number | null;
-        nnapiSupported?: boolean | null;
-        npuName?: string | null;
-        osApiLevel?: number | null;
-        recommendedModelTier?: string | null;
-        screenHeightPx?: number | null;
-        screenWidthPx?: number | null;
-        totalRamMb?: number | null;
-        [key: string]: unknown;
-    } | null;
-    powerControl?: {
-        cec?: boolean | null;
-        softBlackout?: boolean | null;
-        wol?: boolean | null;
-        [key: string]: unknown;
-    } | null;
-    wifiCsiSensing?: {
-        csiAvailable?: boolean | null;
-        csiHardwareType?: string | null;
-        csiNodeCount?: number | null;
-        [key: string]: unknown;
-    } | null;
-    [key: string]: unknown;
-};
-type HttpProbeResult = {
-    host: string;
-    port?: number | null;
-    server?: string | null;
-    [key: string]: unknown;
-};
-type MdnsNetworkDevice = {
-    host?: string | null;
-    instanceName: string;
-    mdnsModel?: string | null;
-    mdnsSoftwareVersion?: string | null;
-    mdnsVendor?: string | null;
-    port?: number | null;
-    serviceType: string;
-    [key: string]: unknown;
-};
-type PartnerAdDeliveryProfile = {
-    android_api_level?: number | null;
-    auto_recovery_enabled?: boolean;
-    ima_integration?: "android_native" | "html5_webview" | "disabled" | "unknown";
-    mode?: "ima_sdk" | "vast_fallback";
-    notes?: Array<string>;
-    reason?: string;
-    webview_chromium_major?: number | null;
-};
-/**
- * Heartbeat payload from agent-core / agent-core-lite Android partner
- * SDKs. Only includes fields verified populated in production
- * `signal_observations` (last 30 days). Stub fields wired in Kotlin but
- * never observed in CH are intentionally excluded; re-add only after
- * telemetry confirms >1% population over 7 days.
- *
- */
-type PartnerDeviceHeartbeatBody = {
-    advertisingId?: string | null;
-    advertisingIdType?: "gaid" | "idfa" | null | null;
-    bleDeviceCount?: number;
-    capabilities?: DeviceCapabilityPayload;
-    discoveredNetworkDevices?: Array<MdnsNetworkDevice> | null;
-    fingerprint?: string;
-    gatewayIpHash?: string | null;
-    httpProbes?: Array<HttpProbeResult> | null;
-    limitAdTracking?: boolean | null;
-    metadata?: Record<string, unknown>;
-    /** Capped at 50 devices (RSSI-sorted, strongest first). */
-    nearbyBleDevices?: Array<BleScanResultData> | null;
-    nearbyWifiNetworks?: Array<WifiScanResult> | null;
-    networkDeviceCount?: number;
-    /** Heartbeat schema version (1=baseline, 2=nativeSensorSnapshot) */
-    schemaVersion?: number;
-    screenId?: string | null;
-    /** Per-source skip-reason counter map. Shape `{source: {reason: count}}`. */
-    skipReasonCounts?: Record<string, Record<string, number>>;
-    ssdpDevices?: Array<SsdpDeviceInfo> | null;
-    status?: string;
-    wifiBssidHash?: string | null;
-    wifiEnvironment?: WifiEnvironmentSnapshot;
-    wifiNetworkCount?: number;
-    wifiSsidHash?: string | null;
-    [key: string]: unknown;
-};
-type PartnerHeartbeatCommand = {
-    /** Command normalized for partner SDK compatibility. */
-    command?: string;
-    id?: string;
-    payload?: Record<string, unknown>;
-    queued_at?: string;
-};
-type PartnerHeartbeatData = {
-    ad_delivery_profile?: PartnerAdDeliveryProfile;
-    commands?: Array<PartnerHeartbeatCommand>;
-    last_seen_at?: string;
-    status?: "online" | "offline";
-};
-type PartnerHeartbeatMeasurementMetadata = {
-    ageSeconds?: number | null;
-    cachedAt?: string | null;
-    receivedAt?: string | null;
-    source?: "redis_twin" | "pg_fallback" | "unknown";
-    [key: string]: unknown;
-};
-type PartnerHeartbeatQueryData = {
-    adDeliveryProfile?: PartnerAdDeliveryProfile;
-    deviceId: string;
-    lastHeartbeatAt?: string | null;
-    measurementMetadata?: PartnerHeartbeatMeasurementMetadata;
-    stalenessSeconds?: number | null;
-    telemetry?: PartnerSafeHeartbeatTelemetry;
-    [key: string]: unknown;
-};
-type PartnerHeartbeatQueryResponse = {
-    data?: PartnerHeartbeatQueryData;
-    success?: boolean;
-};
-/**
- * Optional heartbeat payload. Nested telemetry objects are preferred; legacy flat keys
- * are still accepted for backward compatibility.
- *
- */
-type PartnerHeartbeatRequest = {
-    ad?: {
-        last_vast_request_at?: string;
-        last_vast_response_at?: string;
-        proof_of_play_enabled?: boolean;
-    };
-    agent_status?: string;
-    agent_version?: string;
-    android_api_level?: number;
-    brightness?: number;
-    desugaring_enabled?: boolean;
-    device?: {
-        android_api_level?: number;
-        make?: string;
-        model?: string;
-        os?: string;
-        osv?: string;
-        webview_chromium_major?: number;
-    };
-    ima_integration?: "android_native" | "html5_webview" | "disabled" | "unknown";
-    ima_sdk_version?: string;
-    ima_support_reason?: string;
-    ima_supported?: boolean;
-    input_source?: string;
-    last_ima_error_code?: number;
-    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;
-    network?: {
-        bandwidthMbps?: number;
-        connectionType?: string;
-        downlinkMbps?: number;
-        effectiveType?: string;
-        latencyRtt?: number;
-        rtt?: number;
-        saveData?: boolean;
-    };
-    network_strength_dbm?: number;
-    power_state?: "on" | "standby" | "off" | "unknown";
-    proof_of_play_enabled?: boolean;
-    sdk?: {
-        android_api_level?: number;
-        desugaring_enabled?: boolean;
-        ima_integration?: "android_native" | "html5_webview" | "disabled" | "unknown";
-        ima_sdk_version?: string;
-        ima_supported?: boolean;
-        version?: string;
-        webview_chromium_major?: number;
-    };
-    sdk_version?: string;
-    telemetry?: PartnerHeartbeatTelemetry;
-    temperature_c?: number;
-    uptime_seconds?: number;
-    volume?: number;
-    webview_chromium_major?: number;
-};
-type PartnerHeartbeatResponse = {
-    data?: PartnerHeartbeatData;
-    success?: boolean;
-};
-type PartnerHeartbeatTelemetry = {
-    agentStatus?: string;
-    agentVersion?: string;
-    android_api_level?: number;
-    bandwidthMbps?: number;
-    brightness?: number;
-    connectionType?: string;
-    desugaring_enabled?: boolean;
-    downlinkMbps?: number;
-    ima_integration?: "android_native" | "html5_webview" | "disabled" | "unknown";
-    ima_sdk_version?: string;
-    ima_support_reason?: string;
-    ima_supported?: boolean;
-    inputSource?: string;
-    last_ima_error_code?: number;
-    last_vast_error_code?: number;
-    last_vast_request_at?: string;
-    last_vast_response_at?: string;
-    latencyRtt?: number;
-    make?: string;
-    model?: string;
-    muted?: boolean;
-    networkConnectionType?: string;
-    networkEffectiveType?: string;
-    networkStrengthDbm?: number;
-    os?: string;
-    osVersion?: string;
-    osv?: string;
-    powerState?: "on" | "standby" | "off" | "unknown";
-    proof_of_play_enabled?: boolean;
-    rtt?: number;
-    saveData?: boolean;
-    temperatureC?: number;
-    uptimeSeconds?: number;
-    volume?: number;
-    webview_chromium_major?: number;
-    [key: string]: unknown;
-};
-/**
- * Partner-safe subset of device telemetry. Strips MDM compliance,
- * Vertex embeddings, identity-correction internals, partner identifiers,
- * and Mongo `_id` so partners only see what they need to decide
- * whether a device is healthy enough to receive ads.
- *
- */
-type PartnerSafeHeartbeatTelemetry = {
-    agentStatus?: string | null;
-    agentVersion?: string | null;
-    bandwidthMbps?: number | null;
-    brightness?: number | null;
-    connectionType?: string | null;
-    consecutiveAdFailures?: number | null;
-    effectiveType?: string | null;
-    latencyRtt?: number | null;
-    make?: string | null;
-    model?: string | null;
-    muted?: boolean | null;
-    networkStrengthDbm?: number | null;
-    onlineStatus?: "online" | "offline" | "standby" | "unknown" | null;
-    os?: string | null;
-    osv?: string | null;
-    powerState?: string | null;
-    temperatureC?: number | null;
-    ua?: string | null;
-    uptimeSeconds?: number | null;
-    visibilityState?: string | null;
-    volume?: number | null;
-    [key: string]: unknown;
-};
-type SsdpDeviceInfo = {
-    friendlyName?: string | null;
-    location: string;
-    manufacturer?: string | null;
-    modelName?: string | null;
-    server?: string | null;
-    st: string;
-    udn?: string | null;
-    [key: string]: unknown;
-};
-type WifiEnvironmentSnapshot = {
-    channelCongestionRatio?: number | null;
-    connectedChannelWidthMhz?: number | null;
-    connectedFrequencyMhz?: number | null;
-    connectedLinkSpeedMbps?: number | null;
-    connectedSignalDbm?: number | null;
-    frequencyBand?: string | null;
-    medianSignalDbm?: number | null;
-    networkCount?: number | null;
-    rssiVariance?: number | null;
-    scanTimestampMs?: number | null;
-    signalSpreadDbm?: number | null;
-    uniqueBssidCount?: number | null;
-    [key: string]: unknown;
-} | null;
-type WifiScanResult = {
-    channelWidthMhz?: number | null;
-    frequencyMhz: number;
-    rawBssid: string;
-    signalStrengthDbm: number;
-    [key: string]: unknown;
-};
-/**
- * Read live device heartbeat state
- * GET /device/{deviceId}/heartbeat
- */
-interface getDeviceHeartbeatOperation {
-    readonly path: "/device/{deviceId}/heartbeat";
-    readonly method: "GET";
-    request: never;
-    response: PartnerHeartbeatQueryResponse;
-}
-/**
- * Device heartbeat
- * POST /device/{deviceId}/heartbeat
- */
-interface heartbeatOperation {
-    readonly path: "/device/{deviceId}/heartbeat";
-    readonly method: "POST";
-    request: PartnerHeartbeatRequest | PartnerDeviceHeartbeatBody;
-    response: PartnerHeartbeatResponse;
-}
-declare const generatedTypes: {
-    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];
+declare const VERSION = "1.1.0";
 
-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 };
+export { ADCP_WEBHOOK_SIGNING_TAG, type AdcpJwk, AnalyticsClient, AnalyticsData, type ApiErrorType, AudienceClient, AudienceData, BillingClient, BillingInfo, type ClientOptions, type ConstructEventOptions, type ContentFitMode, CreatePartnerSensingRouteRequest, DataClient, Device, DevicesClient, DisplaySettingsInput, DisplaySettingsResponse, EarningsClient, EarningsData, type ErrorDetail, ErrorEntry, type ErrorResponseBody, ErrorsClient, FleetClient, FleetCommand, Impression, ImpressionsClient, type ListResponse, type ParsedSignatureHeader, PartnerDeviceBatchRegistrationInput, PartnerDeviceRegistrationInput, type RequestOptions, type RetryOptions, type RouteAction, type RouteChannel, type RouteCondition, type RouteConditionOp, type RouteDigest, type RouteDigestSummary, type RouteWebhookEvent, RoutesClient, Screen, ScreensClient, SensingRoute, type SensingThresholdCrossedEvent, TrillboardsClient, TrillboardsError, type TrillboardsErrorOptions, UpdatePartnerSensingRouteRequest, VERSION, type VerifyAdcpWebhookOptions, Webhook, WebhookEvent, type WebhookHeaders, Webhooks, WebhooksClient, constructEvent, constructEventLegacy, parseSignatureHeader, retryWithBackoff, verifyAdcpWebhook };