@salesforce/commerce-sdk-react 1.0.0-preview.0 → 1.0.0-preview.2

package/hooks/ShopperCustomers/query.d.ts

@@ -1,8 +1,11 @@
 import { UseQueryResult } from '@tanstack/react-query';
 import { ApiClients, ApiQueryOptions, Argument, DataType, NullableParameters } from '../types';
-declare type Client = ApiClients['shopperCustomers'];
+type Client = ApiClients['shopperCustomers'];
 /**
- * Gets a customer with all existing addresses and payment instruments associated with the requested customer.
+ * Gets a customer's information.
+ *
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomer` endpoint.
@@ -13,6 +16,8 @@ declare type Client = ApiClients['shopperCustomers'];
 export declare const useCustomer: (apiOptions: NullableParameters<Argument<Client['getCustomer']>>, queryOptions?: ApiQueryOptions<Client['getCustomer']>) => UseQueryResult<DataType<Client['getCustomer']>>;
 /**
  * Retrieves a customer's address by address name.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomerAddress` endpoint.
@@ -23,6 +28,8 @@ export declare const useCustomer: (apiOptions: NullableParameters<Argument<Clien
 export declare const useCustomerAddress: (apiOptions: NullableParameters<Argument<Client['getCustomerAddress']>>, queryOptions?: ApiQueryOptions<Client['getCustomerAddress']>) => UseQueryResult<DataType<Client['getCustomerAddress']>>;
 /**
  * Gets the baskets of a customer.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomerBaskets` endpoint.
@@ -32,7 +39,11 @@ export declare const useCustomerAddress: (apiOptions: NullableParameters<Argumen
  */
 export declare const useCustomerBaskets: (apiOptions: NullableParameters<Argument<Client['getCustomerBaskets']>>, queryOptions?: ApiQueryOptions<Client['getCustomerBaskets']>) => UseQueryResult<DataType<Client['getCustomerBaskets']>>;
 /**
- * Returns a pageable list of all customer's orders. The default page size is 10.
+ * Returns a pageable list of all customer's orders.
+ *
+ * The default page size is 10.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomerOrders` endpoint.
@@ -43,6 +54,8 @@ export declare const useCustomerBaskets: (apiOptions: NullableParameters<Argumen
 export declare const useCustomerOrders: (apiOptions: NullableParameters<Argument<Client['getCustomerOrders']>>, queryOptions?: ApiQueryOptions<Client['getCustomerOrders']>) => UseQueryResult<DataType<Client['getCustomerOrders']>>;
 /**
  * Retrieves a customer's payment instrument by its ID.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomerPaymentInstrument` endpoint.
@@ -53,6 +66,8 @@ export declare const useCustomerOrders: (apiOptions: NullableParameters<Argument
 export declare const useCustomerPaymentInstrument: (apiOptions: NullableParameters<Argument<Client['getCustomerPaymentInstrument']>>, queryOptions?: ApiQueryOptions<Client['getCustomerPaymentInstrument']>) => UseQueryResult<DataType<Client['getCustomerPaymentInstrument']>>;
 /**
  * Returns all customer product lists.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomerProductLists` endpoint.
@@ -63,6 +78,8 @@ export declare const useCustomerPaymentInstrument: (apiOptions: NullableParamete
 export declare const useCustomerProductLists: (apiOptions: NullableParameters<Argument<Client['getCustomerProductLists']>>, queryOptions?: ApiQueryOptions<Client['getCustomerProductLists']>) => UseQueryResult<DataType<Client['getCustomerProductLists']>>;
 /**
  * Returns a customer product list of the given customer and the items in the list.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomerProductList` endpoint.
@@ -73,6 +90,8 @@ export declare const useCustomerProductLists: (apiOptions: NullableParameters<Ar
 export declare const useCustomerProductList: (apiOptions: NullableParameters<Argument<Client['getCustomerProductList']>>, queryOptions?: ApiQueryOptions<Client['getCustomerProductList']>) => UseQueryResult<DataType<Client['getCustomerProductList']>>;
 /**
  * Returns an item of a customer product list and the actual product details like image, availability and price.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomerProductListItem` endpoint.
@@ -83,6 +102,8 @@ export declare const useCustomerProductList: (apiOptions: NullableParameters<Arg
 export declare const useCustomerProductListItem: (apiOptions: NullableParameters<Argument<Client['getCustomerProductListItem']>>, queryOptions?: ApiQueryOptions<Client['getCustomerProductListItem']>) => UseQueryResult<DataType<Client['getCustomerProductListItem']>>;
 /**
  * Retrieves all public product lists as defined by the given search term (for example, email OR first name and last name).
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getPublicProductListsBySearchTerm` endpoint.
@@ -93,6 +114,8 @@ export declare const useCustomerProductListItem: (apiOptions: NullableParameters
 export declare const usePublicProductListsBySearchTerm: (apiOptions: NullableParameters<Argument<Client['getPublicProductListsBySearchTerm']>>, queryOptions?: ApiQueryOptions<Client['getPublicProductListsBySearchTerm']>) => UseQueryResult<DataType<Client['getPublicProductListsBySearchTerm']>>;
 /**
  * Retrieves a public product list by ID and the items under that product list.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getPublicProductList` endpoint.
@@ -103,6 +126,8 @@ export declare const usePublicProductListsBySearchTerm: (apiOptions: NullablePar
 export declare const usePublicProductList: (apiOptions: NullableParameters<Argument<Client['getPublicProductList']>>, queryOptions?: ApiQueryOptions<Client['getPublicProductList']>) => UseQueryResult<DataType<Client['getPublicProductList']>>;
 /**
  * Retrieves an item from a public product list and the actual product details like product, image, availability and price.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getProductListItem` endpoint.

package/hooks/ShopperCustomers/query.js

@@ -58,8 +58,12 @@ function _asyncToGenerator(fn) { return function () { var self = this, args = ar
 //         requiredParameters
 //     })
 // }
+
 /**
- * Gets a customer with all existing addresses and payment instruments associated with the requested customer.
+ * Gets a customer's information.
+ *
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomer` endpoint.
@@ -98,6 +102,8 @@ const useCustomer = (apiOptions, queryOptions = {}) => {
 };
 /**
  * Retrieves a customer's address by address name.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomerAddress` endpoint.
@@ -137,6 +143,8 @@ const useCustomerAddress = (apiOptions, queryOptions = {}) => {
 };
 /**
  * Gets the baskets of a customer.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomerBaskets` endpoint.
@@ -175,7 +183,11 @@ const useCustomerBaskets = (apiOptions, queryOptions = {}) => {
   });
 };
 /**
- * Returns a pageable list of all customer's orders. The default page size is 10.
+ * Returns a pageable list of all customer's orders.
+ *
+ * The default page size is 10.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomerOrders` endpoint.
@@ -215,6 +227,8 @@ const useCustomerOrders = (apiOptions, queryOptions = {}) => {
 };
 /**
  * Retrieves a customer's payment instrument by its ID.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomerPaymentInstrument` endpoint.
@@ -254,6 +268,8 @@ const useCustomerPaymentInstrument = (apiOptions, queryOptions = {}) => {
 };
 /**
  * Returns all customer product lists.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomerProductLists` endpoint.
@@ -293,6 +309,8 @@ const useCustomerProductLists = (apiOptions, queryOptions = {}) => {
 };
 /**
  * Returns a customer product list of the given customer and the items in the list.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomerProductList` endpoint.
@@ -332,6 +350,8 @@ const useCustomerProductList = (apiOptions, queryOptions = {}) => {
 };
 /**
  * Returns an item of a customer product list and the actual product details like image, availability and price.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getCustomerProductListItem` endpoint.
@@ -371,6 +391,8 @@ const useCustomerProductListItem = (apiOptions, queryOptions = {}) => {
 };
 /**
  * Retrieves all public product lists as defined by the given search term (for example, email OR first name and last name).
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getPublicProductListsBySearchTerm` endpoint.
@@ -410,6 +432,8 @@ const usePublicProductListsBySearchTerm = (apiOptions, queryOptions = {}) => {
 };
 /**
  * Retrieves a public product list by ID and the items under that product list.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getPublicProductList` endpoint.
@@ -449,6 +473,8 @@ const usePublicProductList = (apiOptions, queryOptions = {}) => {
 };
 /**
  * Retrieves an item from a public product list and the actual product details like product, image, availability and price.
+ * @group ShopperCustomers
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Customers `getProductListItem` endpoint.

package/hooks/ShopperCustomers/queryKeyHelpers.d.ts

@@ -1,10 +1,10 @@
 import type { ShopperCustomers } from 'commerce-sdk-isomorphic';
 import { Argument, ExcludeTail } from '../types';
-declare type Client = ShopperCustomers<{
+type Client = ShopperCustomers<{
     shortCode: string;
 }>;
-declare type Params<T extends keyof QueryKeys> = Partial<Argument<Client[T]>['parameters']>;
-export declare type QueryKeys = {
+type Params<T extends keyof QueryKeys> = Partial<Argument<Client[T]>['parameters']>;
+export type QueryKeys = {
     getExternalProfile: [
         '/commerce-sdk-react',
         '/organizations/',
@@ -115,7 +115,7 @@ export declare type QueryKeys = {
         Params<'getProductListItem'>
     ];
 };
-declare type QueryKeyHelper<T extends keyof QueryKeys> = {
+type QueryKeyHelper<T extends keyof QueryKeys> = {
     /**
      * Reduces the given parameters (which may have additional, unknown properties) to an object
      * containing *only* the properties required for an endpoint.

package/hooks/ShopperExperience/query.d.ts

@@ -1,12 +1,13 @@
 import { UseQueryResult } from '@tanstack/react-query';
 import { ApiClients, ApiQueryOptions, Argument, DataType, NullableParameters } from '../types';
-declare type Client = ApiClients['shopperExperience'];
+type Client = ApiClients['shopperExperience'];
 /**
- * Get Page Designer pages. The results will apply the visibility rules for each page's components, such as personalization or scheduled visibility.
-
-Either `categoryId` or `productId` must be given in addition to `aspectTypeId`. Because only a single page-to-product and page-to-category assignment per aspect type can be authored today, the returned results contains one element at most.
-
-**Important**: Because this resource uses the GET method, you must not pass sensitive data (payment card information, for example) and must not perform any transactional processes within the server-side scripts that are run for the page and components.
+ * Get Page Designer pages.
+ *
+ * The results will apply the visibility rules for each page's components, such as personalization or scheduled visibility. Either `categoryId` or `productId` must be given in addition to `aspectTypeId`. Because only a single page-to-product and page-to-category assignment per aspect type can be authored today, the returned results contains one element at most.
+ * **Important**: Because this resource uses the GET method, you must not pass sensitive data (payment card information, for example) and must not perform any transactional processes within the server-side scripts that are run for the page and components.
+ * @group ShopperExperience
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Experience `getPages` endpoint.
@@ -16,9 +17,12 @@ Either `categoryId` or `productId` must be given in addition to `aspectTypeId`.
  */
 export declare const usePages: (apiOptions: NullableParameters<Argument<Client['getPages']>>, queryOptions?: ApiQueryOptions<Client['getPages']>) => UseQueryResult<DataType<Client['getPages']>>;
 /**
- * Get a Page Designer page based on a single page ID. The results will apply the visibility rules for the page's components, such as personalization or scheduled visibility.
-
-**Important**: Because this resource uses the GET method, you must not pass sensitive data (payment card information, for example) and must not perform any transactional processes within the server-side scripts that are run for the page and components.
+ * Get a Page Designer page based on a single page ID.
+ *
+ * The results will apply the visibility rules for the page's components, such as personalization or scheduled visibility.
+ * **Important**: Because this resource uses the GET method, you must not pass sensitive data (payment card information, for example) and must not perform any transactional processes within the server-side scripts that are run for the page and components.
+ * @group ShopperExperience
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Experience `getPage` endpoint.

package/hooks/ShopperExperience/query.js

@@ -19,11 +19,12 @@ function _asyncToGenerator(fn) { return function () { var self = this, args = ar
                                                                                                                                                                                                                                                                                                                                                                                                        * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
                                                                                                                                                                                                                                                                                                                                                                                                        */
 /**
- * Get Page Designer pages. The results will apply the visibility rules for each page's components, such as personalization or scheduled visibility.
-
-Either `categoryId` or `productId` must be given in addition to `aspectTypeId`. Because only a single page-to-product and page-to-category assignment per aspect type can be authored today, the returned results contains one element at most.
-
-**Important**: Because this resource uses the GET method, you must not pass sensitive data (payment card information, for example) and must not perform any transactional processes within the server-side scripts that are run for the page and components.
+ * Get Page Designer pages.
+ *
+ * The results will apply the visibility rules for each page's components, such as personalization or scheduled visibility. Either `categoryId` or `productId` must be given in addition to `aspectTypeId`. Because only a single page-to-product and page-to-category assignment per aspect type can be authored today, the returned results contains one element at most.
+ * **Important**: Because this resource uses the GET method, you must not pass sensitive data (payment card information, for example) and must not perform any transactional processes within the server-side scripts that are run for the page and components.
+ * @group ShopperExperience
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Experience `getPages` endpoint.
@@ -61,9 +62,12 @@ const usePages = (apiOptions, queryOptions = {}) => {
   });
 };
 /**
- * Get a Page Designer page based on a single page ID. The results will apply the visibility rules for the page's components, such as personalization or scheduled visibility.
-
-**Important**: Because this resource uses the GET method, you must not pass sensitive data (payment card information, for example) and must not perform any transactional processes within the server-side scripts that are run for the page and components.
+ * Get a Page Designer page based on a single page ID.
+ *
+ * The results will apply the visibility rules for the page's components, such as personalization or scheduled visibility.
+ * **Important**: Because this resource uses the GET method, you must not pass sensitive data (payment card information, for example) and must not perform any transactional processes within the server-side scripts that are run for the page and components.
+ * @group ShopperExperience
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Experience `getPage` endpoint.

package/hooks/ShopperExperience/queryKeyHelpers.d.ts

@@ -1,10 +1,10 @@
 import type { ShopperExperience } from 'commerce-sdk-isomorphic';
 import { Argument, ExcludeTail } from '../types';
-declare type Client = ShopperExperience<{
+type Client = ShopperExperience<{
     shortCode: string;
 }>;
-declare type Params<T extends keyof QueryKeys> = Partial<Argument<Client[T]>['parameters']>;
-export declare type QueryKeys = {
+type Params<T extends keyof QueryKeys> = Partial<Argument<Client[T]>['parameters']>;
+export type QueryKeys = {
     getPages: [
         '/commerce-sdk-react',
         '/organizations/',
@@ -21,7 +21,7 @@ export declare type QueryKeys = {
         Params<'getPage'>
     ];
 };
-declare type QueryKeyHelper<T extends keyof QueryKeys> = {
+type QueryKeyHelper<T extends keyof QueryKeys> = {
     /**
      * Reduces the given parameters (which may have additional, unknown properties) to an object
      * containing *only* the properties required for an endpoint.

package/hooks/ShopperGiftCertificates/query.d.ts

@@ -1,8 +1,10 @@
 import { UseQueryResult } from '@tanstack/react-query';
 import { ApiClients, ApiQueryOptions, Argument, DataType, NullableParameters } from '../types';
-declare type Client = ApiClients['shopperGiftCertificates'];
+type Client = ApiClients['shopperGiftCertificates'];
 /**
  * Action to retrieve an existing gift certificate.
+ * @group ShopperGiftCertificates
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Gift Certificates `getGiftCertificate` endpoint.

package/hooks/ShopperGiftCertificates/query.js

@@ -25,6 +25,8 @@ function _asyncToGenerator(fn) { return function () { var self = this, args = ar
                                                                                                                                                                                                                                                                                                                                                                                                        */
 /**
  * Action to retrieve an existing gift certificate.
+ * @group ShopperGiftCertificates
+ * @category Query
  * @parameter apiOptions - Options to pass through to `commerce-sdk-isomorphic`, with `null` accepted for unset API parameters.
  * @parameter queryOptions - TanStack Query query options, with `enabled` by default set to check that all required API parameters have been set.
  * @returns A TanStack Query query hook with data from the Shopper Gift Certificates `getGiftCertificate` endpoint.

package/hooks/ShopperGiftCertificates/queryKeyHelpers.d.ts

@@ -1,10 +1,10 @@
 import type { ShopperGiftCertificates } from 'commerce-sdk-isomorphic';
 import { Argument, ExcludeTail } from '../types';
-declare type Client = ShopperGiftCertificates<{
+type Client = ShopperGiftCertificates<{
     shortCode: string;
 }>;
-declare type Params<T extends keyof QueryKeys> = Partial<Argument<Client[T]>['parameters']>;
-export declare type QueryKeys = {
+type Params<T extends keyof QueryKeys> = Partial<Argument<Client[T]>['parameters']>;
+export type QueryKeys = {
     getGiftCertificate: [
         '/commerce-sdk-react',
         '/organizations/',
@@ -13,7 +13,7 @@ export declare type QueryKeys = {
         Params<'getGiftCertificate'>
     ];
 };
-declare type QueryKeyHelper<T extends keyof QueryKeys> = {
+type QueryKeyHelper<T extends keyof QueryKeys> = {
     /**
      * Reduces the given parameters (which may have additional, unknown properties) to an object
      * containing *only* the properties required for an endpoint.

package/hooks/ShopperLogin/mutation.d.ts

@@ -1,14 +1,16 @@
 import { ApiClients, Argument, DataType } from '../types';
 import { UseMutationResult } from '@tanstack/react-query';
-declare type Client = ApiClients['shopperLogin'];
-/** Mutations available for Shopper Login. */
+type Client = ApiClients['shopperLogin'];
+/**
+ * Mutations available for Shopper Login
+ * @group ShopperLogin
+ * @category Mutation
+ * @enum
+ */
 export declare const ShopperLoginMutations: {
     /**
      * Allows the customer to authenticate when their identity provider is down.
      * @returns A TanStack Query mutation hook for interacting with the Shopper Login `authorizePasswordlessCustomer` endpoint.
-     * @see {@link https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-login?meta=authorizePasswordlessCustomer| Salesforce Developer Center} for more information about the API endpoint.
-     * @see {@link https://salesforcecommercecloud.github.io/commerce-sdk-isomorphic/classes/shopperlogin.shopperlogin-1.html#authorizepasswordlesscustomer | `commerce-sdk-isomorphic` documentation} for more information on the parameters and returned data type.
-     * @see {@link https://tanstack.com/query/latest/docs/react/reference/useMutation | TanStack Query `useMutation` reference} for more information about the return value.
      */
     readonly AuthorizePasswordlessCustomer: "authorizePasswordlessCustomer";
     /**
@@ -18,30 +20,12 @@ Required header: Authorization header bearer token of the Shopper access token t
 
 Required parameters: `refresh token`, `channel_id`, and `client`.
    * @returns A TanStack Query mutation hook for interacting with the Shopper Login `logoutCustomer` endpoint.
-   * @see {@link https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-login?meta=logoutCustomer| Salesforce Developer Center} for more information about the API endpoint.
-   * @see {@link https://salesforcecommercecloud.github.io/commerce-sdk-isomorphic/classes/shopperlogin.shopperlogin-1.html#logoutcustomer | `commerce-sdk-isomorphic` documentation} for more information on the parameters and returned data type.
-   * @see {@link https://tanstack.com/query/latest/docs/react/reference/useMutation | TanStack Query `useMutation` reference} for more information about the return value.
    */
     readonly LogoutCustomer: "logoutCustomer";
     /**
-   * Get the shopper or guest JWT access token and a refresh token. This is the second step of the OAuth 2.1 authorization code flow.
-
-For a private client, an application is able to get an access token for the shopper through the back channel (a trusted server) by passing in the client credentials and the authorization code retrieved from the `authorize` endpoint.
-
-For a guest user, get the shopper JWT access token and a refresh token. This is where a client appplication is able to get an access token for the guest user through the back channel (a trusted server) by passing in the client credentials.
-
-For a public client using PKCE, an application will pass a PKCE `code_verifier`` that matches the `code_challenge`` that was used to `authorize` the customer along with the authorization code.
-
-When refreshing the access token with a private client ID and client secret, the refresh token is _not_ regenerated. However, when refreshing the access token with a public client ID, the refresh token is _always_ regenerated. The old refresh token is voided with every refresh call, so the refresh token on the client needs to be replaced to always store the new refresh token.
-
-See the Body section for required parameters, including `grant_type` and others, depending on the value of `grant_type`.
-
-**Important**: We strongly recommended using the `channel_id` query parameter because **it will be required in the future**.
-   * @returns A TanStack Query mutation hook for interacting with the Shopper Login `getAccessToken` endpoint.
-   * @see {@link https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-login?meta=getAccessToken| Salesforce Developer Center} for more information about the API endpoint.
-   * @see {@link https://salesforcecommercecloud.github.io/commerce-sdk-isomorphic/classes/shopperlogin.shopperlogin-1.html#getaccesstoken | `commerce-sdk-isomorphic` documentation} for more information on the parameters and returned data type.
-   * @see {@link https://tanstack.com/query/latest/docs/react/reference/useMutation | TanStack Query `useMutation` reference} for more information about the return value.
-   */
+     * Get the shopper or guest JWT access token and a refresh token. This is the second step of the OAuth 2.1 authorization code flow.
+     * @returns A TanStack Query mutation hook for interacting with the Shopper Login `getAccessToken` endpoint.
+     */
     readonly GetAccessToken: "getAccessToken";
     /**
    * Get a shopper JWT access token for a registered customer using session bridge.
@@ -50,9 +34,6 @@ For public client id requests the grant_type must be set to `session_bridge`.
 
 For  private client_id and secret the grant_type must be set to `client_credentials` along with a basic authorization header.
    * @returns A TanStack Query mutation hook for interacting with the Shopper Login `getSessionBridgeAccessToken` endpoint.
-   * @see {@link https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-login?meta=getSessionBridgeAccessToken| Salesforce Developer Center} for more information about the API endpoint.
-   * @see {@link https://salesforcecommercecloud.github.io/commerce-sdk-isomorphic/classes/shopperlogin.shopperlogin-1.html#getsessionbridgeaccesstoken | `commerce-sdk-isomorphic` documentation} for more information on the parameters and returned data type.
-   * @see {@link https://tanstack.com/query/latest/docs/react/reference/useMutation | TanStack Query `useMutation` reference} for more information about the return value.
    */
     readonly GetSessionBridgeAccessToken: "getSessionBridgeAccessToken";
     /**
@@ -62,9 +43,6 @@ For external trusted-system requests, a basic authorization header that includes
 
 For internal trusted-system requests, the bearer token must be a C2C JWT.
    * @returns A TanStack Query mutation hook for interacting with the Shopper Login `getTrustedSystemAccessToken` endpoint.
-   * @see {@link https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-login?meta=getTrustedSystemAccessToken| Salesforce Developer Center} for more information about the API endpoint.
-   * @see {@link https://salesforcecommercecloud.github.io/commerce-sdk-isomorphic/classes/shopperlogin.shopperlogin-1.html#gettrustedsystemaccesstoken | `commerce-sdk-isomorphic` documentation} for more information on the parameters and returned data type.
-   * @see {@link https://tanstack.com/query/latest/docs/react/reference/useMutation | TanStack Query `useMutation` reference} for more information about the return value.
    */
     readonly GetTrustedSystemAccessToken: "getTrustedSystemAccessToken";
     /**
@@ -74,46 +52,40 @@ If using a SLAS private client ID, you must also use an `_sfdc_client_auth` head
 
 The value of the `_sfdc_client_auth` header must be a Base64-encoded string. The string is composed of a SLAS private client ID and client secret, separated by a colon (`:`). For example, `privateClientId:privateClientsecret` becomes `cHJpdmF0ZUNsaWVudElkOnByaXZhdGVDbGllbnRzZWNyZXQ=` after Base64 encoding.
    * @returns A TanStack Query mutation hook for interacting with the Shopper Login `getTrustedAgentAccessToken` endpoint.
-   * @see {@link https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-login?meta=getTrustedAgentAccessToken| Salesforce Developer Center} for more information about the API endpoint.
-   * @see {@link https://salesforcecommercecloud.github.io/commerce-sdk-isomorphic/classes/shopperlogin.shopperlogin-1.html#gettrustedagentaccesstoken | `commerce-sdk-isomorphic` documentation} for more information on the parameters and returned data type.
-   * @see {@link https://tanstack.com/query/latest/docs/react/reference/useMutation | TanStack Query `useMutation` reference} for more information about the return value.
    */
     readonly GetTrustedAgentAccessToken: "getTrustedAgentAccessToken";
     /**
      * Creates a new password
      * @returns A TanStack Query mutation hook for interacting with the Shopper Login `resetPassword` endpoint.
-     * @see {@link https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-login?meta=resetPassword| Salesforce Developer Center} for more information about the API endpoint.
-     * @see {@link https://salesforcecommercecloud.github.io/commerce-sdk-isomorphic/classes/shopperlogin.shopperlogin-1.html#resetpassword | `commerce-sdk-isomorphic` documentation} for more information on the parameters and returned data type.
-     * @see {@link https://tanstack.com/query/latest/docs/react/reference/useMutation | TanStack Query `useMutation` reference} for more information about the return value.
      */
     readonly ResetPassword: "resetPassword";
     /**
      * Issue a shopper token (JWT).
      * @returns A TanStack Query mutation hook for interacting with the Shopper Login `getPasswordLessAccessToken` endpoint.
-     * @see {@link https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-login?meta=getPasswordLessAccessToken| Salesforce Developer Center} for more information about the API endpoint.
-     * @see {@link https://salesforcecommercecloud.github.io/commerce-sdk-isomorphic/classes/shopperlogin.shopperlogin-1.html#getpasswordlessaccesstoken | `commerce-sdk-isomorphic` documentation} for more information on the parameters and returned data type.
-     * @see {@link https://tanstack.com/query/latest/docs/react/reference/useMutation | TanStack Query `useMutation` reference} for more information about the return value.
      */
     readonly GetPasswordLessAccessToken: "getPasswordLessAccessToken";
     /**
      * Invalidate the refresh token. A basic auth header with Base64-encoded `clientId:secret` is required in the Authorization header, and the refresh token to be revoked is required in the body.
      * @returns A TanStack Query mutation hook for interacting with the Shopper Login `revokeToken` endpoint.
-     * @see {@link https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-login?meta=revokeToken| Salesforce Developer Center} for more information about the API endpoint.
-     * @see {@link https://salesforcecommercecloud.github.io/commerce-sdk-isomorphic/classes/shopperlogin.shopperlogin-1.html#revoketoken | `commerce-sdk-isomorphic` documentation} for more information on the parameters and returned data type.
-     * @see {@link https://tanstack.com/query/latest/docs/react/reference/useMutation | TanStack Query `useMutation` reference} for more information about the return value.
      */
     readonly RevokeToken: "revokeToken";
     /**
      * Returns the token properties. A basic auth header with Base64-encoded `clientId:secret` is required in the Authorization header, as well as an access token or refresh token. Use `token_type_hint` to help identify the token.
      * @returns A TanStack Query mutation hook for interacting with the Shopper Login `introspectToken` endpoint.
-     * @see {@link https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-login?meta=introspectToken| Salesforce Developer Center} for more information about the API endpoint.
-     * @see {@link https://salesforcecommercecloud.github.io/commerce-sdk-isomorphic/classes/shopperlogin.shopperlogin-1.html#introspecttoken | `commerce-sdk-isomorphic` documentation} for more information on the parameters and returned data type.
-     * @see {@link https://tanstack.com/query/latest/docs/react/reference/useMutation | TanStack Query `useMutation` reference} for more information about the return value.
      */
     readonly IntrospectToken: "introspectToken";
 };
-/** Mutation for Shopper Login. */
-export declare type ShopperLoginMutation = (typeof ShopperLoginMutations)[keyof typeof ShopperLoginMutations];
+/**
+ * Mutation for Shopper Login.
+ * @group ShopperLogin
+ * @category Mutation
+ */
+export type ShopperLoginMutation = (typeof ShopperLoginMutations)[keyof typeof ShopperLoginMutations];
+/**
+ * Mutation hook for Shopper Login.
+ * @group ShopperLogin
+ * @category Mutation
+ */
 export declare function useShopperLoginMutation<Mutation extends ShopperLoginMutation>(mutation: Mutation): UseMutationResult<DataType<Client[Mutation]>, unknown, Argument<Client[Mutation]>>;
 export {};
 //# sourceMappingURL=mutation.d.ts.map