@lessly/sdk-app 105.4.0 → 105.6.0

package/src/gen/types.gen.ts

@@ -30,6 +30,12 @@ propertiesColumn: (string | null)
 }[]
 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 {
@@ -111681,378 +111687,6 @@ 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)
@@ -135113,6 +134747,175 @@ lookbackDays: number
 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 {
 
 }
@@ -136187,6 +135990,10 @@ limit?: number
  * 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.
  */

package/dist/_types/gen/playground/connect.gen.d.ts

@@ -1,3 +0,0 @@
-import type { LesslyStream, LesslyStreamOpener } from '../../runtime/types.js';
-import type { PlaygroundWsEchoInput } from '../types.gen.js';
-export declare const playgroundWsEchoConnect: (sdk: LesslyStreamOpener, input: PlaygroundWsEchoInput) => LesslyStream;

package/dist/_types/gen/playground/index.d.ts

@@ -1,3 +0,0 @@
-export * from './queryOptions.gen.js';
-export * from './connect.gen.js';
-export type { PlaygroundAnalyticsOverviewInput, PlaygroundAnalyticsOverviewOutput, PlaygroundBillingEntitlementsInput, PlaygroundBillingEntitlementsOutput, PlaygroundBillingRecordUsageInput, PlaygroundBillingRecordUsageOutput, PlaygroundClickupCreateTaskInput, PlaygroundClickupCreateTaskOutput, PlaygroundClickupGetLastWebhookInput, PlaygroundClickupGetLastWebhookOutput, PlaygroundClickupGetOverviewInput, PlaygroundClickupGetOverviewOutput, PlaygroundEchoPingInput, PlaygroundEchoPingOutput, PlaygroundGdriveGetLastChangeInput, PlaygroundGdriveGetLastChangeOutput, PlaygroundGdriveReadFileInput, PlaygroundGdriveReadFileOutput, PlaygroundGoogleadsReadCustomerInput, PlaygroundGoogleadsReadCustomerOutput, PlaygroundLifecycleGetStateInput, PlaygroundLifecycleGetStateOutput, PlaygroundLifecycleListEventsInput, PlaygroundLifecycleListEventsOutput, PlaygroundWebhookGetLastInput, PlaygroundWebhookGetLastOutput, PlaygroundWorkflowEchoInput, PlaygroundWorkflowEchoListInput, PlaygroundWorkflowEchoListOutput, PlaygroundWorkflowEchoOutput, PlaygroundWorkflowPingInput, PlaygroundWorkflowPingOutput, PlaygroundWorkflowSubjectsListInput, PlaygroundWorkflowSubjectsListOutput, PlaygroundWsEchoInput } from '../types.gen.js';

package/dist/_types/gen/playground/queryOptions.gen.d.ts

