@lessly/sdk-app 103.0.0 → 104.0.0

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

@@ -26,12 +26,6 @@ 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;
@@ -117620,6 +117614,332 @@ 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)
@@ -140847,7 +141167,7 @@ export interface TrackingEntitlementDropsGetInput {
 }
 export interface TrackingEntitlementDropsGetOutput {
     /**
-     * Null when no event was refused this month.
+     * Null when no event and no session recording was refused this month.
      */
     drops: ({
         /**
@@ -140878,6 +141198,10 @@ export interface TrackingEntitlementDropsGetOutput {
          * First refused flush this month, ISO 8601 UTC.
          */
         firstDroppedAt: string;
+        /**
+         * Session recordings not kept this month because billing refused them (trial recording limit reached, billing paused).
+         */
+        droppedRecordings: number;
     } | null);
     /**
      * First day of the current UTC month the figures cover, YYYY-MM-DD, e.g. 2026-09-01.
@@ -142064,7 +142388,7 @@ export interface TrackingLiveEventsListOutput {
          */
         country: (string | null);
         /**
-         * Pseudonymous visitor id the person graph joins on. Null for a visitor who declined statistics consent or was never asked — those events arrive cookieless and carry no identifier at all.
+         * Shortened event anonymous id. From the rollout, keyed cookieless events carry d:<daily key>: a one-day visitor rotating every UTC midnight, never a toolkit profile. They appear in funnels, person counts and retention as separate people each day; filter consent_statistics = true for consented-only figures and always for retention. Null when no id or daily key is available.
          */
         anonymousId: (string | null);
     }[];
