@lessly/sdk-app 105.4.0 → 105.6.0

package/dist/_types/gen/types.gen.d.ts

@@ -26,6 +26,12 @@ export interface AnalyticsCatalogGetOutput {
     }[];
     product_id: string;
     generated_at: string;
+    dropped_metrics?: {
+        type: string;
+        metric: string;
+        reason: ("type_unknown" | "aggregate_unknown" | "column_missing");
+        view_name: string;
+    }[];
 }
 export interface AnalyticsDashboardCreateInput {
     name: string;
@@ -117637,332 +117643,6 @@ export interface OrganizationYoutubeInstallInput {
 export interface OrganizationYoutubeInstallOutput {
     url: string;
 }
-export interface PlaygroundAnalyticsOverviewInput {
-    /**
-     * Max records per entity in recent[]; omit for the endpoint default
-     */
-    limit?: number;
-}
-export interface PlaygroundAnalyticsOverviewOutput {
-    ok: boolean;
-    minted: boolean;
-    overview?: unknown;
-    http_status: number;
-}
-export interface PlaygroundBillingEntitlementsInput {
-}
-export interface PlaygroundBillingEntitlementsOutput {
-    ok: boolean;
-    minted: boolean;
-    http_status: number;
-    entitlements?: unknown;
-}
-export interface PlaygroundBillingRecordUsageInput {
-    /**
-     * Quantity of events to record against playground-events (SUM); defaults to 1
-     */
-    value?: number;
-}
-export interface PlaygroundBillingRecordUsageOutput {
-    minted: boolean;
-    accepted: (number | null);
-    recorded: boolean;
-    duplicates: (number | null);
-    http_status: number;
-}
-export interface PlaygroundClickupCreateTaskInput {
-    /**
-     * Task title; defaults to a fixture label
-     */
-    name?: string;
-    /**
-     * ClickUp list id; falls back to CLICKUP_TEST_LIST_ID
-     */
-    listId?: string;
-}
-export interface PlaygroundClickupCreateTaskOutput {
-    minted: boolean;
-    task_id: (string | null);
-    list_status: number;
-    vend_status: number;
-    clickup_status: number;
-    installation_count: number;
-}
-export interface PlaygroundClickupGetLastWebhookInput {
-}
-export type PlaygroundClickupGetLastWebhookOutput = ({
-    payload: string;
-    event_id: string;
-    provider: string;
-    verified: boolean;
-    product_id: string;
-    occurred_at: string;
-    connector_id: string;
-    clickup_event: (string | null);
-    receipt_count: number;
-} | {
-    found: false;
-});
-export interface PlaygroundClickupGetOverviewInput {
-}
-export interface PlaygroundClickupGetOverviewOutput {
-    team: ({
-        teamId: string;
-        teamName: string;
-    } | null);
-    lists: PlaygroundClickupGetOverviewOutputItems[];
-    tasks: {
-        id: string;
-        name: string;
-        status: (string | null);
-    }[];
-    minted: boolean;
-    spaces: PlaygroundClickupGetOverviewOutputItems[];
-    list_status: number;
-    vend_status: number;
-    lists_status: number;
-    tasks_status: number;
-    spaces_status: number;
-    folders_status: number;
-    installation_count: number;
-}
-export interface PlaygroundClickupGetOverviewOutputItems {
-    id: string;
-    name: string;
-}
-export interface PlaygroundEchoPingInput {
-    /**
-     * The text to echo back, 1–1024 characters
-     */
-    message: string;
-}
-export interface PlaygroundEchoPingOutput {
-    /**
-     * The message exactly as it was received
-     */
-    message: string;
-    /**
-     * The product the call was resolved to
-     */
-    productId: string;
-    /**
-     * ISO-8601 instant (UTC) at which the call reached the service
-     */
-    receivedAt: string;
-}
-export interface PlaygroundGdriveGetLastChangeInput {
-}
-export type PlaygroundGdriveGetLastChangeOutput = ({
-    file_id: string;
-    removed: boolean;
-    file_name: (string | null);
-    mime_type: (string | null);
-    product_id: string;
-    occurred_at: string;
-    connector_id: string;
-    resource_state: string;
-} | {
-    found: false;
-});
-export interface PlaygroundGdriveReadFileInput {
-    /**
-     * Drive file id; falls back to GDRIVE_TEST_FILE_ID, then the first picked file
-     */
-    fileId?: string;
-}
-export interface PlaygroundGdriveReadFileOutput {
-    minted: boolean;
-    file_id: (string | null);
-    file_name: (string | null);
-    mime_type: (string | null);
-    file_count: number;
-    get_status: number;
-    list_status: number;
-    vend_status: number;
-    content_bytes: (number | null);
-}
-export interface PlaygroundGoogleadsReadCustomerInput {
-}
-export interface PlaygroundGoogleadsReadCustomerOutput {
-    minted: boolean;
-    vended: boolean;
-    customer_id: (string | null);
-    vend_status: number;
-    result_count: number;
-    search_status: number;
-    login_customer_id: (string | null);
-}
-export interface PlaygroundLifecycleGetStateInput {
-}
-export interface PlaygroundLifecycleGetStateOutput {
-    blocked: boolean;
-    archived: boolean;
-    productId: string;
-    lastBlockTransition: ({
-        eventId: string;
-        eventName: string;
-        productId: string;
-        occurredAt: string;
-        recordedAt: string;
-        receiptCount: number;
-        organizationId: string;
-        cascadedFromOrg: boolean;
-    } | null);
-    lastArchiveTransition: ({
-        eventId: string;
-        eventName: string;
-        productId: string;
-        occurredAt: string;
-        recordedAt: string;
-        receiptCount: number;
-        organizationId: string;
-        cascadedFromOrg: boolean;
-    } | null);
-}
-export interface PlaygroundLifecycleListEventsInput {
-}
-export type PlaygroundLifecycleListEventsOutput = {
-    eventId: string;
-    eventName: string;
-    productId: string;
-    occurredAt: string;
-    recordedAt: string;
-    receiptCount: number;
-    organizationId: string;
-    cascadedFromOrg: boolean;
-}[];
-export interface PlaygroundWebhookGetLastInput {
-}
-export type PlaygroundWebhookGetLastOutput = ({
-    payload?: unknown;
-    event_id: string;
-    provider: string;
-    verified: boolean;
-    product_id: string;
-    occurred_at: string;
-    connector_id: string;
-    delivery_count: number;
-} | {
-    found: false;
-});
-export interface PlaygroundWorkflowEchoInput {
-    /**
-     * The text to store, 1–1024 characters
-     */
-    note: string;
-    /**
-     * Optional labels stored alongside the note, at most 20
-     *
-     * @maxItems 20
-     */
-    tags?: [] | [string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string];
-}
-export interface PlaygroundWorkflowEchoOutput {
-    /**
-     * Identifier of the stored echo
-     */
-    id: string;
-    /**
-     * The note exactly as it was received
-     */
-    note: string;
-    /**
-     * The tags exactly as they were received
-     */
-    tags: string[];
-    /**
-     * Correlation id for this echo. The playground/workflow.echoed event published about two seconds later repeats it, which is how a composer matches the completion back to this step.
-     */
-    echo_id: string;
-    /**
-     * ISO-8601 instant (UTC) at which the echo was stored
-     */
-    received_at: string;
-}
-export interface PlaygroundWorkflowEchoListInput {
-}
-export type PlaygroundWorkflowEchoListOutput = {
-    /**
-     * Identifier of the stored echo
-     */
-    id: string;
-    /**
-     * The note exactly as it was received
-     */
-    note: string;
-    /**
-     * The tags exactly as they were received
-     */
-    tags: string[];
-    /**
-     * ISO-8601 instant (UTC) at which the echo was stored
-     */
-    received_at: string;
-}[];
-export interface PlaygroundWorkflowPingInput {
-    /**
-     * Class of ping, echoed on the emitted event and filterable on the trigger. Defaults to 'manual'.
-     */
-    kind?: string;
-}
-export interface PlaygroundWorkflowPingOutput {
-    /**
-     * Correlation id for this ping. The emitted playground/workflow.ping event repeats it, which is how a composer matches the event back to this step.
-     */
-    id: string;
-    /**
-     * The name of the event that was published
-     */
-    event: string;
-}
-export interface PlaygroundWorkflowSubjectsListInput {
-    /**
-     * How many subjects to return, 1–100. Defaults to 25.
-     */
-    limit?: number;
-    /**
-     * The next_cursor of the previous page. Opaque — pass it back unchanged. Omit for the first page.
-     */
-    cursor?: string;
-    /**
-     * ISO-8601 UTC instant. Return only subjects whose last_activity_at is AT OR AFTER this — the opposite question, the recently active population. Omit for no lower bound.
-     */
-    last_activity_after?: string;
-    /**
-     * ISO-8601 UTC instant. Return only subjects whose last_activity_at is AT OR BEFORE this — the "inactive for N days" question: pass now minus N days. Omit for no upper bound.
-     */
-    last_activity_before?: string;
-}
-export interface PlaygroundWorkflowSubjectsListOutput {
-    /**
-     * This page of subjects, most recently active first
-     */
-    items: {
-        /**
-         * Stable identifier for the subject. This is the field a batch trigger keys on, so a subject already served in an earlier run is skipped rather than served twice.
-         */
-        subject_key: string;
-        /**
-         * Human-readable name of the subject
-         */
-        display_name: string;
-        /**
-         * ISO-8601 instant (UTC) of the subject last activity
-         */
-        last_activity_at: string;
-    }[];
-    /**
-     * Whether another page follows. False and a null next_cursor both mark the last page, so a consumer that loops on either terminates.
-     */
-    has_more: boolean;
-    /**
-     * Pass back as `cursor` to fetch the next page; null on the last page. Always null when has_more is false.
-     */
-    next_cursor: (string | null);
-}
-export interface PlaygroundWsEchoInput {
-}
-export type PlaygroundWsEchoOutput = unknown;
 export interface RealtimeArchiveExportInput {
     /**
      * Only entries with ts <= to_ts (epoch ms)
@@ -142216,6 +141896,171 @@ export interface TrackingGoogleadsUsVsPlatformOutput {
      */
     costLastSyncedAt: (string | null);
 }
+export interface TrackingHeatmapsGetInput {
+    /**
+     * End of the period, ISO 8601: recordings that started at or before it.
+     */
+    to: string;
+    /**
+     * Start of the period, ISO 8601 (e.g. 2026-10-01T00:00:00Z): recordings that started at or after it. At most 30 days before `to`.
+     */
+    from: string;
+    /**
+     * Required: a map is drawn for one kind of device (desktop, tablet or mobile), since layouts differ.
+     */
+    device: ("desktop" | "tablet" | "mobile");
+    /**
+     * The page, as tracking_heatmaps_pages returns it: host + normalized path, e.g. shop.example.com/pricing.
+     */
+    pageKey: string;
+    /**
+     * true: only sessions with a conversion or a payment; false: only sessions without one. Omit for both.
+     */
+    converted?: boolean;
+    /**
+     * Only recordings whose entry page carried this utm_source, e.g. google.
+     */
+    utmSource?: string;
+    /**
+     * Only recordings whose entry page carried this utm_campaign, e.g. spring.
+     */
+    utmCampaign?: string;
+}
+export interface TrackingHeatmapsGetOutput {
+    /**
+     * At most 300 elements, most clicked first.
+     */
+    clicks: {
+        /**
+         * Clicks on it.
+         */
+        count: number;
+        /**
+         * Clicks on a 50x50 grid laid over the element; empty cells left out.
+         */
+        points: {
+            /**
+             * Cell centre across the element, 0 (left edge) to 1 (right edge).
+             */
+            rx: number;
+            /**
+             * Cell centre down the element, 0 (top) to 1 (bottom).
+             */
+            ry: number;
+            /**
+             * Clicks in the cell.
+             */
+            count: number;
+        }[];
+        /**
+         * CSS selector of the clicked element, as built in the browser.
+         */
+        selector: string;
+        /**
+         * Recordings with at least one click on it.
+         */
+        sessions: number;
+    }[];
+    /**
+     * How far down the page the sessions scrolled.
+     */
+    scroll: {
+        /**
+         * 20 shares (0..1): reached[i] is the share of the sessions that reported a scroll depth on the page whose deepest point is at least (i+1)*5% of the page height (reached[9] = the 50% line). Empty below the threshold.
+         */
+        reached: number[];
+        /**
+         * Median page height in px over those sessions. Null below the threshold or without any scroll sample.
+         */
+        medianDocHeight: (number | null);
+    };
+    /**
+     * Recordings of the period, device and filters with a click or a scroll sample on this page.
+     */
+    sessions: number;
+    /**
+     * The latest recording of this device (any time in retention) whose segment loaded this page with a full snapshot at its start. Null when none: a page only ever reached by in-app navigation has no picture of its own.
+     */
+    background: ({
+        /**
+         * Page load of the segment.
+         */
+        pid: string;
+        /**
+         * Consent (re)start of the segment.
+         */
+        seg: number;
+        /**
+         * Recording to draw the page from. Pass to tracking_recordings_chunks_get with pid and seg.
+         */
+        recordingId: string;
+    } | null);
+    /**
+     * True when sessions < 10: clicks and scroll.reached are then empty and medianDocHeight null.
+     */
+    belowThreshold: boolean;
+}
+export interface TrackingHeatmapsPagesInput {
+    /**
+     * Only pages whose key contains this text, case-insensitively, e.g. /pricing.
+     */
+    q?: string;
+    /**
+     * End of the period, ISO 8601: recordings that started at or before it.
+     */
+    to: string;
+    /**
+     * Start of the period, ISO 8601 (e.g. 2026-10-01T00:00:00Z): recordings that started at or after it. At most 30 days before `to`.
+     */
+    from: string;
+    /**
+     * Pages per page of results, 1 to 100 (default 50).
+     */
+    limit?: number;
+    /**
+     * Continue a previous page: pass the nextCursor it returned.
+     */
+    cursor?: string;
+    /**
+     * Only recordings from this kind of device: desktop, tablet or mobile. Omit for all.
+     */
+    device?: ("desktop" | "tablet" | "mobile");
+    /**
+     * true: only sessions with a conversion or a payment; false: only sessions without one. Omit for both.
+     */
+    converted?: boolean;
+    /**
+     * Only recordings whose entry page carried this utm_source, e.g. google.
+     */
+    utmSource?: string;
+    /**
+     * Only recordings whose entry page carried this utm_campaign, e.g. spring.
+     */
+    utmCampaign?: string;
+}
+export interface TrackingHeatmapsPagesOutput {
+    /**
+     * Most sessions first.
+     */
+    pages: {
+        /**
+         * Clicks on this page in those recordings.
+         */
+        clicks: number;
+        /**
+         * host + normalized path: no query, no hash, ids and hashes replaced by *. Pass it to tracking_heatmaps_get.
+         */
+        pageKey: string;
+        /**
+         * Recordings of the period and filters with a click or a scroll sample on this page.
+         */
+        sessions: number;
+    }[];
+    /**
+     * Pass back as cursor for the next page. Null on the last page.
+     */
+    nextCursor: (string | null);
+}
 export interface TrackingIdentityHealthInput {
 }
 export interface TrackingIdentityHealthOutput {
@@ -143254,6 +143099,10 @@ export interface TrackingRecordingsListInput {
      * Continue a previous page: pass the nextCursor it returned. Omit to start from the newest recording.
      */
     cursor?: string;
+    /**
+     * Only recordings from this kind of device, as classified on ingest: desktop, tablet or mobile.
+     */
+    device?: ("desktop" | "tablet" | "mobile");
     /**
      * true: only sessions with a conversion or a payment; false: only sessions without one. Omit for both.
      */