@algolia/client-insights 5.0.0-alpha.99 → 5.0.0-beta.2

package/model/addedToCartObjectIDs.ts

@@ -10,7 +10,7 @@ import type { Value } from './value';
  */
 export type AddedToCartObjectIDs = {
   /**
-   * The name of the event, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
+   * Event name, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
    */
   eventName: string;
 
@@ -19,22 +19,22 @@ export type AddedToCartObjectIDs = {
   eventSubtype: AddToCartEvent;
 
   /**
-   * The name of an Algolia index.
+   * Index name (case-sensitive) to which the event\'s items belong.
    */
   index: string;
 
   /**
-   * The object IDs of the records that are part of the event.
+   * Object IDs of the records that are part of the event.
    */
   objectIDs: string[];
 
   /**
-   * An anonymous or pseudonymous user identifier.  > **Note**: Never include personally identifiable information in user tokens.
+   * Anonymous or pseudonymous user identifier.  Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   userToken: string;
 
   /**
-   * An identifier for authenticated users.  > **Note**: Never include personally identifiable information in user tokens.
+   * Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   authenticatedUserToken?: string;
 
@@ -49,7 +49,7 @@ export type AddedToCartObjectIDs = {
   objectData?: ObjectData[];
 
   /**
-   * The timestamp of the event in milliseconds in [Unix epoch time](https://wikipedia.org/wiki/Unix_time). By default, the Insights API uses the time it receives an event as its timestamp.
+   * Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.
    */
   timestamp?: number;
 

package/model/addedToCartObjectIDsAfterSearch.ts

@@ -10,7 +10,7 @@ import type { Value } from './value';
  */
 export type AddedToCartObjectIDsAfterSearch = {
   /**
-   * The name of the event, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
+   * Event name, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
    */
   eventName: string;
 
@@ -19,7 +19,7 @@ export type AddedToCartObjectIDsAfterSearch = {
   eventSubtype: AddToCartEvent;
 
   /**
-   * The name of an Algolia index.
+   * Index name (case-sensitive) to which the event\'s items belong.
    */
   index: string;
 
@@ -29,17 +29,17 @@ export type AddedToCartObjectIDsAfterSearch = {
   queryID: string;
 
   /**
-   * The object IDs of the records that are part of the event.
+   * Object IDs of the records that are part of the event.
    */
   objectIDs: string[];
 
   /**
-   * An anonymous or pseudonymous user identifier.  > **Note**: Never include personally identifiable information in user tokens.
+   * Anonymous or pseudonymous user identifier.  Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   userToken: string;
 
   /**
-   * An identifier for authenticated users.  > **Note**: Never include personally identifiable information in user tokens.
+   * Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   authenticatedUserToken?: string;
 
@@ -54,7 +54,7 @@ export type AddedToCartObjectIDsAfterSearch = {
   objectData?: ObjectDataAfterSearch[];
 
   /**
-   * The timestamp of the event in milliseconds in [Unix epoch time](https://wikipedia.org/wiki/Unix_time). By default, the Insights API uses the time it receives an event as its timestamp.
+   * Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.
    */
   timestamp?: number;
 

package/model/clickedFilters.ts

@@ -7,34 +7,34 @@ import type { ClickEvent } from './clickEvent';
  */
 export type ClickedFilters = {
   /**
-   * The name of the event, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
+   * Event name, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
    */
   eventName: string;
 
   eventType: ClickEvent;
 
   /**
-   * The name of an Algolia index.
+   * Index name (case-sensitive) to which the event\'s items belong.
    */
   index: string;
 
   /**
-   * Facet filters.  Each facet filter string must be URL-encoded, such as, `discount:10%25`.
+   * Applied facet filters.  Facet filters are `facet:value` pairs. Facet values must be URL-encoded, such as, `discount:10%25`.
    */
   filters: string[];
 
   /**
-   * An anonymous or pseudonymous user identifier.  > **Note**: Never include personally identifiable information in user tokens.
+   * Anonymous or pseudonymous user identifier.  Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   userToken: string;
 
   /**
-   * An identifier for authenticated users.  > **Note**: Never include personally identifiable information in user tokens.
+   * Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   authenticatedUserToken?: string;
 
   /**
-   * The timestamp of the event in milliseconds in [Unix epoch time](https://wikipedia.org/wiki/Unix_time). By default, the Insights API uses the time it receives an event as its timestamp.
+   * Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.
    */
   timestamp?: number;
 };

package/model/clickedObjectIDs.ts

@@ -7,34 +7,34 @@ import type { ClickEvent } from './clickEvent';
  */
 export type ClickedObjectIDs = {
   /**
-   * The name of the event, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
+   * Event name, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
    */
   eventName: string;
 
   eventType: ClickEvent;
 
   /**
-   * The name of an Algolia index.
+   * Index name (case-sensitive) to which the event\'s items belong.
    */
   index: string;
 
   /**
-   * The object IDs of the records that are part of the event.
+   * Object IDs of the records that are part of the event.
    */
   objectIDs: string[];
 
   /**
-   * An anonymous or pseudonymous user identifier.  > **Note**: Never include personally identifiable information in user tokens.
+   * Anonymous or pseudonymous user identifier.  Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   userToken: string;
 
   /**
-   * An identifier for authenticated users.  > **Note**: Never include personally identifiable information in user tokens.
+   * Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   authenticatedUserToken?: string;
 
   /**
-   * The timestamp of the event in milliseconds in [Unix epoch time](https://wikipedia.org/wiki/Unix_time). By default, the Insights API uses the time it receives an event as its timestamp.
+   * Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.
    */
   timestamp?: number;
 };

package/model/clickedObjectIDsAfterSearch.ts

@@ -7,24 +7,24 @@ import type { ClickEvent } from './clickEvent';
  */
 export type ClickedObjectIDsAfterSearch = {
   /**
-   * The name of the event, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
+   * Event name, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
    */
   eventName: string;
 
   eventType: ClickEvent;
 
   /**
-   * The name of an Algolia index.
+   * Index name (case-sensitive) to which the event\'s items belong.
    */
   index: string;
 
   /**
-   * The object IDs of the records that are part of the event.
+   * Object IDs of the records that are part of the event.
    */
   objectIDs: string[];
 
   /**
-   * The position of the clicked item the search results.  The first search result has a position of 1 (not 0). You must provide 1 `position` for each `objectID`.
+   * Position of the clicked item the search results.  You must provide 1 `position` for each `objectID`.
    */
   positions: number[];
 
@@ -34,17 +34,17 @@ export type ClickedObjectIDsAfterSearch = {
   queryID: string;
 
   /**
-   * An anonymous or pseudonymous user identifier.  > **Note**: Never include personally identifiable information in user tokens.
+   * Anonymous or pseudonymous user identifier.  Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   userToken: string;
 
   /**
-   * An identifier for authenticated users.  > **Note**: Never include personally identifiable information in user tokens.
+   * Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   authenticatedUserToken?: string;
 
   /**
-   * The timestamp of the event in milliseconds in [Unix epoch time](https://wikipedia.org/wiki/Unix_time). By default, the Insights API uses the time it receives an event as its timestamp.
+   * Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.
    */
   timestamp?: number;
 };

package/model/clientMethodProps.ts

@@ -69,7 +69,7 @@ export type CustomPutProps = {
  */
 export type DeleteUserTokenProps = {
   /**
-   * The user token for which to delete all associated events.
+   * User token for which to delete all associated events.
    */
   userToken: string;
 };

package/model/convertedFilters.ts

@@ -4,34 +4,34 @@ import type { ConversionEvent } from './conversionEvent';
 
 export type ConvertedFilters = {
   /**
-   * The name of the event, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
+   * Event name, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
    */
   eventName: string;
 
   eventType: ConversionEvent;
 
   /**
-   * The name of an Algolia index.
+   * Index name (case-sensitive) to which the event\'s items belong.
    */
   index: string;
 
   /**
-   * Facet filters.  Each facet filter string must be URL-encoded, such as, `discount:10%25`.
+   * Applied facet filters.  Facet filters are `facet:value` pairs. Facet values must be URL-encoded, such as, `discount:10%25`.
    */
   filters: string[];
 
   /**
-   * An anonymous or pseudonymous user identifier.  > **Note**: Never include personally identifiable information in user tokens.
+   * Anonymous or pseudonymous user identifier.  Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   userToken: string;
 
   /**
-   * An identifier for authenticated users.  > **Note**: Never include personally identifiable information in user tokens.
+   * Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   authenticatedUserToken?: string;
 
   /**
-   * The timestamp of the event in milliseconds in [Unix epoch time](https://wikipedia.org/wiki/Unix_time). By default, the Insights API uses the time it receives an event as its timestamp.
+   * Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.
    */
   timestamp?: number;
 };

package/model/convertedObjectIDs.ts

@@ -7,34 +7,34 @@ import type { ConversionEvent } from './conversionEvent';
  */
 export type ConvertedObjectIDs = {
   /**
-   * The name of the event, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
+   * Event name, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
    */
   eventName: string;
 
   eventType: ConversionEvent;
 
   /**
-   * The name of an Algolia index.
+   * Index name (case-sensitive) to which the event\'s items belong.
    */
   index: string;
 
   /**
-   * The object IDs of the records that are part of the event.
+   * Object IDs of the records that are part of the event.
    */
   objectIDs: string[];
 
   /**
-   * An anonymous or pseudonymous user identifier.  > **Note**: Never include personally identifiable information in user tokens.
+   * Anonymous or pseudonymous user identifier.  Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   userToken: string;
 
   /**
-   * An identifier for authenticated users.  > **Note**: Never include personally identifiable information in user tokens.
+   * Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   authenticatedUserToken?: string;
 
   /**
-   * The timestamp of the event in milliseconds in [Unix epoch time](https://wikipedia.org/wiki/Unix_time). By default, the Insights API uses the time it receives an event as its timestamp.
+   * Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.
    */
   timestamp?: number;
 };

package/model/convertedObjectIDsAfterSearch.ts

@@ -7,19 +7,19 @@ import type { ConversionEvent } from './conversionEvent';
  */
 export type ConvertedObjectIDsAfterSearch = {
   /**
-   * The name of the event, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
+   * Event name, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
    */
   eventName: string;
 
   eventType: ConversionEvent;
 
   /**
-   * The name of an Algolia index.
+   * Index name (case-sensitive) to which the event\'s items belong.
    */
   index: string;
 
   /**
-   * The object IDs of the records that are part of the event.
+   * Object IDs of the records that are part of the event.
    */
   objectIDs: string[];
 
@@ -29,17 +29,17 @@ export type ConvertedObjectIDsAfterSearch = {
   queryID: string;
 
   /**
-   * An anonymous or pseudonymous user identifier.  > **Note**: Never include personally identifiable information in user tokens.
+   * Anonymous or pseudonymous user identifier.  Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   userToken: string;
 
   /**
-   * An identifier for authenticated users.  > **Note**: Never include personally identifiable information in user tokens.
+   * Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   authenticatedUserToken?: string;
 
   /**
-   * The timestamp of the event in milliseconds in [Unix epoch time](https://wikipedia.org/wiki/Unix_time). By default, the Insights API uses the time it receives an event as its timestamp.
+   * Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.
    */
   timestamp?: number;
 };

package/model/discount.ts

@@ -1,6 +1,6 @@
 // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
 
 /**
- * The absolute value of the discount for this product, in units of `currency`.
+ * Absolute value of the discount for this product, in units of `currency`.
  */
 export type Discount = number | string;

package/model/insightsEvents.ts

@@ -4,7 +4,7 @@ import type { EventsItems } from './eventsItems';
 
 export type InsightsEvents = {
   /**
-   * List of click and conversion events.  An event is an object representing a user interaction. Events have attributes that describe the interaction, such as an event name, a type, or a user token.  **All** events must be valid, otherwise the API returns an error.
+   * Click and conversion events.  **All** events must be valid, otherwise the API returns an error.
    */
   events: EventsItems[];
 };

package/model/objectData.ts

@@ -7,7 +7,7 @@ export type ObjectData = {
   price?: Price;
 
   /**
-   * The quantity of a product that has been purchased or added to the cart. The total value of a purchase is the sum of `quantity` multiplied with the `price` for each purchased item.
+   * Quantity of a product that has been purchased or added to the cart. The total purchase value is the sum of `quantity` multiplied with the `price` for each purchased item.
    */
   quantity?: number;
 

package/model/objectDataAfterSearch.ts

@@ -12,7 +12,7 @@ export type ObjectDataAfterSearch = {
   price?: Price;
 
   /**
-   * The quantity of a product that has been purchased or added to the cart. The total value of a purchase is the sum of `quantity` multiplied with the `price` for each purchased item.
+   * Quantity of a product that has been purchased or added to the cart. The total purchase value is the sum of `quantity` multiplied with the `price` for each purchased item.
    */
   quantity?: number;
 

package/model/price.ts

@@ -1,6 +1,6 @@
 // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
 
 /**
- * The total price of a product, including any discounts, in units of `currency`.
+ * Total price of a product, including any discounts, in units of `currency`.
  */
 export type Price = number | string;

package/model/purchasedObjectIDs.ts

@@ -10,7 +10,7 @@ import type { Value } from './value';
  */
 export type PurchasedObjectIDs = {
   /**
-   * The name of the event, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
+   * Event name, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
    */
   eventName: string;
 
@@ -19,22 +19,22 @@ export type PurchasedObjectIDs = {
   eventSubtype: PurchaseEvent;
 
   /**
-   * The name of an Algolia index.
+   * Index name (case-sensitive) to which the event\'s items belong.
    */
   index: string;
 
   /**
-   * The object IDs of the records that are part of the event.
+   * Object IDs of the records that are part of the event.
    */
   objectIDs: string[];
 
   /**
-   * An anonymous or pseudonymous user identifier.  > **Note**: Never include personally identifiable information in user tokens.
+   * Anonymous or pseudonymous user identifier.  Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   userToken: string;
 
   /**
-   * An identifier for authenticated users.  > **Note**: Never include personally identifiable information in user tokens.
+   * Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   authenticatedUserToken?: string;
 
@@ -49,7 +49,7 @@ export type PurchasedObjectIDs = {
   objectData?: ObjectData[];
 
   /**
-   * The timestamp of the event in milliseconds in [Unix epoch time](https://wikipedia.org/wiki/Unix_time). By default, the Insights API uses the time it receives an event as its timestamp.
+   * Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.
    */
   timestamp?: number;
 

package/model/purchasedObjectIDsAfterSearch.ts

@@ -10,7 +10,7 @@ import type { Value } from './value';
  */
 export type PurchasedObjectIDsAfterSearch = {
   /**
-   * The name of the event, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
+   * Event name, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
    */
   eventName: string;
 
@@ -19,22 +19,22 @@ export type PurchasedObjectIDsAfterSearch = {
   eventSubtype: PurchaseEvent;
 
   /**
-   * The name of an Algolia index.
+   * Index name (case-sensitive) to which the event\'s items belong.
    */
   index: string;
 
   /**
-   * The object IDs of the records that are part of the event.
+   * Object IDs of the records that are part of the event.
    */
   objectIDs: string[];
 
   /**
-   * An anonymous or pseudonymous user identifier.  > **Note**: Never include personally identifiable information in user tokens.
+   * Anonymous or pseudonymous user identifier.  Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   userToken: string;
 
   /**
-   * An identifier for authenticated users.  > **Note**: Never include personally identifiable information in user tokens.
+   * Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   authenticatedUserToken?: string;
 
@@ -46,10 +46,10 @@ export type PurchasedObjectIDsAfterSearch = {
   /**
    * Extra information about the records involved in a purchase or add-to-cart events.  If provided, it must be the same length as `objectIDs`.
    */
-  objectData?: ObjectDataAfterSearch[];
+  objectData: ObjectDataAfterSearch[];
 
   /**
-   * The timestamp of the event in milliseconds in [Unix epoch time](https://wikipedia.org/wiki/Unix_time). By default, the Insights API uses the time it receives an event as its timestamp.
+   * Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.
    */
   timestamp?: number;
 

package/model/viewedFilters.ts

@@ -7,34 +7,34 @@ import type { ViewEvent } from './viewEvent';
  */
 export type ViewedFilters = {
   /**
-   * The name of the event, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
+   * Event name, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
    */
   eventName: string;
 
   eventType: ViewEvent;
 
   /**
-   * The name of an Algolia index.
+   * Index name (case-sensitive) to which the event\'s items belong.
    */
   index: string;
 
   /**
-   * Facet filters.  Each facet filter string must be URL-encoded, such as, `discount:10%25`.
+   * Applied facet filters.  Facet filters are `facet:value` pairs. Facet values must be URL-encoded, such as, `discount:10%25`.
    */
   filters: string[];
 
   /**
-   * An anonymous or pseudonymous user identifier.  > **Note**: Never include personally identifiable information in user tokens.
+   * Anonymous or pseudonymous user identifier.  Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   userToken: string;
 
   /**
-   * An identifier for authenticated users.  > **Note**: Never include personally identifiable information in user tokens.
+   * Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   authenticatedUserToken?: string;
 
   /**
-   * The timestamp of the event in milliseconds in [Unix epoch time](https://wikipedia.org/wiki/Unix_time). By default, the Insights API uses the time it receives an event as its timestamp.
+   * Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.
    */
   timestamp?: number;
 };

package/model/viewedObjectIDs.ts

@@ -7,34 +7,34 @@ import type { ViewEvent } from './viewEvent';
  */
 export type ViewedObjectIDs = {
   /**
-   * The name of the event, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
+   * Event name, up to 64 ASCII characters.  Consider naming events consistently—for example, by adopting Segment\'s [object-action](https://segment.com/academy/collecting-data/naming-conventions-for-clean-data/#the-object-action-framework) framework.
    */
   eventName: string;
 
   eventType: ViewEvent;
 
   /**
-   * The name of an Algolia index.
+   * Index name (case-sensitive) to which the event\'s items belong.
    */
   index: string;
 
   /**
-   * The object IDs of the records that are part of the event.
+   * Object IDs of the records that are part of the event.
    */
   objectIDs: string[];
 
   /**
-   * An anonymous or pseudonymous user identifier.  > **Note**: Never include personally identifiable information in user tokens.
+   * Anonymous or pseudonymous user identifier.  Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   userToken: string;
 
   /**
-   * An identifier for authenticated users.  > **Note**: Never include personally identifiable information in user tokens.
+   * Identifier for authenticated users.  When the user signs in, you can get an identifier from your system and send it as `authenticatedUserToken`. This lets you keep using the `userToken` from before the user signed in, while providing a reliable way to identify users across sessions. Don\'t use personally identifiable information in user tokens. For more information, see [User token](https://www.algolia.com/doc/guides/sending-events/concepts/usertoken/).
    */
   authenticatedUserToken?: string;
 
   /**
-   * The timestamp of the event in milliseconds in [Unix epoch time](https://wikipedia.org/wiki/Unix_time). By default, the Insights API uses the time it receives an event as its timestamp.
+   * Timestamp of the event, measured in milliseconds since the Unix epoch. By default, the Insights API uses the time it receives an event as its timestamp.
    */
   timestamp?: number;
 };