@@ -142122,6 +142446,32 @@ export interface TrackingProfilesDeleteOutput {
      * This erasure attempt. The completion event carries the same value under the same name, so a step recognises its own completion even when another workflow is erasing the same person at the same moment.
      */
     requestId: string;
+    /**
+     * What happened to the session recordings of this person. Unlike the events archive, they are deleted per person.
+     */
+    recordings: {
+        /**
+         * Session recordings of this person removed, across every browser they were seen on.
+         */
+        deleted: number;
+        /**
+         * The stored files of those recordings.
+         */
+        objects: {
+            /**
+             * Stored recording files deleted now.
+             */
+            deleted: number;
+            /**
+             * Recording files that were already gone.
+             */
+            missing: number;
+            /**
+             * Recordings whose files could not be deleted at once and are being deleted in the background; 0 normally.
+             */
+            pending: number;
+        };
+    };
 }
 export interface TrackingProfilesExportInput {
     /**
@@ -142604,6 +142954,345 @@ export interface TrackingProfilesListOutput {
         firstSeenAt: string;
     }[];
 }
+export interface TrackingRecordingSettingsGetInput {
+}
+export interface TrackingRecordingSettingsGetOutput {
+    /**
+     * Whether session recording is on. Only visitors in full tracking mode (statistics consent, or no consent banner) are recorded.
+     */
+    enabled: boolean;
+    /**
+     * Percent of sessions recorded, 1 to 100 when on (e.g. 25); 0 is allowed only when off.
+     */
+    sampleRate: number;
+}
+export interface TrackingRecordingSettingsSetInput {
+    /**
+     * Whether session recording is on. Only visitors in full tracking mode (statistics consent, or no consent banner) are recorded.
+     */
+    enabled: boolean;
+    /**
+     * Percent of sessions recorded, 1 to 100 when on (e.g. 25); 0 is allowed only when off.
+     */
+    sampleRate: number;
+}
+export interface TrackingRecordingSettingsSetOutput {
+    /**
+     * Whether session recording is on. Only visitors in full tracking mode (statistics consent, or no consent banner) are recorded.
+     */
+    enabled: boolean;
+    /**
+     * Percent of sessions recorded, 1 to 100 when on (e.g. 25); 0 is allowed only when off.
+     */
+    sampleRate: number;
+}
+export interface TrackingRecordingsChunksGetInput {
+    /**
+     * The recording id (uuid), from tracking_recordings_list.
+     */
+    id: string;
+    /**
+     * Page load of the segment, from the segments of tracking_recordings_get.
+     */
+    pid: string;
+    /**
+     * Consent (re)start of the segment within that page load, from tracking_recordings_get.
+     */
+    seg: number;
+    /**
+     * Continue a segment: pass the nextSeq the previous page returned. Default 0, the start.
+     */
+    fromSeq?: number;
+    /**
+     * Decoded bytes per page (default 2097152, max 8388608). A page ends at the first whole payload past it and always holds at least one.
+     */
+    maxBytes?: number;
+}
+export interface TrackingRecordingsChunksGetOutput {
+    /**
+     * Stretches of the segment that could not be played: lost slices, or payloads that did not decode. Show "part of the recording is lost" there.
+     */
+    gaps: {
+        /**
+         * Last lost slice, inclusive.
+         */
+        toSeq: number;
+        /**
+         * First lost slice.
+         */
+        fromSeq: number;
+    }[];
+    /**
+     * rrweb events of this page of the segment, in order. Feed them to the player.
+     */
+    events: unknown[];
+    /**
+     * Pass back as fromSeq for the next page. Null once the segment is read to its end. On an active recording it can equal the fromSeq you sent, with no events: the last part is still arriving — ask again later.
+     */
+    nextSeq: (number | null);
+}
+export interface TrackingRecordingsGetInput {
+    /**
+     * The recording id (uuid), from tracking_recordings_list.
+     */
+    id: string;
+}
+export interface TrackingRecordingsGetOutput {
+    /**
+     * The recording id. Pass it to tracking_recordings_get.
+     */
+    id: string;
+    /**
+     * desktop, mobile or tablet, from the browser. Null when unknown.
+     */
+    device: (string | null);
+    /**
+     * Tracker events of the session, oldest first, at most 2000.
+     */
+    events: {
+        /**
+         * When the event happened, ISO 8601, browser clock.
+         */
+        at: string;
+        /**
+         * Event name: page_view, a custom name, a conversion or a revenue event.
+         */
+        name: string;
+        /**
+         * The value the event carried. Null when none.
+         */
+        revenue: ({
+            /**
+             * ISO 4217 code, e.g. EUR.
+             */
+            currency: (string | null);
+            /**
+             * Amount in minor units, e.g. 1999 = 19.99.
+             */
+            amountMinor: number;
+        } | null);
+        /**
+         * Milliseconds from the start of the recording on the player clock; negative when it happened before recording began. Seek the player here.
+         */
+        offsetMs: number;
+        /**
+         * True for an event marked as a conversion or a signup, trial, subscription or payment.
+         */
+        isConversion: boolean;
+    }[];
+    /**
+     * active: the session may still be recording; closed: finished (4 h cap).
+     */
+    status: ("active" | "closed");
+    /**
+     * The first page recorded. Personal data: a URL can carry an email. Null when unknown.
+     */
+    entryUrl: (string | null);
+    /**
+     * In start order — the order to play them in.
+     */
+    segments: {
+        /**
+         * Page load id. Pass with seg to tracking_recordings_chunks_get.
+         */
+        pid: string;
+        /**
+         * Consent (re)start within the page load.
+         */
+        seg: number;
+        /**
+         * Page URL at the start of the segment. Personal data, like any URL.
+         */
+        url: string;
+        /**
+         * Start of the segment, ISO 8601 UTC.
+         */
+        startedAt: string;
+        /**
+         * Slices stored for the segment.
+         */
+        chunkCount: number;
+    }[];
+    /**
+     * Browser viewport at the start of the recording.
+     */
+    viewport: {
+        /**
+         * Viewport height, px.
+         */
+        h: (number | null);
+        /**
+         * Viewport width, px.
+         */
+        w: (number | null);
+    };
+    /**
+     * True when the same session has an event marked as a conversion or a signup, trial, subscription or payment.
+     */
+    converted: boolean;
+    /**
+     * The person behind the visitor, resolved now, so a later merge is honoured. Null for a visitor never tied to a profile.
+     */
+    profileId: (string | null);
+    /**
+     * When the recording started, ISO 8601 UTC, on the server clock.
+     */
+    startedAt: string;
+    /**
+     * utm_medium of the entry page. Null when untagged.
+     */
+    utmMedium: (string | null);
+    /**
+     * utm_source of the entry page. Null when untagged.
+     */
+    utmSource: (string | null);
+    /**
+     * Length of the recording in milliseconds.
+     */
+    durationMs: number;
+    /**
+     * Ad network of the click that opened the session: gclid for Google Ads, fbclid for Meta. Null for a non-ad arrival.
+     */
+    clickIdType: (string | null);
+    /**
+     * utm_campaign of the entry page. Null when untagged.
+     */
+    utmCampaign: (string | null);
+    /**
+     * Page loads (and consent re-starts) recorded in the session.
+     */
+    segmentCount: number;
+    /**
+     * Server clock minus browser clock, measured on the first slice. rrweb timestamps and `events[].at` are on the browser clock.
+     */
+    clockOffsetMs: number;
+    /**
+     * True when the session had more than 2000 events and the rest were left out.
+     */
+    eventsTruncated: boolean;
+}
+export interface TrackingRecordingsListInput {
+    /**
+     * End of the period, ISO 8601: recordings that started at or before it. Default: now.
+     */
+    to?: string;
+    /**
+     * Start of the period, ISO 8601 (e.g. 2026-10-01T00:00:00Z): recordings that started at or after it. Default: 30 days before `to`, the whole retention window.
+     */
+    from?: string;
+    /**
+     * Recordings per page, 1 to 100 (default 50).
+     */
+    limit?: number;
+    /**
+     * Continue a previous page: pass the nextCursor it returned. Omit to start from the newest recording.
+     */
+    cursor?: string;
+    /**
+     * true: only sessions with a conversion or a payment; false: only sessions without one. Omit for both.
+     */
+    converted?: boolean;
+    /**
+     * Only this person: every browser they were seen on, merged profiles included.
+     */
+    profileId?: string;
+    /**
+     * Only recordings whose entry page carried this utm_source, e.g. google.
+     */
+    utmSource?: string;
+    /**
+     * Only this visitor id (one browser).
+     */
+    anonymousId?: string;
+    /**
+     * Only recordings whose entry page carried this utm_campaign, e.g. spring.
+     */
+    utmCampaign?: string;
+    /**
+     * Only recordings at least this long, in milliseconds, e.g. 30000.
+     */
+    minDurationMs?: number;
+    /**
+     * Only recordings whose entry page URL contains this text, case-insensitively, e.g. /pricing.
+     */
+    entryUrlContains?: string;
+}
+export interface TrackingRecordingsListOutput {
+    /**
+     * Newest first.
+     */
+    items: {
+        /**
+         * The recording id. Pass it to tracking_recordings_get.
+         */
+        id: string;
+        /**
+         * desktop, mobile or tablet, from the browser. Null when unknown.
+         */
+        device: (string | null);
+        /**
+         * active: the session may still be recording; closed: finished (4 h cap).
+         */
+        status: ("active" | "closed");
+        /**
+         * The first page recorded. Personal data: a URL can carry an email. Null when unknown.
+         */
+        entryUrl: (string | null);
+        /**
+         * Browser viewport at the start of the recording.
+         */
+        viewport: {
+            /**
+             * Viewport height, px.
+             */
+            h: (number | null);
+            /**
+             * Viewport width, px.
+             */
+            w: (number | null);
+        };
+        /**
+         * True when the same session has an event marked as a conversion or a signup, trial, subscription or payment.
+         */
+        converted: boolean;
+        /**
+         * The person behind the visitor, resolved now, so a later merge is honoured. Null for a visitor never tied to a profile.
+         */
+        profileId: (string | null);
+        /**
+         * When the recording started, ISO 8601 UTC, on the server clock.
+         */
+        startedAt: string;
+        /**
+         * utm_medium of the entry page. Null when untagged.
+         */
+        utmMedium: (string | null);
+        /**
+         * utm_source of the entry page. Null when untagged.
+         */
+        utmSource: (string | null);
+        /**
+         * Length of the recording in milliseconds.
+         */
+        durationMs: number;
+        /**
+         * Ad network of the click that opened the session: gclid for Google Ads, fbclid for Meta. Null for a non-ad arrival.
+         */
+        clickIdType: (string | null);
+        /**
+         * utm_campaign of the entry page. Null when untagged.
+         */
+        utmCampaign: (string | null);
+        /**
+         * Page loads (and consent re-starts) recorded in the session.
+         */
+        segmentCount: number;
+    }[];
+    /**
+     * Pass back as cursor for the next page. Null on the last page.
+     */
+    nextCursor: (string | null);
+}
 export interface TrackingReportsAttributedJourneyInput {
     /**
      * Show only journey events at or before this instant (ISO). Omit for the whole history.
@@ -142853,11 +143542,11 @@ export interface TrackingReportsEventVolumeOutput {
          */
         cookielessShare: number;
         /**
-         * Events from visitors who declined; no cookie was written and no identifier sent.
+         * Events from visitors who declined or had not decided; the browser sent no identifier, though ingest may derive a one-day d: id.
          */
         cookielessEvents: number;
         /**
-         * Events carrying an anonymous id. A different cut that overlaps the three consent buckets — it is not the complement of `cookielessEvents` and must never be added to it.
+         * Events with a non-cookieless anonymous id (granted or no-banner). Cookieless d: ids are excluded. This quality slice overlaps the consent buckets and must not be added to them.
          */
         identifiedEvents: number;
         /**