@@ -1,70 +0,0 @@
-import type { GeneratedClient } from '../client.gen.js';
-import type { PlaygroundAnalyticsOverviewInput, PlaygroundAnalyticsOverviewOutput, PlaygroundBillingEntitlementsInput, PlaygroundBillingEntitlementsOutput, PlaygroundBillingRecordUsageInput, PlaygroundClickupCreateTaskInput, PlaygroundClickupGetLastWebhookInput, PlaygroundClickupGetLastWebhookOutput, PlaygroundClickupGetOverviewInput, PlaygroundClickupGetOverviewOutput, PlaygroundEchoPingInput, PlaygroundEchoPingOutput, PlaygroundGdriveGetLastChangeInput, PlaygroundGdriveGetLastChangeOutput, PlaygroundGdriveReadFileInput, PlaygroundGdriveReadFileOutput, PlaygroundGoogleadsReadCustomerInput, PlaygroundGoogleadsReadCustomerOutput, PlaygroundLifecycleGetStateInput, PlaygroundLifecycleGetStateOutput, PlaygroundLifecycleListEventsInput, PlaygroundLifecycleListEventsOutput, PlaygroundWebhookGetLastInput, PlaygroundWebhookGetLastOutput, PlaygroundWorkflowEchoInput, PlaygroundWorkflowEchoListInput, PlaygroundWorkflowEchoListOutput, PlaygroundWorkflowPingInput, PlaygroundWorkflowSubjectsListInput, PlaygroundWorkflowSubjectsListOutput } from '../types.gen.js';
-export declare const playgroundAnalyticsOverviewQueryOptions: (sdk: GeneratedClient, input: PlaygroundAnalyticsOverviewInput) => {
-    queryKey: readonly ["playground", "analytics", "overview", PlaygroundAnalyticsOverviewInput];
-    queryFn: () => Promise<PlaygroundAnalyticsOverviewOutput>;
-};
-export declare const playgroundBillingEntitlementsQueryOptions: (sdk: GeneratedClient, input: PlaygroundBillingEntitlementsInput) => {
-    queryKey: readonly ["playground", "billing", "entitlements", PlaygroundBillingEntitlementsInput];
-    queryFn: () => Promise<PlaygroundBillingEntitlementsOutput>;
-};
-export declare const playgroundBillingRecordUsageMutationOptions: (sdk: GeneratedClient) => {
-    mutationKey: string[];
-    mutationFn: (input: PlaygroundBillingRecordUsageInput) => Promise<import(".").PlaygroundBillingRecordUsageOutput>;
-};
-export declare const playgroundClickupCreateTaskMutationOptions: (sdk: GeneratedClient) => {
-    mutationKey: string[];
-    mutationFn: (input: PlaygroundClickupCreateTaskInput) => Promise<import(".").PlaygroundClickupCreateTaskOutput>;
-};
-export declare const playgroundClickupGetLastWebhookQueryOptions: (sdk: GeneratedClient, input: PlaygroundClickupGetLastWebhookInput) => {
-    queryKey: readonly ["playground", "clickup", "get-last-webhook", PlaygroundClickupGetLastWebhookInput];
-    queryFn: () => Promise<PlaygroundClickupGetLastWebhookOutput>;
-};
-export declare const playgroundClickupGetOverviewQueryOptions: (sdk: GeneratedClient, input: PlaygroundClickupGetOverviewInput) => {
-    queryKey: readonly ["playground", "clickup", "get-overview", PlaygroundClickupGetOverviewInput];
-    queryFn: () => Promise<PlaygroundClickupGetOverviewOutput>;
-};
-export declare const playgroundEchoPingQueryOptions: (sdk: GeneratedClient, input: PlaygroundEchoPingInput) => {
-    queryKey: readonly ["playground", "echo", "ping", PlaygroundEchoPingInput];
-    queryFn: () => Promise<PlaygroundEchoPingOutput>;
-};
-export declare const playgroundGdriveGetLastChangeQueryOptions: (sdk: GeneratedClient, input: PlaygroundGdriveGetLastChangeInput) => {
-    queryKey: readonly ["playground", "gdrive", "get-last-change", PlaygroundGdriveGetLastChangeInput];
-    queryFn: () => Promise<PlaygroundGdriveGetLastChangeOutput>;
-};
-export declare const playgroundGdriveReadFileQueryOptions: (sdk: GeneratedClient, input: PlaygroundGdriveReadFileInput) => {
-    queryKey: readonly ["playground", "gdrive", "read-file", PlaygroundGdriveReadFileInput];
-    queryFn: () => Promise<PlaygroundGdriveReadFileOutput>;
-};
-export declare const playgroundGoogleadsReadCustomerQueryOptions: (sdk: GeneratedClient, input: PlaygroundGoogleadsReadCustomerInput) => {
-    queryKey: readonly ["playground", "googleads", "read-customer", PlaygroundGoogleadsReadCustomerInput];
-    queryFn: () => Promise<PlaygroundGoogleadsReadCustomerOutput>;
-};
-export declare const playgroundLifecycleGetStateQueryOptions: (sdk: GeneratedClient, input: PlaygroundLifecycleGetStateInput) => {
-    queryKey: readonly ["playground", "lifecycle", "get-state", PlaygroundLifecycleGetStateInput];
-    queryFn: () => Promise<PlaygroundLifecycleGetStateOutput>;
-};
-export declare const playgroundLifecycleListEventsQueryOptions: (sdk: GeneratedClient, input: PlaygroundLifecycleListEventsInput) => {
-    queryKey: readonly ["playground", "lifecycle", "list-events", PlaygroundLifecycleListEventsInput];
-    queryFn: () => Promise<PlaygroundLifecycleListEventsOutput>;
-};
-export declare const playgroundWebhookGetLastQueryOptions: (sdk: GeneratedClient, input: PlaygroundWebhookGetLastInput) => {
-    queryKey: readonly ["playground", "webhook", "get-last", PlaygroundWebhookGetLastInput];
-    queryFn: () => Promise<PlaygroundWebhookGetLastOutput>;
-};
-export declare const playgroundWorkflowEchoMutationOptions: (sdk: GeneratedClient) => {
-    mutationKey: string[];
-    mutationFn: (input: PlaygroundWorkflowEchoInput) => Promise<import(".").PlaygroundWorkflowEchoOutput>;
-};
-export declare const playgroundWorkflowEchoListQueryOptions: (sdk: GeneratedClient, input: PlaygroundWorkflowEchoListInput) => {
-    queryKey: readonly ["playground", "workflow", "echo-list", PlaygroundWorkflowEchoListInput];
-    queryFn: () => Promise<PlaygroundWorkflowEchoListOutput>;
-};
-export declare const playgroundWorkflowPingMutationOptions: (sdk: GeneratedClient) => {
-    mutationKey: string[];
-    mutationFn: (input: PlaygroundWorkflowPingInput) => Promise<import(".").PlaygroundWorkflowPingOutput>;
-};
-export declare const playgroundWorkflowSubjectsListQueryOptions: (sdk: GeneratedClient, input: PlaygroundWorkflowSubjectsListInput) => {
-    queryKey: readonly ["playground", "workflow", "subjects-list", PlaygroundWorkflowSubjectsListInput];
-    queryFn: () => Promise<PlaygroundWorkflowSubjectsListOutput>;
-};