picked 0.0.103 → 0.0.104-next.2

package/docs/reference/management-api/schema/analytics-session.md

@@ -119,6 +119,22 @@ enum AnalyticsSessionsReportKind {
 }
 ```
 
+### `AnalyticsSessionSearchSuggestion`
+
+```graphql
+"""
+A session search suggested for what was typed into a sessions search box.
+"""
+type AnalyticsSessionSearchSuggestion {
+  """The session search query."""
+  query: String!
+  """What the query finds, in plain English."""
+  description: String!
+  """How many sessions the query keeps within the window."""
+  count: Int!
+}
+```
+
 ### `AnalyticsSessionConnection`
 
 ```graphql
@@ -199,7 +215,9 @@ type AnalyticsSessionSummary {
   Where the visitor came from. Null when the landing page had no referrer.
   """
   referrer: AnalyticsReferrer
-  """The UTM campaign of the landing page's URL. Null when it carried none."""
+  """
+  The UTM campaign of the landing page's URL. Null when none of its fields has a value.
+  """
   campaign: AnalyticsCampaign
   """The visitor's device. Null when it is unknown."""
   device: AnalyticsDevice
@@ -210,6 +228,10 @@ type AnalyticsSessionSummary {
   """
   gaid: String
   """
+  The Google Ads click ID, the `gclid` of the landing page's URL. Null when it carried none.
+  """
+  gclid: String
+  """
   The visitor's Picked ID, from the first event to carry one. Null when none did.
   """
   visitorId: String
@@ -243,6 +265,14 @@ type AnalyticsCampaign {
   medium: String
   """`utm_campaign`."""
   name: String
+  """
+  `utm_term`. Null as well when the URL carried neither `utm_source` nor `utm_medium`.
+  """
+  term: String
+  """
+  `utm_content`. Null as well when the URL carried neither `utm_source` nor `utm_medium`.
+  """
+  content: String
 }
 ```
 

package/docs/reference/management-api/schema/lead.md

@@ -160,6 +160,23 @@ type LeadResponse {
 }
 ```
 
+### `LeadSearchSuggestion`
+
+```graphql
+"""A leads search suggested for what was typed into a leads search box."""
+type LeadSearchSuggestion {
+  """The leads search query."""
+  query: String!
+  """What the query finds, in plain English."""
+  description: String!
+  """
+  How many leads the query matches within the window. Null when a `session.` clause leaves the
+  query without a total.
+  """
+  count: Int
+}
+```
+
 ### `LeadConnection`
 
 ```graphql

package/docs/reference/management-api/schema/project.md

@@ -252,6 +252,23 @@ type Project {
   """
   leadReports: [LeadReport!]! @auth
   """
+  Suggests up to four leads searches for what was typed into a leads search box, each counted within
+  the window. Requires the `lead-search-suggestions` feature flag.
+  Scope: `ORGANIZATION_LEADS_READ`.
+  """
+  leadSearchSuggestions(
+    """What was typed, at most 200 characters."""
+    text: String!
+    """
+    The window, in the project's time zone, each suggestion is counted within.
+    """
+    window: MetricWindowInput
+    """
+    How a session's leads count. `SESSION` counts each session's newest matching lead once.
+    """
+    collapse: LeadCollapse = NONE
+  ): [LeadSearchSuggestion!]! @auth
+  """
   The Sessions reports on the project, in order: how its sessions arrive, the journeys they take,
   and which of them convert. Each is a signed embed URL locked to the project, with an editable
   date range.
@@ -292,16 +309,35 @@ type Project {
     containing it, or any value, for `gaid`, `utm_source`, `utm_medium`,
     `utm_campaign`, `utm_term`, `utm_content`, `page_url`, `page_origin`,
     `page_pathname`, `page_query`, `landing_page_url`, `landing_page_origin`,
-    `landing_page_pathname` or `landing_page_query`, each also written under
-    `session.`; `lead:*` asks that the session captured a lead. A leading `-`
-    negates a clause; clauses combine with AND, or with OR when the query says
-    so, never both; at most ten.
+    `landing_page_pathname` or `landing_page_query`; `location_country`,
+    `location_country_code`, `location_region` and `location_city` ask the same
+    of the session's location, equal in any case; each field is also written under `session.`; `lead:*` asks that the
+    session captured a lead. A leading `-` negates a clause; clauses combine
+    with AND, or with OR when the query says so, never both; at most ten.
     """
     query: String
     """Whether to include bots."""
     includeBots: Boolean = false
   ): AnalyticsSessionConnection! @auth
   """
+  Suggests up to four session searches for what was typed into a sessions search box, each with
+  how many sessions it keeps within the window. Requires the `lead-search-suggestions` feature flag.
+  Scope: `ORGANIZATION_LEADS_READ`.
+  """
+  analyticsSessionSearchSuggestions(
+    """What was typed, at most 200 characters."""
+    text: String!
+    """
+    The window, in the project's time zone, each suggestion is counted within. Defaults to today
+    and the six days before it.
+    """
+    window: MetricWindowInput
+    """
+    Whether each count keeps the sessions of bots, as `analyticsSessions` does.
+    """
+    includeBots: Boolean = false
+  ): [AnalyticsSessionSearchSuggestion!]! @auth
+  """
   The saved views of one of the project's lists, oldest first.
   Scope: `ORGANIZATION_PROJECTS_READ`.
   """

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "picked",
   "description": "The Picked SDK front door: the client, the picked.config helpers, and the picked CLI in one install",
-  "version": "0.0.103",
+  "version": "0.0.104-next.2",
   "bin": {
     "picked": "dist/esm/bin.js"
   },
   "dependencies": {
-    "@picked/cli": "0.0.103",
-    "@picked/config": "0.0.103"
+    "@picked/cli": "0.0.104-next.2",
+    "@picked/config": "0.0.104-next.2"
   },
   "devDependencies": {
     "@picked/client": "workspace:*",
@@ -64,7 +64,7 @@
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
   "peerDependencies": {
-    "@picked/client": "0.0.103"
+    "@picked/client": "0.0.104-next.2"
   },
   "private": false,
   "publishConfig": {