build(codegen): updating SDK

Author: ct-sdks[bot]

packages/platform-sdk/src/generated/client/product-projections/by-project-key-in-store-key-by-store-key-product-projections-by-id-request-builder.ts

@@ -21,13 +21,22 @@ export class ByProjectKeyInStoreKeyByStoreKeyProductProjectionsByIDRequestBuilde
     }
   ) {}
   /**
-   *	Gets the current or staged representation of a [Product](ctp:api:type:Product) by its ID in the specified [Store](ctp:api:type:Store).
+   *	Retrieves the [projected](/../api/projects/productProjections#projection-dimensions) representation of a [Product](ctp:api:type:Product) by its ID in the specified [Store](ctp:api:type:Store).
+   *
    *	If the Store has defined some languages, countries, distribution, supply Channels, and/or Product Selection,
    *	they are used for projections based on [locale](ctp:api:type:ProductProjectionLocales), [price](ctp:api:type:ProductProjectionPrices),
    *	and [inventory](ctp:api:type:ProductProjectionInventoryEntries).
    *	If [ProductSelection](ctp:api:type:ProductSelection) is used, it affects the [availability of the Product](/api/project-configuration-overview#products-available-in-store) in the specified Store.
-   *	If a [ProductTailoring](ctp:api:type:ProductTailoring) exists for the Product with the given `id` and the given Store, this endpoint returns the ProductProjection with tailored data.
-   *	When used with an API Client that has the `view_published_products:{projectKey}` scope, this endpoint only returns published (current) Product Projections.
+   *	If a [ProductTailoring](ctp:api:type:ProductTailoring) exists for the Product with the given `key` and the given Store, this endpoint returns the ProductProjection with tailored data.
+   *
+   *	By default, this endpoint returns the `current` representation of Products where the `published` flag is `true`.
+   *	If a Product is unpublished (`published=false`), the endpoint returns a [Not Found](/../api/errors#404-not-found) error.
+   *
+   *	Required access scopes:
+   *
+   *	- To retrieve the current representation of published Products (published data), the `view_published_products:{projectKey}` scope is required.
+   *
+   *	- To retrieve the staged representation of Products (draft data) or access unpublished Products, the API Client must have the `view_products:{projectKey}` scope.
    *
    */
   public get(methodArgs?: {

packages/platform-sdk/src/generated/client/product-projections/by-project-key-in-store-key-by-store-key-product-projections-key-by-key-request-builder.ts

@@ -21,13 +21,22 @@ export class ByProjectKeyInStoreKeyByStoreKeyProductProjectionsKeyByKeyRequestBu
     }
   ) {}
   /**
-   *	Gets the current or staged representation of a [Product](ctp:api:type:Product) by its key in the specified [Store](ctp:api:type:Store).
+   *	Retrieves the [projected](/../api/projects/productProjections#projection-dimensions) representation of a [Product](ctp:api:type:Product) by its Key in the specified [Store](ctp:api:type:Store).
+   *
    *	If the Store has defined some languages, countries, distribution, supply Channels, and/or Product Selection,
    *	they are used for projections based on [locale](ctp:api:type:ProductProjectionLocales), [price](ctp:api:type:ProductProjectionPrices),
    *	and [inventory](ctp:api:type:ProductProjectionInventoryEntries).
    *	If [ProductSelection](ctp:api:type:ProductSelection) is used, it affects the [availability of the Product](/api/project-configuration-overview#products-available-in-store) in the specified Store.
    *	If a [ProductTailoring](ctp:api:type:ProductTailoring) exists for the Product with the given `key` and the given Store, this endpoint returns the ProductProjection with tailored data.
-   *	When used with an API Client that has the `view_published_products:{projectKey}` scope, this endpoint only returns published (current) Product Projections.
+   *
+   *	By default, this endpoint returns the `current` representation of Products where the `published` flag is `true`.
+   *	If a Product is unpublished (`published=false`), the endpoint returns a [Not Found](/../api/errors#404-not-found) error.
+   *
+   *	Required access scopes:
+   *
+   *	- To retrieve the current representation of published Products (published data), the `view_published_products:{projectKey}` scope is required.
+   *
+   *	- To retrieve the staged representation of Products (draft data) or access unpublished Products, the API Client must have the `view_products:{projectKey}` scope.
    *
    */
   public get(methodArgs?: {

packages/platform-sdk/src/generated/client/product-projections/by-project-key-product-projections-by-id-request-builder.ts

@@ -20,7 +20,16 @@ export class ByProjectKeyProductProjectionsByIDRequestBuilder {
     }
   ) {}
   /**
-   *	Gets the current or staged representation of a [Product](ctp:api:type:Product) by its ID. When used with an API Client that has the `view_published_products:{projectKey}` scope, this endpoint only returns published (current) Product Projections.
+   *	Retrieves the [projected](/../api/projects/productProjections#projection-dimensions) representation of a [Product](ctp:api:type:Product) by its ID.
+   *
+   *	By default, this endpoint returns the `current` representation of Products where the `published` flag is `true`.
+   *	If a Product is unpublished (`published=false`), the endpoint returns a [Not Found](/../api/errors#404-not-found) error.
+   *
+   *	Required access scopes:
+   *
+   *	- To retrieve the current representation of published Products (published data), the `view_published_products:{projectKey}` scope is required.
+   *
+   *	- To retrieve the staged representation of Products (draft data) or access unpublished Products, the API Client must have the `view_products:{projectKey}` scope.
    *
    */
   public get(methodArgs?: {

packages/platform-sdk/src/generated/client/product-projections/by-project-key-product-projections-key-by-key-request-builder.ts

@@ -20,9 +20,16 @@ export class ByProjectKeyProductProjectionsKeyByKeyRequestBuilder {
     }
   ) {}
   /**
-   *	Gets the current or staged representation of a [Product](ctp:api:type:Product) found by Key.
-   *	When used with an API Client that has the `view_published_products:{projectKey}` scope,
-   *	this endpoint only returns published (current) Product Projections.
+   *	Retrieves the [projected](/../api/projects/productProjections#projection-dimensions) representation of a [Product](ctp:api:type:Product) by its Key.
+   *
+   *	By default, this endpoint returns the `current` representation of Products where the `published` flag is `true`.
+   *	If a Product is unpublished (`published=false`), the endpoint returns a [Not Found](/../api/errors#404-not-found) error.
+   *
+   *	Required access scopes:
+   *
+   *	- To retrieve the current representation of published Products (published data), the `view_published_products:{projectKey}` scope is required.
+   *
+   *	- To retrieve the staged representation of Products (draft data) or access unpublished Products, the API Client must have the `view_products:{projectKey}` scope.
    *
    */
   public get(methodArgs?: {

packages/platform-sdk/src/generated/client/product-projections/by-project-key-product-projections-request-builder.ts

@@ -69,9 +69,16 @@ export class ByProjectKeyProductProjectionsRequestBuilder {
   }
 
   /**
-   *	Use the Product Projections query endpoint to get the current or staged representations of Products.
-   *	When used with an API Client that has the `view_published_products:{projectKey}` scope,
-   *	this endpoint only returns published (current) Product Projections.
+   *	Retrieves the [projected](/../api/projects/productProjections#projection-dimensions) representation of [Products](ctp:api:type:Product) by [query predicates](/../api/predicates/query).
+   *
+   *	By default, this endpoint returns the `current` representation of Products where the `published` flag is `true`.
+   *	If a Product is unpublished (`published=false`), the endpoint returns a [Not Found](/../api/errors#404-not-found) error.
+   *
+   *	Required access scopes:
+   *
+   *	- To retrieve the current representation of published Products (published data), the `view_published_products:{projectKey}` scope is required.
+   *
+   *	- To retrieve the staged representation of Products (draft data) or access unpublished Products, the API Client must have the `view_products:{projectKey}` scope.
    *
    */
   public get(methodArgs?: {

packages/platform-sdk/src/generated/models/product-tailoring.ts

@@ -88,13 +88,13 @@ export interface ProductTailoring extends BaseResource {
    */
   readonly published: boolean
   /**
-   *	Current (published) data of the ProductTailoring.
+   *	Current data of the ProductTailoring returned in the [Product Projection](/projects/productProjections) response when the ProductTailoring is published.
    *
    *
    */
   readonly current: ProductTailoringData
   /**
-   *	Staged (unpublished) data of the ProductTailoring.
+   *	Staged data of the ProductTailoring. This data is not returned in the Product Projection response by default.
    *
    *
    */

packages/platform-sdk/src/generated/models/product.ts

@@ -295,7 +295,7 @@ export interface Product extends BaseResource {
  */
 export interface ProductCatalogData {
   /**
-   *	`true` if the Product is published.
+   *	If `true`, the `current` representation of the Product is retrievable in the [Product Projection](/projects/productProjections) endpoints and indexed for [Product Search](/../api/projects/product-search).
    *
    *
    */
@@ -498,7 +498,9 @@ export interface ProductDraft {
    */
   readonly state?: StateResourceIdentifier
   /**
-   *	If `true`, the Product is published immediately to the current projection.
+   *	If `true`, the platform sets the `published` flag on the resulting [ProductCatalogData](ctp:api:type:ProductCatalogData) to `true`.
+   *	This makes the current representation retrievable in [Product Projection](/projects/productProjections) endpoints and indexes it for [Product Search](/../api/projects/product-search).
+   *	You can also set this flag later using the [Publish](/projects/products#publish) update action.
    *
    *
    */
@@ -1615,7 +1617,9 @@ export interface ProductMoveImageToPositionAction extends IProductUpdateAction {
   readonly staged?: boolean
 }
 /**
- *	Publishes product data from the Product's staged projection to its current projection.
+ *	Copies the product data from the Product's staged representation to its current representation and sets the `published` flag on the resulting [ProductCatalogData](ctp:api:type:ProductCatalogData) to `true`.
+ *	This makes the current representation retrievable in [Product Projection](/projects/productProjections) endpoints and indexes it for [Product Search](/../api/projects/product-search).
+ *
  *	Produces the [ProductPublished](ctp:api:type:ProductPublishedMessage) Message.
  */
 export interface ProductPublishAction extends IProductUpdateAction {
@@ -2552,7 +2556,11 @@ export interface ProductTransitionStateAction extends IProductUpdateAction {
   readonly force?: boolean
 }
 /**
- *	Removes the current [projection](/../api/projects/productProjections#current--staged) of the Product. The staged projection is unaffected. To retrieve unpublished Products, the `staged` parameter must be set to `false` when [querying](ctp:api:endpoint:/{projectKey}/product-projections:GET)/[searching](/projects/product-projection-search#product-projection-search) Product Projections. Produces the [ProductUnpublished](ctp:api:type:ProductUnpublishedMessage) Message.
+ *	Sets the `published` flag on the [ProductCatalogData](ctp:api:type:ProductCatalogData) to `false`.
+ *	This makes the [current](/../api/projects/productProjections#current--staged) representation of a Product unavailable in [Product Projection](/projects/productProjections) endpoints by default, and excludes it from [Product Search](/../api/projects/product-search).
+ *	To retrieve unpublished Products on Product Projection endpoints, set parameter `staged=true`.
+ *
+ *	Produces the [ProductUnpublished](ctp:api:type:ProductUnpublishedMessage) Message.
  *
  *	When a Product is unpublished, any associated Line Items already present in a Cart remain unaffected and can still be ordered. To prevent this, do the following:
  *

references.txt

@@ -493,3 +493,4 @@ cbeea260f9f18bcf07ccb45817d3243a37753972
 8ad4b29dfcc94ee497a2d38943174b3f15e119e6
 b5bff392d7576a913753815a876d62e929b30fb1
 2a88ce377b090f11908153e9de2141df11c04447
+3505c9432594c0f08addbb9e19eea2ea9ea7b2e0