@wix/auto_sdk_stores_read-only-variants-v-3 1.0.44 → 1.0.45

package/build/{es/stores-catalog-v3-read-only-variant-read-only-variants-v-3.universal-D4WyK7_Y.d.mts → internal/es/stores-catalog-v3-read-only-variant-read-only-variants-v-3.universal-DIjkz6cb.d.mts}

@@ -1826,6 +1826,8 @@ interface Product extends ProductTypedPropertiesOneOf {
     costRange?: PriceRange;
     /**
      * Product inventory info.
+     *
+     * > **Note:** This field reflects the aggregated inventory status from the default location only. Use the [Inventory Items API](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/inventory-items-v3/introduction) to manage inventory for specific locations.
      * @readonly
      */
     inventory?: Inventory;
@@ -1839,12 +1841,19 @@ interface Product extends ProductTypedPropertiesOneOf {
     /**
      * A unique human-friendly identifier for the product.
      * Unlike the product ID, the handle can be set by the user to ensure consistency across multiple platforms.
-     * In case handle wasn't given, the handle will be automatically generated.
+     * This is particularly useful when re-importing products from other systems, as it provides a stable identifier.
+     * If no handle is provided, one is automatically generated.
      * @minLength 1
      * @maxLength 100
      * @readonly
      */
     handle?: string | null;
+    /**
+     * ID of the last import job that affected the product.
+     * @internal
+     * @format GUID
+     */
+    importId?: string | null;
     /**
      * Currency used for the pricing of this product, in [ISO-4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes) format.
      *
@@ -1870,6 +1879,12 @@ interface Product extends ProductTypedPropertiesOneOf {
      * @readonly
      */
     compareAtPriceRange?: PriceRange;
+    /**
+     * Optional - ID of the app that manages the inventory for this product.
+     * @internal
+     * @format GUID
+     */
+    inventoryAppId?: string | null;
     /**
      * Product variants. Each variant must reference all product options via its `choices` array.
      * Each choice references an option using `optionChoiceNames` for all requests.
@@ -1878,10 +1893,14 @@ interface Product extends ProductTypedPropertiesOneOf {
     /**
      * Custom extended fields for the product object.
      *
-     * [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the app dashboard before they can be accessed with API calls.
+     * [Extended fields](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/backend-extensions/schema-plugins/about-schema-plugin-extensions) must be configured in the app dashboard before they can be accessed with API calls.
      */
     extendedFields?: ExtendedFields;
-    /** Product subscriptions. */
+    /**
+     * Product subscriptions.
+     *
+     * Subscription discounts are defined at the product level but apply to each variant's `actualPrice`. This means the final subscription price varies per variant based on the variant's base price.
+     */
     subscriptionDetails?: SubscriptionDetails;
     /**
      * The total number of variants for the product.
@@ -3783,6 +3802,7 @@ interface TextNodeStyle {
 interface Media {
     /**
      * Main media (image, video, etc.) associated with this product.
+     * Automatically set to the first item in the media list.
      * @readonly
      */
     main?: ProductMedia;
@@ -4288,7 +4308,7 @@ interface ProductCategory {
      */
     _id?: string;
     /**
-     * Index location of the product within the category, which can be utilized for sorting products in a specific category. For detailed instructions on how to set this up, refer to the [Add and arrange products in category](https://dev.wix.com/docs/rest/business-solutions/stores/catalog-v3/products-v3/sample-use-cases-and-flows#add-and-arrange-products-in-category) sample flow.
+     * Index location of the product within the category, which can be utilized for sorting products in a specific category. For detailed instructions on how to set this up, refer to the [Add and arrange products in category](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/products-v3/sample-use-cases-and-flows#add-and-arrange-products-in-category) sample flow.
      * @max 200
      */
     index?: number | null;
@@ -4537,7 +4557,8 @@ interface Variant extends VariantTypedPropertiesOneOf {
     /**
      * List of choices that define the product's variant, which requires exactly one choice per product option.
      * Must use `optionChoiceNames` in all requests this field is required.
-     * Empty only for default variants of unmanaged products.
+     *
+     * For products without options (simple products), this array is empty. These products have a single "default variant" that represents the product itself.
      * @maxSize 6
      * @immutable
      */
@@ -4673,7 +4694,10 @@ interface PricePerUnit {
     description?: string | null;
 }
 interface VariantDigitalProperties {
-    /** Digital file which will be downloaded by customer after successful purchase. */
+    /**
+     * Digital file which will be downloaded by the buyer after successful purchase.
+     * Each variant can have a different digital file, allowing you to offer different content per variant.
+     */
     digitalFile?: SecuredMedia;
 }
 interface SecuredMedia {
@@ -4791,6 +4815,13 @@ interface SubscriptionDetails {
      * Default: `false`
      */
     allowOneTimePurchases?: boolean | null;
+    /**
+     * Whether to add a 'Cancel subscription' button to the My Subscriptions tab of the [Members Area page](https://support.wix.com/en/article/site-members-about-the-members-area).
+     *
+     * Default: `false`
+     * @internal
+     */
+    enableCustomerCancellation?: boolean | null;
 }
 interface Subscription extends SubscriptionCyclesOneOf {
     /** Whether subscription is renewed automatically at the end of each period. Cannot be `false`, instead set `billingCycles`. */
@@ -5101,6 +5132,12 @@ type WebhookIdentityTypeWithLiterals = WebhookIdentityType | 'UNKNOWN' | 'ANONYM
  * For complex queries with free-text search and aggregations, use Search Variants instead.
  *
  * Up to 1,000 variants can be returned per request.
+ *
+ * To learn about working with _Query_ endpoints, see
+ * [API Query Language](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-the-wix-api-query-language),
+ * and [Sorting and Paging](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-sorting-and-paging).
+ *
+ * Learn more about the differences between [_Query_ and _Search_](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/data-retrieval/about-search-query-and-list-methods) methods.
  * @public
  * @permissionId WIX_STORES.READ_ONLY_VARIANT_READ
  * @permissionId WIX_STORES.READ_ONLY_VARIANT_READ_HIDDEN

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/auto_sdk_stores_read-only-variants-v-3",
-  "version": "1.0.44",
+  "version": "1.0.45",
   "license": "MIT",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -50,5 +50,5 @@
       "fqdn": "wix.stores.catalog.v3.read_only_variant"
     }
   },
-  "falconPackageHash": "50aa5368ac392041b269b60c3bb88ae00430d4abf466a13be201ee46"
+  "falconPackageHash": "66906f797fb62f4630122215d35f2c8013a360d4997b893d4d73f283"
 }