commerce-sdk-isomorphic 4.0.0-nightly-20251030080738 → 4.0.0-nightly-20251101080702

package/lib/shopperConsents.d.ts

@@ -102,14 +102,33 @@ declare class ClientConfig<Params extends BaseUriParameters> implements ClientCo
     constructor(config: ClientConfigInit<Params>);
     static readonly defaults: Pick<Required<ClientConfigInit<never>>, "transformRequest">;
 }
+/**
+ *
+ */
+type ChannelType = "email" | "sms" | "whatsapp";
 /**
  * The consent status of the subscription as supplied or recorded by this system
  */
 type ConsentStatus = "opt_in" | "opt_out";
 /**
+ * @type SubscriptionStatusEntry: Individual subscription status entry for a specific channel
+ *
+ * @property channel:
+ *
+ * @property contactPointValue: The customer\'s contact point value, polymorphic based on the channel type as below: - `sms` - Subject\'s phone number in E.164 format, ex: `+1 424 535 3546` - `email` - Subject\'s email address in RFC 5321 & RFC 5322 format, ex: `jack.sparrow@salesforce.com`
+ * - **Min Length:** 3
+ * - **Max Length:** 320
+ *
+ * @property status:
  *
  */
-type SubscriptionChannel = "email" | "sms" | "push_notification" | "in_app" | "postal_mail" | "whatsapp";
+type SubscriptionStatusEntry = {
+    channel: ChannelType;
+    contactPointValue: string;
+    status: ConsentStatus;
+} & {
+    [key: string]: any;
+};
 /**
  * @type ConsentSubscription:
  *
@@ -118,41 +137,42 @@ type SubscriptionChannel = "email" | "sms" | "push_notification" | "in_app" | "p
  * - **Min Length:** 1
  * - **Max Length:** 255
  *
- * @property consentId: Identifier for the shopper communication subscription consent -- formatted as `<contactPointValue>#<communicationSubscriptionChannelId>`
- * - **Min Length:** 19
- * - **Max Length:** 339
- *
- * @property contactPointValue: The customer\'s contact point value, polymorphic based on the channel type as below: - `sms` - Subject\'s phone number in E.164 format, ex: `+1 424 535 3546` - `email` - Subject\'s email address in RFC 5321 & RFC 5322 format, ex: `jack.sparrow@salesforce.com`
- * - **Min Length:** 3
- * - **Max Length:** 320
- *
- * @property channel:
+ * @property channels:
  *
- * @property status:
+ * @property consentStatus: Array of subscription status entries for different channels
  *
- * @property title:
+ * @property title: The localized title of the subscription for shopper displays
  * - **Min Length:** 1
  * - **Max Length:** 255
  *
- * @property subtitle:
+ * @property subtitle: The localized subtitle of the subscription for shopper displays, may contain HTML markup
  * - **Min Length:** 1
- * - **Max Length:** 255
+ * - **Max Length:** 2000
  *
  * @property tags:
  *
+ * @property consentType: Type of consent subscription
+ *
+ * @property consentRequired: Whether this subscription is mandatory for the user
+ *
+ * @property defaultStatus: Default consent status for this subscription
+ *
  */
 type ConsentSubscription = {
     subscriptionId: string;
-    consentId?: string;
-    contactPointValue?: string;
-    channel: SubscriptionChannel;
-    status?: ConsentStatus;
+    channels: Set<ChannelType>;
+    consentStatus?: Array<SubscriptionStatusEntry>;
     title?: string;
     subtitle?: string;
     tags?: Array<string>;
+    consentType?: ConsentSubscriptionConsentTypeEnum;
+    consentRequired?: boolean;
+    defaultStatus?: ConsentSubscriptionDefaultStatusEnum;
 } & {
     [key: string]: any;
 };
+type ConsentSubscriptionConsentTypeEnum = "marketing" | "legal";
+type ConsentSubscriptionDefaultStatusEnum = "opt_in" | "opt_out";
 /**
  * @type ConsentSubscriptionRequest: Consent subscription update request
  *
@@ -173,8 +193,80 @@ type ConsentSubscription = {
 type ConsentSubscriptionRequest = {
     subscriptionId: string;
     contactPointValue: string;
-    channel: SubscriptionChannel;
+    channel: ChannelType;
+    status: ConsentStatus;
+} & {
+    [key: string]: any;
+};
+/**
+ * @type ConsentSubscriptionBulkRequest: Bulk request for updating multiple consent subscriptions
+ *
+ * @property subscriptions: Array of subscription consent updates to process
+ *
+ */
+type ConsentSubscriptionBulkRequest = {
+    subscriptions: Array<ConsentSubscriptionRequest>;
+} & {
+    [key: string]: any;
+};
+/**
+ * @type ConsentSubscriptionError: Error details for failed subscription updates
+ *
+ * @property code: Error code indicating the type of failure
+ * - **Max Length:** 100
+ *
+ * @property message: Human-readable error message
+ * - **Max Length:** 500
+ *
+ * @property details: Additional error details
+ *
+ */
+type ConsentSubscriptionError = {
+    code: string;
+    message: string;
+    details?: object;
+} & {
+    [key: string]: any;
+};
+/**
+ * @type ConsentSubscriptionResult: Individual subscription update result with input parameters
+ *
+ * @property subscriptionId: Identifier for the communication subscription
+ * - **Pattern:** /^[a-z0-9]+(?:-[a-z0-9]+)*$/
+ * - **Min Length:** 1
+ * - **Max Length:** 255
+ *
+ * @property channel:
+ *
+ * @property contactPointValue: The customer\'s contact point value, polymorphic based on the channel type as below: - `sms` - Subject\'s phone number in E.164 format, ex: `+1 424 535 3546` - `email` - Subject\'s email address in RFC 5321 & RFC 5322 format, ex: `jack.sparrow@salesforce.com`
+ * - **Min Length:** 3
+ * - **Max Length:** 320
+ *
+ * @property status:
+ *
+ * @property success: Whether the subscription update was successful
+ *
+ * @property error:
+ *
+ */
+type ConsentSubscriptionResult = {
+    subscriptionId: string;
+    channel: ChannelType;
+    contactPointValue: string;
     status: ConsentStatus;
+    success: boolean;
+    error?: ConsentSubscriptionError;
+} & {
+    [key: string]: any;
+};
+/**
+ * @type ConsentSubscriptionBulkResponse: Bulk response with results for each subscription update request
+ *
+ * @property results: Results for each subscription update request
+ *
+ */
+type ConsentSubscriptionBulkResponse = {
+    results: Array<ConsentSubscriptionResult>;
 } & {
     [key: string]: any;
 };
@@ -189,6 +281,31 @@ type ConsentSubscriptionResponse = {
 } & {
     [key: string]: any;
 };
+/**
+ * @type ConsentSubscriptionUpdateResponse: Single subscription update response
+ *
+ * @property subscriptionId: Identifier for the communication subscription
+ * - **Pattern:** /^[a-z0-9]+(?:-[a-z0-9]+)*$/
+ * - **Min Length:** 1
+ * - **Max Length:** 255
+ *
+ * @property channel:
+ *
+ * @property contactPointValue: The customer\'s contact point value, polymorphic based on the channel type as below: - `sms` - Subject\'s phone number in E.164 format, ex: `+1 424 535 3546` - `email` - Subject\'s email address in RFC 5321 & RFC 5322 format, ex: `jack.sparrow@salesforce.com`
+ * - **Min Length:** 3
+ * - **Max Length:** 320
+ *
+ * @property status:
+ *
+ */
+type ConsentSubscriptionUpdateResponse = {
+    subscriptionId: string;
+    channel: ChannelType;
+    contactPointValue: string;
+    status: ConsentStatus;
+} & {
+    [key: string]: any;
+};
 /**
  * A specialized value indicating the system default values for locales.
  */
@@ -221,10 +338,12 @@ type ErrorResponse = {
  * A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
  */
 type LocaleCode$0 = DefaultFallback | string;
+type GetSubscriptionsExpandEnum = "consentStatus";
 type getSubscriptionsQueryParameters = {
     siteId: string;
     locale?: LocaleCode$0;
     tags?: Array<string>;
+    expand?: Set<"consentStatus">;
 };
 type getSubscriptionsPathParameters = {
     organizationId: string;
@@ -236,14 +355,21 @@ type updateSubscriptionQueryParameters = {
 type updateSubscriptionPathParameters = {
     organizationId: string;
 };
+type updateSubscriptionsQueryParameters = {
+    siteId: string;
+    locale?: LocaleCode$0;
+};
+type updateSubscriptionsPathParameters = {
+    organizationId: string;
+};
 /**
  * All path parameters that are used by at least one ShopperConsents method.
  */
-type ShopperConsentsPathParameters = Partial<getSubscriptionsPathParameters & updateSubscriptionPathParameters & {}>;
+type ShopperConsentsPathParameters = Partial<getSubscriptionsPathParameters & updateSubscriptionPathParameters & updateSubscriptionsPathParameters & {}>;
 /**
  * All query parameters that are used by at least one ShopperConsents method.
  */
-type ShopperConsentsQueryParameters = Partial<getSubscriptionsQueryParameters & updateSubscriptionQueryParameters & {}>;
+type ShopperConsentsQueryParameters = Partial<getSubscriptionsQueryParameters & updateSubscriptionQueryParameters & updateSubscriptionsQueryParameters & {}>;
 /**
  * All parameters that are used by ShopperConsents.
  */
@@ -252,18 +378,21 @@ type ShopperConsentsParameters = ShopperConsentsPathParameters & BaseUriParamete
  * [Shopper Consents](https://developer.salesforce.com/docs/commerce/commerce-api/references?meta=shopper-consents:Summary)
  * ==================================
  *
- * *# Shopper Consent
+ * *[Download API specification](https://developer.salesforce.com/static/commercecloud/commerce-api/shopper-consents/shopper-consents-oas-v1-public.yaml)
  
- ## API Overview
+ # API Overview
  
  The Shopper Consent API offers a centralized method for managing shopper consent. With this API, shoppers can view and update subscription preferences for marketing communications across various channels. This API controls how and where shoppers receive marketing messages while ensuring compliance with privacy regulations.
  
  ## Key Features
  
- - Multi-Channel Support: Manage communication subscriptions across email, SMS, push notifications, in-app messages, and postal mail.
- - Organization-Based Management: Isolate consent preferences by organization for multi-tenant environments.
- - Real-Time Updates: Instantly create and retrieve subscription preferences.
- - Compliance Ready: Built with privacy regulations and consent-management best practices in mind.
+ - **Retrieve communication subscriptions**: Retrieve relevant communication subscription options with rich display information.
+ - Communication subscription options can be filtered by one or more qualifying tags.
+ - Use the `expand` parameter to conditionally include subscription status.
+ - **Update individual subscription consent**: Update consent status for a single subscription with simple request/response pattern.
+ - **Bulk subscription updates**: Efficiently manage multiple subscription preferences with a single request.
+ - Update 1-50 subscriptions per bulk request.
+ - Partial success handling with detailed error reporting for failed updates.
  
  ## Authentication & Authorization
  
@@ -276,68 +405,98 @@ type ShopperConsentsParameters = ShopperConsentsPathParameters & BaseUriParamete
  ### Required Scopes
  
  - `sfcc.shopper-consents`: Required for reading communication subscription data (GET operations).
- - `sfcc.shopper-consents.rw`: Required for creating and modifying communication subscription data (POST operations).
- 
- ## Use Cases
- 
- ### Shopper Subscription Management
- - Retrieve communication subscriptions: Retrieve relevant communication subscription options with display information.
- - Guest shoppers can retrieve communication subscriptions options without pre-defined shopper credentials, for example: email address, phone number.
- - Authenticated shoppers can retrieve communication subscription options available to their shopper credentials.
- - Communication subscription options can be filtered by one or more qualifying tags.
- - Update communication subscription consent preferences.
+ - `sfcc.shopper-consents.rw`: Required for creating and modifying communication subscription consent data (POST operations).
  
  ## Data Model
  
  ### Subscriptions
  Subscriptions represent a shopper's consent to receive specific types of marketing communications. Each subscription includes:
  
- - Identifier: Descriptive identifier
- - Consent Status: Opt-in or opt-out
- - Display Information: Title, subtitle, and description for customer-facing interfaces
- - Tags: Categorical tags indicating where the subscription option can appear
- - Channels: Supported communication methods, such as email, SMS, push notification
+ - **Subscription Id**: Descriptive identifier
+ - **Channels**: Array of communication methods - Email, SMS, or WhatsApp
+ - **Consent Type**: Marketing or legal subscription classification
+ - **Consent Required**: Whether the subscription is mandatory for the shopper
+ - **Default Status**: Default opt-in or opt-out behavior
+ - **Consent Status**: Array of status entries for each channel showing current opt-in or opt-out status (conditionally returned based on expand parameter)
+ - **Rich Display Information**:
+ - Title: Simple localized string for subscription name
+ - Subtitle: Simple localized string with HTML markup support for descriptions
+ - Localized content determined by the locale parameter
+ - **Tags**: Categorical tags indicating where the subscription option can appear (defaults to empty array, max 10 tags)
  
  ### Channels
  Channels define the communication methods available for a subscription:
  - `email`: Email communications
  - `sms`: SMS/text messages
- - `whatsapp`: WhatsApp
+ - `whatsapp`: WhatsApp messaging
  
  ### Tags
  Tags indicate where subscription options are displayed in your shopper experience. Tags are also accepted as optional filtering parameters in the retrieval of shopper consent subscriptions. For example:
  - `homepage_banner`: Main website homepage
- - `registration`: Shopper registration process
- - `checkout`: Checkout process
- - `user_profile`: User profile management area
+ - `registration`: Shopper registration form
+ - `checkout`: Checkout flow
+ - `user_profile`: User profile management section
  
- ## Best Practices
+ ### Default Values
+ The API provides sensible defaults for optional fields to simplify integration:
+ - **Consent Type**: Defaults to "marketing" for marketing communications
+ - **Consent Required**: Defaults to false, making subscriptions optional by default
+ - **Default Status**: Defaults to "opt_out" to respect privacy-first principles
+ - **Tags**: Defaults to an empty array when not specified
  
- ### User Experience
- - Make it easy for shoppers to update their preferences.
- - Respect shopper choices immediately.
+ ## Advanced Features
  
- ### Implementation Guidelines
- - Implement clear and prominent unsubscribe mechanisms.
+ ### Expand Parameter
+ The `expand` parameter provides conditional field inclusion:
+ - `expand=[]` (default): Returns basic subscription information
+ - `expand=["consentStatus"]`: Include consent status information in the response
+ - Future expansion may include additional fields
+ 
+ ### Single Subscription Updates
+ Update consent for one subscription at a time:
+ - **Endpoint**: `POST /organizations/{organizationId}/subscriptions`
+ - **Request**: Requires subscriptionId, contactPointValue, channel, and status
+ - **Response**: Returns the same parameters on success (HTTP 200)
+ - **Use Case**: Ideal for real-time updates as shoppers interact with individual preferences
  
- ### Compliance Considerations
- - Ensure consent is freely given, specific, informed, and unambiguous.
- - Implement proper data retention and deletion policies.
- - Provide easy access to consent history and preferences.
+ ### Bulk Operations
+ Efficiently manage multiple subscription preferences in a single request:
+ - **Endpoint**: `POST /organizations/{organizationId}/subscriptions/actions/bulk`
+ - **Request Limits**: 1-50 subscriptions per bulk request
+ - **Response Handling**:
+ - HTTP 200: All updates successful
+ - HTTP 207 Multi-Status: Partial success with detailed error reporting
+ - HTTP 400: Request validation failure
+ - **Error Isolation**: Failed updates don't affect successful ones
+ - **Individual Results**: Each subscription update returns:
+ - Original input parameters (subscriptionId, contactPointValue, channel, status)
+ - Success/failure status
+ - Detailed error information for failed updates
+ - No full subscription objects returned for improved performance
  
  ## Error Handling
  
  The API uses standard HTTP status codes and returns detailed error information to help with troubleshooting:
  
- - `400 Bad Request`: Invalid request format or missing required fields
- - `401 Unauthorized`: Invalid or missing authentication token
- - `403 Forbidden`: Insufficient permissions for the requested operation
- - `404 Not Found`: Requested organization or resource not found
- - `500 Internal Server Error`: Unexpected server error
+ - `200 OK`: Successful operation (single or bulk with all successes)
+ - `207 Multi-Status`: Bulk operation with partial success
+ - `400 Bad Request`: Invalid request format, missing required fields, or markup validation errors
+ 
+ ## Best Practices
+ 
+ ### User Experience
+ - Make it easy for shoppers to update their preferences.
+ - Respect shopper choices immediately.
  
- ## Rate Limits
+ ### Implementation Guidelines
+ - Implement clear and prominent unsubscribe mechanisms.
+ - Validate HTML markup content to prevent XSS vulnerabilities.
+ - Handle partial success scenarios gracefully in bulk operations.
  
- To ensure fair usage and system stability, the Shopper Consent API implements rate limiting. Refer to the response headers for current rate limit status and adjust your integration accordingly.*<br />
+ ### Performance Considerations
+ - Use single subscription updates for real-time, interactive preference changes.
+ - Use bulk operations when updating multiple subscriptions to reduce API calls and improve performance.
+ - Only request status information when needed using the expand parameter to reduce latency.*<br />
  *
  * Simple example:
  *
@@ -371,6 +530,7 @@ declare class ShopperConsents<ConfigParameters extends ShopperConsentsParameters
     static readonly apiPaths: {
         getSubscriptions: string;
         updateSubscription: string;
+        updateSubscriptions: string;
     };
     constructor(config: ClientConfigInit<ConfigParameters>);
     static readonly paramKeys: {
@@ -378,7 +538,8 @@ declare class ShopperConsents<ConfigParameters extends ShopperConsentsParameters
             "organizationId",
             "siteId",
             "locale",
-            "tags"
+            "tags",
+            "expand"
         ];
         readonly getSubscriptionsRequired: readonly [
             "organizationId",
@@ -393,9 +554,26 @@ declare class ShopperConsents<ConfigParameters extends ShopperConsentsParameters
             "organizationId",
             "siteId"
         ];
+        readonly updateSubscriptions: readonly [
+            "organizationId",
+            "siteId",
+            "locale"
+        ];
+        readonly updateSubscriptionsRequired: readonly [
+            "organizationId",
+            "siteId"
+        ];
     };
     /**
-     * Retrieve all subcription preferences for the shopper (authenticated or guest)
+     * Retrieve all subscription preferences for the shopper (authenticated or guest).
+     
+     Use the 'expand' parameter to include additional fields in the response:
+     - expand=["consentStatus"]: Include subscription status information
+     - expand=[]: Default behavior, excludes status for privacy and performance
+     
+     The expand parameter provides privacy benefits by not exposing sensitive status
+     information unless explicitly requested.
+     
      *
      * If you would like to get a raw Response object use the other getSubscriptions function.
      *
@@ -405,6 +583,13 @@ declare class ShopperConsents<ConfigParameters extends ShopperConsentsParameters
      * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
      * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
      * @param options.parameters.tags - Optional parameter of 0 or more query string values which act as a filtering criteria. Multiple values are treated with `OR` logic, and absence of a value indicates no filtering by tag is desired.
+     * @param options.parameters.expand - Optional parameter to expand response with additional fields.
+     Accepts an array of field names to include in the response.
+     Currently supports:
+     - "consentStatus": Include consent status information in the response
+     
+     Future expansions may include additional fields.
+     
      * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
      *
      * @returns A promise of type ConsentSubscriptionResponse.
@@ -415,13 +600,22 @@ declare class ShopperConsents<ConfigParameters extends ShopperConsentsParameters
             siteId: string;
             locale?: LocaleCode$0;
             tags?: Array<string>;
+            expand?: Set<GetSubscriptionsExpandEnum>;
         } & QueryParameters, ConfigParameters>;
         headers?: {
             [key: string]: string;
         };
     }>): Promise<ConsentSubscriptionResponse>;
     /**
-     * Retrieve all subcription preferences for the shopper (authenticated or guest)
+     * Retrieve all subscription preferences for the shopper (authenticated or guest).
+     
+     Use the 'expand' parameter to include additional fields in the response:
+     - expand=["consentStatus"]: Include subscription status information
+     - expand=[]: Default behavior, excludes status for privacy and performance
+     
+     The expand parameter provides privacy benefits by not exposing sensitive status
+     information unless explicitly requested.
+     
      *
      * @param options - An object containing the options for this method.
      * @param options.parameters - An object containing the parameters for this method.
@@ -429,6 +623,13 @@ declare class ShopperConsents<ConfigParameters extends ShopperConsentsParameters
      * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
      * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
      * @param options.parameters.tags - Optional parameter of 0 or more query string values which act as a filtering criteria. Multiple values are treated with `OR` logic, and absence of a value indicates no filtering by tag is desired.
+     * @param options.parameters.expand - Optional parameter to expand response with additional fields.
+     Accepts an array of field names to include in the response.
+     Currently supports:
+     - "consentStatus": Include consent status information in the response
+     
+     Future expansions may include additional fields.
+     
      * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
      * @param rawResponse - Set to true to return entire Response object instead of DTO.
      *
@@ -440,13 +641,14 @@ declare class ShopperConsents<ConfigParameters extends ShopperConsentsParameters
             siteId: string;
             locale?: LocaleCode$0;
             tags?: Array<string>;
+            expand?: Set<GetSubscriptionsExpandEnum>;
         } & QueryParameters, ConfigParameters>;
         headers?: {
             [key: string]: string;
         };
     }>, rawResponse?: T): Promise<T extends true ? Response : ConsentSubscriptionResponse>;
     /**
-     * Update the consent status for a given subscription.
+     * Update the consent status for a single subscription.
      *
      * If you would like to get a raw Response object use the other updateSubscription function.
      *
@@ -458,7 +660,7 @@ declare class ShopperConsents<ConfigParameters extends ShopperConsentsParameters
      * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
      * @param options.body - The data to send as the request body.
      *
-     * @returns A promise of type ConsentSubscription.
+     * @returns A promise of type ConsentSubscriptionUpdateResponse.
      */
     updateSubscription(options: RequireParametersUnlessAllAreOptional<{
         parameters?: CompositeParameters<{
@@ -470,9 +672,9 @@ declare class ShopperConsents<ConfigParameters extends ShopperConsentsParameters
             [key: string]: string;
         };
         body: ConsentSubscriptionRequest & CustomRequestBody;
-    }>): Promise<ConsentSubscription>;
+    }>): Promise<ConsentSubscriptionUpdateResponse>;
     /**
-     * Update the consent status for a given subscription.
+     * Update the consent status for a single subscription.
      *
      * @param options - An object containing the options for this method.
      * @param options.parameters - An object containing the parameters for this method.
@@ -483,7 +685,7 @@ declare class ShopperConsents<ConfigParameters extends ShopperConsentsParameters
      * @param options.body - The data to send as the request body.
      * @param rawResponse - Set to true to return entire Response object instead of DTO.
      *
-     * @returns A promise of type Response if rawResponse is true, a promise of type ConsentSubscription otherwise.
+     * @returns A promise of type Response if rawResponse is true, a promise of type ConsentSubscriptionUpdateResponse otherwise.
      */
     updateSubscription<T extends boolean>(options: RequireParametersUnlessAllAreOptional<{
         parameters?: CompositeParameters<{
@@ -495,7 +697,58 @@ declare class ShopperConsents<ConfigParameters extends ShopperConsentsParameters
             [key: string]: string;
         };
         body: ConsentSubscriptionRequest & CustomRequestBody;
-    }>, rawResponse?: T): Promise<T extends true ? Response : ConsentSubscription>;
+    }>, rawResponse?: T): Promise<T extends true ? Response : ConsentSubscriptionUpdateResponse>;
+    /**
+     * Update the consent status for multiple subscriptions in a single bulk request. Supports 1-50 subscription updates per request with partial success handling.
+     *
+     * If you would like to get a raw Response object use the other updateSubscriptions function.
+     *
+     * @param options - An object containing the options for this method.
+     * @param options.parameters - An object containing the parameters for this method.
+     * @param options.parameters.organizationId - An identifier for the organization the request is being made by
+     * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
+     * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
+     * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
+     * @param options.body - The data to send as the request body.
+     *
+     * @returns A promise of type ConsentSubscriptionBulkResponse.
+     */
+    updateSubscriptions(options: RequireParametersUnlessAllAreOptional<{
+        parameters?: CompositeParameters<{
+            organizationId: string;
+            siteId: string;
+            locale?: LocaleCode$0;
+        } & QueryParameters, ConfigParameters>;
+        headers?: {
+            [key: string]: string;
+        };
+        body: ConsentSubscriptionBulkRequest & CustomRequestBody;
+    }>): Promise<ConsentSubscriptionBulkResponse>;
+    /**
+     * Update the consent status for multiple subscriptions in a single bulk request. Supports 1-50 subscription updates per request with partial success handling.
+     *
+     * @param options - An object containing the options for this method.
+     * @param options.parameters - An object containing the parameters for this method.
+     * @param options.parameters.organizationId - An identifier for the organization the request is being made by
+     * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
+     * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
+     * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
+     * @param options.body - The data to send as the request body.
+     * @param rawResponse - Set to true to return entire Response object instead of DTO.
+     *
+     * @returns A promise of type Response if rawResponse is true, a promise of type ConsentSubscriptionBulkResponse otherwise.
+     */
+    updateSubscriptions<T extends boolean>(options: RequireParametersUnlessAllAreOptional<{
+        parameters?: CompositeParameters<{
+            organizationId: string;
+            siteId: string;
+            locale?: LocaleCode$0;
+        } & QueryParameters, ConfigParameters>;
+        headers?: {
+            [key: string]: string;
+        };
+        body: ConsentSubscriptionBulkRequest & CustomRequestBody;
+    }>, rawResponse?: T): Promise<T extends true ? Response : ConsentSubscriptionBulkResponse>;
 }
 declare namespace ShopperConsentsApiTypes {
     /*
@@ -606,14 +859,33 @@ declare namespace ShopperConsentsApiTypes {
         constructor(config: ClientConfigInit<Params>);
         static readonly defaults: Pick<Required<ClientConfigInit<never>>, "transformRequest">;
     }
+    /**
+     *
+     */
+    type ChannelType = "email" | "sms" | "whatsapp";
     /**
      * The consent status of the subscription as supplied or recorded by this system
      */
     type ConsentStatus = "opt_in" | "opt_out";
     /**
+     * @type SubscriptionStatusEntry: Individual subscription status entry for a specific channel
+     *
+     * @property channel:
+     *
+     * @property contactPointValue: The customer\'s contact point value, polymorphic based on the channel type as below: - `sms` - Subject\'s phone number in E.164 format, ex: `+1 424 535 3546` - `email` - Subject\'s email address in RFC 5321 & RFC 5322 format, ex: `jack.sparrow@salesforce.com`
+     * - **Min Length:** 3
+     * - **Max Length:** 320
+     *
+     * @property status:
      *
      */
-    type SubscriptionChannel = "email" | "sms" | "push_notification" | "in_app" | "postal_mail" | "whatsapp";
+    type SubscriptionStatusEntry = {
+        channel: ChannelType;
+        contactPointValue: string;
+        status: ConsentStatus;
+    } & {
+        [key: string]: any;
+    };
     /**
      * @type ConsentSubscription:
      *
@@ -622,41 +894,42 @@ declare namespace ShopperConsentsApiTypes {
      * - **Min Length:** 1
      * - **Max Length:** 255
      *
-     * @property consentId: Identifier for the shopper communication subscription consent -- formatted as `<contactPointValue>#<communicationSubscriptionChannelId>`
-     * - **Min Length:** 19
-     * - **Max Length:** 339
+     * @property channels:
      *
-     * @property contactPointValue: The customer\'s contact point value, polymorphic based on the channel type as below: - `sms` - Subject\'s phone number in E.164 format, ex: `+1 424 535 3546` - `email` - Subject\'s email address in RFC 5321 & RFC 5322 format, ex: `jack.sparrow@salesforce.com`
-     * - **Min Length:** 3
-     * - **Max Length:** 320
-     *
-     * @property channel:
-     *
-     * @property status:
+     * @property consentStatus: Array of subscription status entries for different channels
      *
-     * @property title:
+     * @property title: The localized title of the subscription for shopper displays
      * - **Min Length:** 1
      * - **Max Length:** 255
      *
-     * @property subtitle:
+     * @property subtitle: The localized subtitle of the subscription for shopper displays, may contain HTML markup
      * - **Min Length:** 1
-     * - **Max Length:** 255
+     * - **Max Length:** 2000
      *
      * @property tags:
      *
+     * @property consentType: Type of consent subscription
+     *
+     * @property consentRequired: Whether this subscription is mandatory for the user
+     *
+     * @property defaultStatus: Default consent status for this subscription
+     *
      */
     type ConsentSubscription = {
         subscriptionId: string;
-        consentId?: string;
-        contactPointValue?: string;
-        channel: SubscriptionChannel;
-        status?: ConsentStatus;
+        channels: Set<ChannelType>;
+        consentStatus?: Array<SubscriptionStatusEntry>;
         title?: string;
         subtitle?: string;
         tags?: Array<string>;
+        consentType?: ConsentSubscriptionConsentTypeEnum;
+        consentRequired?: boolean;
+        defaultStatus?: ConsentSubscriptionDefaultStatusEnum;
     } & {
         [key: string]: any;
     };
+    type ConsentSubscriptionConsentTypeEnum = "marketing" | "legal";
+    type ConsentSubscriptionDefaultStatusEnum = "opt_in" | "opt_out";
     /**
      * @type ConsentSubscriptionRequest: Consent subscription update request
      *
@@ -677,8 +950,80 @@ declare namespace ShopperConsentsApiTypes {
     type ConsentSubscriptionRequest = {
         subscriptionId: string;
         contactPointValue: string;
-        channel: SubscriptionChannel;
+        channel: ChannelType;
+        status: ConsentStatus;
+    } & {
+        [key: string]: any;
+    };
+    /**
+     * @type ConsentSubscriptionBulkRequest: Bulk request for updating multiple consent subscriptions
+     *
+     * @property subscriptions: Array of subscription consent updates to process
+     *
+     */
+    type ConsentSubscriptionBulkRequest = {
+        subscriptions: Array<ConsentSubscriptionRequest>;
+    } & {
+        [key: string]: any;
+    };
+    /**
+     * @type ConsentSubscriptionError: Error details for failed subscription updates
+     *
+     * @property code: Error code indicating the type of failure
+     * - **Max Length:** 100
+     *
+     * @property message: Human-readable error message
+     * - **Max Length:** 500
+     *
+     * @property details: Additional error details
+     *
+     */
+    type ConsentSubscriptionError = {
+        code: string;
+        message: string;
+        details?: object;
+    } & {
+        [key: string]: any;
+    };
+    /**
+     * @type ConsentSubscriptionResult: Individual subscription update result with input parameters
+     *
+     * @property subscriptionId: Identifier for the communication subscription
+     * - **Pattern:** /^[a-z0-9]+(?:-[a-z0-9]+)*$/
+     * - **Min Length:** 1
+     * - **Max Length:** 255
+     *
+     * @property channel:
+     *
+     * @property contactPointValue: The customer\'s contact point value, polymorphic based on the channel type as below: - `sms` - Subject\'s phone number in E.164 format, ex: `+1 424 535 3546` - `email` - Subject\'s email address in RFC 5321 & RFC 5322 format, ex: `jack.sparrow@salesforce.com`
+     * - **Min Length:** 3
+     * - **Max Length:** 320
+     *
+     * @property status:
+     *
+     * @property success: Whether the subscription update was successful
+     *
+     * @property error:
+     *
+     */
+    type ConsentSubscriptionResult = {
+        subscriptionId: string;
+        channel: ChannelType;
+        contactPointValue: string;
         status: ConsentStatus;
+        success: boolean;
+        error?: ConsentSubscriptionError;
+    } & {
+        [key: string]: any;
+    };
+    /**
+     * @type ConsentSubscriptionBulkResponse: Bulk response with results for each subscription update request
+     *
+     * @property results: Results for each subscription update request
+     *
+     */
+    type ConsentSubscriptionBulkResponse = {
+        results: Array<ConsentSubscriptionResult>;
     } & {
         [key: string]: any;
     };
@@ -693,6 +1038,31 @@ declare namespace ShopperConsentsApiTypes {
     } & {
         [key: string]: any;
     };
+    /**
+     * @type ConsentSubscriptionUpdateResponse: Single subscription update response
+     *
+     * @property subscriptionId: Identifier for the communication subscription
+     * - **Pattern:** /^[a-z0-9]+(?:-[a-z0-9]+)*$/
+     * - **Min Length:** 1
+     * - **Max Length:** 255
+     *
+     * @property channel:
+     *
+     * @property contactPointValue: The customer\'s contact point value, polymorphic based on the channel type as below: - `sms` - Subject\'s phone number in E.164 format, ex: `+1 424 535 3546` - `email` - Subject\'s email address in RFC 5321 & RFC 5322 format, ex: `jack.sparrow@salesforce.com`
+     * - **Min Length:** 3
+     * - **Max Length:** 320
+     *
+     * @property status:
+     *
+     */
+    type ConsentSubscriptionUpdateResponse = {
+        subscriptionId: string;
+        channel: ChannelType;
+        contactPointValue: string;
+        status: ConsentStatus;
+    } & {
+        [key: string]: any;
+    };
     /**
      * A specialized value indicating the system default values for locales.
      */
@@ -725,10 +1095,12 @@ declare namespace ShopperConsentsApiTypes {
      * A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
      */
     type LocaleCode$0 = DefaultFallback | string;
+    type GetSubscriptionsExpandEnum = "consentStatus";
     type getSubscriptionsQueryParameters = {
         siteId: string;
         locale?: LocaleCode$0;
         tags?: Array<string>;
+        expand?: Set<"consentStatus">;
     };
     type getSubscriptionsPathParameters = {
         organizationId: string;
@@ -740,14 +1112,21 @@ declare namespace ShopperConsentsApiTypes {
     type updateSubscriptionPathParameters = {
         organizationId: string;
     };
+    type updateSubscriptionsQueryParameters = {
+        siteId: string;
+        locale?: LocaleCode$0;
+    };
+    type updateSubscriptionsPathParameters = {
+        organizationId: string;
+    };
     /**
      * All path parameters that are used by at least one ShopperConsents method.
      */
-    type ShopperConsentsPathParameters = Partial<getSubscriptionsPathParameters & updateSubscriptionPathParameters & {}>;
+    type ShopperConsentsPathParameters = Partial<getSubscriptionsPathParameters & updateSubscriptionPathParameters & updateSubscriptionsPathParameters & {}>;
     /**
      * All query parameters that are used by at least one ShopperConsents method.
      */
-    type ShopperConsentsQueryParameters = Partial<getSubscriptionsQueryParameters & updateSubscriptionQueryParameters & {}>;
+    type ShopperConsentsQueryParameters = Partial<getSubscriptionsQueryParameters & updateSubscriptionQueryParameters & updateSubscriptionsQueryParameters & {}>;
     /**
      * All parameters that are used by ShopperConsents.
      */
@@ -756,18 +1135,21 @@ declare namespace ShopperConsentsApiTypes {
      * [Shopper Consents](https://developer.salesforce.com/docs/commerce/commerce-api/references?meta=shopper-consents:Summary)
      * ==================================
      *
-     * *# Shopper Consent
+     * *[Download API specification](https://developer.salesforce.com/static/commercecloud/commerce-api/shopper-consents/shopper-consents-oas-v1-public.yaml)
      
-     ## API Overview
+     # API Overview
      
      The Shopper Consent API offers a centralized method for managing shopper consent. With this API, shoppers can view and update subscription preferences for marketing communications across various channels. This API controls how and where shoppers receive marketing messages while ensuring compliance with privacy regulations.
      
      ## Key Features
      
-     - Multi-Channel Support: Manage communication subscriptions across email, SMS, push notifications, in-app messages, and postal mail.
-     - Organization-Based Management: Isolate consent preferences by organization for multi-tenant environments.
-     - Real-Time Updates: Instantly create and retrieve subscription preferences.
-     - Compliance Ready: Built with privacy regulations and consent-management best practices in mind.
+     - **Retrieve communication subscriptions**: Retrieve relevant communication subscription options with rich display information.
+     - Communication subscription options can be filtered by one or more qualifying tags.
+     - Use the `expand` parameter to conditionally include subscription status.
+     - **Update individual subscription consent**: Update consent status for a single subscription with simple request/response pattern.
+     - **Bulk subscription updates**: Efficiently manage multiple subscription preferences with a single request.
+     - Update 1-50 subscriptions per bulk request.
+     - Partial success handling with detailed error reporting for failed updates.
      
      ## Authentication & Authorization
      
@@ -780,68 +1162,98 @@ declare namespace ShopperConsentsApiTypes {
      ### Required Scopes
      
      - `sfcc.shopper-consents`: Required for reading communication subscription data (GET operations).
-     - `sfcc.shopper-consents.rw`: Required for creating and modifying communication subscription data (POST operations).
-     
-     ## Use Cases
-     
-     ### Shopper Subscription Management
-     - Retrieve communication subscriptions: Retrieve relevant communication subscription options with display information.
-     - Guest shoppers can retrieve communication subscriptions options without pre-defined shopper credentials, for example: email address, phone number.
-     - Authenticated shoppers can retrieve communication subscription options available to their shopper credentials.
-     - Communication subscription options can be filtered by one or more qualifying tags.
-     - Update communication subscription consent preferences.
+     - `sfcc.shopper-consents.rw`: Required for creating and modifying communication subscription consent data (POST operations).
      
      ## Data Model
      
      ### Subscriptions
      Subscriptions represent a shopper's consent to receive specific types of marketing communications. Each subscription includes:
      
-     - Identifier: Descriptive identifier
-     - Consent Status: Opt-in or opt-out
-     - Display Information: Title, subtitle, and description for customer-facing interfaces
-     - Tags: Categorical tags indicating where the subscription option can appear
-     - Channels: Supported communication methods, such as email, SMS, push notification
+     - **Subscription Id**: Descriptive identifier
+     - **Channels**: Array of communication methods - Email, SMS, or WhatsApp
+     - **Consent Type**: Marketing or legal subscription classification
+     - **Consent Required**: Whether the subscription is mandatory for the shopper
+     - **Default Status**: Default opt-in or opt-out behavior
+     - **Consent Status**: Array of status entries for each channel showing current opt-in or opt-out status (conditionally returned based on expand parameter)
+     - **Rich Display Information**:
+     - Title: Simple localized string for subscription name
+     - Subtitle: Simple localized string with HTML markup support for descriptions
+     - Localized content determined by the locale parameter
+     - **Tags**: Categorical tags indicating where the subscription option can appear (defaults to empty array, max 10 tags)
      
      ### Channels
      Channels define the communication methods available for a subscription:
      - `email`: Email communications
      - `sms`: SMS/text messages
-     - `whatsapp`: WhatsApp
+     - `whatsapp`: WhatsApp messaging
      
      ### Tags
      Tags indicate where subscription options are displayed in your shopper experience. Tags are also accepted as optional filtering parameters in the retrieval of shopper consent subscriptions. For example:
      - `homepage_banner`: Main website homepage
-     - `registration`: Shopper registration process
-     - `checkout`: Checkout process
-     - `user_profile`: User profile management area
+     - `registration`: Shopper registration form
+     - `checkout`: Checkout flow
+     - `user_profile`: User profile management section
      
-     ## Best Practices
+     ### Default Values
+     The API provides sensible defaults for optional fields to simplify integration:
+     - **Consent Type**: Defaults to "marketing" for marketing communications
+     - **Consent Required**: Defaults to false, making subscriptions optional by default
+     - **Default Status**: Defaults to "opt_out" to respect privacy-first principles
+     - **Tags**: Defaults to an empty array when not specified
      
-     ### User Experience
-     - Make it easy for shoppers to update their preferences.
-     - Respect shopper choices immediately.
+     ## Advanced Features
      
-     ### Implementation Guidelines
-     - Implement clear and prominent unsubscribe mechanisms.
+     ### Expand Parameter
+     The `expand` parameter provides conditional field inclusion:
+     - `expand=[]` (default): Returns basic subscription information
+     - `expand=["consentStatus"]`: Include consent status information in the response
+     - Future expansion may include additional fields
+     
+     ### Single Subscription Updates
+     Update consent for one subscription at a time:
+     - **Endpoint**: `POST /organizations/{organizationId}/subscriptions`
+     - **Request**: Requires subscriptionId, contactPointValue, channel, and status
+     - **Response**: Returns the same parameters on success (HTTP 200)
+     - **Use Case**: Ideal for real-time updates as shoppers interact with individual preferences
      
-     ### Compliance Considerations
-     - Ensure consent is freely given, specific, informed, and unambiguous.
-     - Implement proper data retention and deletion policies.
-     - Provide easy access to consent history and preferences.
+     ### Bulk Operations
+     Efficiently manage multiple subscription preferences in a single request:
+     - **Endpoint**: `POST /organizations/{organizationId}/subscriptions/actions/bulk`
+     - **Request Limits**: 1-50 subscriptions per bulk request
+     - **Response Handling**:
+     - HTTP 200: All updates successful
+     - HTTP 207 Multi-Status: Partial success with detailed error reporting
+     - HTTP 400: Request validation failure
+     - **Error Isolation**: Failed updates don't affect successful ones
+     - **Individual Results**: Each subscription update returns:
+     - Original input parameters (subscriptionId, contactPointValue, channel, status)
+     - Success/failure status
+     - Detailed error information for failed updates
+     - No full subscription objects returned for improved performance
      
      ## Error Handling
      
      The API uses standard HTTP status codes and returns detailed error information to help with troubleshooting:
      
-     - `400 Bad Request`: Invalid request format or missing required fields
-     - `401 Unauthorized`: Invalid or missing authentication token
-     - `403 Forbidden`: Insufficient permissions for the requested operation
-     - `404 Not Found`: Requested organization or resource not found
-     - `500 Internal Server Error`: Unexpected server error
+     - `200 OK`: Successful operation (single or bulk with all successes)
+     - `207 Multi-Status`: Bulk operation with partial success
+     - `400 Bad Request`: Invalid request format, missing required fields, or markup validation errors
      
-     ## Rate Limits
+     ## Best Practices
+     
+     ### User Experience
+     - Make it easy for shoppers to update their preferences.
+     - Respect shopper choices immediately.
+     
+     ### Implementation Guidelines
+     - Implement clear and prominent unsubscribe mechanisms.
+     - Validate HTML markup content to prevent XSS vulnerabilities.
+     - Handle partial success scenarios gracefully in bulk operations.
      
-     To ensure fair usage and system stability, the Shopper Consent API implements rate limiting. Refer to the response headers for current rate limit status and adjust your integration accordingly.*<br />
+     ### Performance Considerations
+     - Use single subscription updates for real-time, interactive preference changes.
+     - Use bulk operations when updating multiple subscriptions to reduce API calls and improve performance.
+     - Only request status information when needed using the expand parameter to reduce latency.*<br />
      *
      * Simple example:
      *
@@ -875,6 +1287,7 @@ declare namespace ShopperConsentsApiTypes {
         static readonly apiPaths: {
             getSubscriptions: string;
             updateSubscription: string;
+            updateSubscriptions: string;
         };
         constructor(config: ClientConfigInit<ConfigParameters>);
         static readonly paramKeys: {
@@ -882,7 +1295,8 @@ declare namespace ShopperConsentsApiTypes {
                 "organizationId",
                 "siteId",
                 "locale",
-                "tags"
+                "tags",
+                "expand"
             ];
             readonly getSubscriptionsRequired: readonly [
                 "organizationId",
@@ -897,9 +1311,26 @@ declare namespace ShopperConsentsApiTypes {
                 "organizationId",
                 "siteId"
             ];
+            readonly updateSubscriptions: readonly [
+                "organizationId",
+                "siteId",
+                "locale"
+            ];
+            readonly updateSubscriptionsRequired: readonly [
+                "organizationId",
+                "siteId"
+            ];
         };
         /**
-         * Retrieve all subcription preferences for the shopper (authenticated or guest)
+         * Retrieve all subscription preferences for the shopper (authenticated or guest).
+         
+         Use the 'expand' parameter to include additional fields in the response:
+         - expand=["consentStatus"]: Include subscription status information
+         - expand=[]: Default behavior, excludes status for privacy and performance
+         
+         The expand parameter provides privacy benefits by not exposing sensitive status
+         information unless explicitly requested.
+         
          *
          * If you would like to get a raw Response object use the other getSubscriptions function.
          *
@@ -909,6 +1340,13 @@ declare namespace ShopperConsentsApiTypes {
          * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
          * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
          * @param options.parameters.tags - Optional parameter of 0 or more query string values which act as a filtering criteria. Multiple values are treated with `OR` logic, and absence of a value indicates no filtering by tag is desired.
+         * @param options.parameters.expand - Optional parameter to expand response with additional fields.
+         Accepts an array of field names to include in the response.
+         Currently supports:
+         - "consentStatus": Include consent status information in the response
+         
+         Future expansions may include additional fields.
+         
          * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
          *
          * @returns A promise of type ConsentSubscriptionResponse.
@@ -919,13 +1357,22 @@ declare namespace ShopperConsentsApiTypes {
                 siteId: string;
                 locale?: LocaleCode$0;
                 tags?: Array<string>;
+                expand?: Set<GetSubscriptionsExpandEnum>;
             } & QueryParameters, ConfigParameters>;
             headers?: {
                 [key: string]: string;
             };
         }>): Promise<ConsentSubscriptionResponse>;
         /**
-         * Retrieve all subcription preferences for the shopper (authenticated or guest)
+         * Retrieve all subscription preferences for the shopper (authenticated or guest).
+         
+         Use the 'expand' parameter to include additional fields in the response:
+         - expand=["consentStatus"]: Include subscription status information
+         - expand=[]: Default behavior, excludes status for privacy and performance
+         
+         The expand parameter provides privacy benefits by not exposing sensitive status
+         information unless explicitly requested.
+         
          *
          * @param options - An object containing the options for this method.
          * @param options.parameters - An object containing the parameters for this method.
@@ -933,6 +1380,13 @@ declare namespace ShopperConsentsApiTypes {
          * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
          * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
          * @param options.parameters.tags - Optional parameter of 0 or more query string values which act as a filtering criteria. Multiple values are treated with `OR` logic, and absence of a value indicates no filtering by tag is desired.
+         * @param options.parameters.expand - Optional parameter to expand response with additional fields.
+         Accepts an array of field names to include in the response.
+         Currently supports:
+         - "consentStatus": Include consent status information in the response
+         
+         Future expansions may include additional fields.
+         
          * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
          * @param rawResponse - Set to true to return entire Response object instead of DTO.
          *
@@ -944,13 +1398,14 @@ declare namespace ShopperConsentsApiTypes {
                 siteId: string;
                 locale?: LocaleCode$0;
                 tags?: Array<string>;
+                expand?: Set<GetSubscriptionsExpandEnum>;
             } & QueryParameters, ConfigParameters>;
             headers?: {
                 [key: string]: string;
             };
         }>, rawResponse?: T): Promise<T extends true ? Response : ConsentSubscriptionResponse>;
         /**
-         * Update the consent status for a given subscription.
+         * Update the consent status for a single subscription.
          *
          * If you would like to get a raw Response object use the other updateSubscription function.
          *
@@ -962,7 +1417,7 @@ declare namespace ShopperConsentsApiTypes {
          * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
          * @param options.body - The data to send as the request body.
          *
-         * @returns A promise of type ConsentSubscription.
+         * @returns A promise of type ConsentSubscriptionUpdateResponse.
          */
         updateSubscription(options: RequireParametersUnlessAllAreOptional<{
             parameters?: CompositeParameters<{
@@ -974,9 +1429,9 @@ declare namespace ShopperConsentsApiTypes {
                 [key: string]: string;
             };
             body: ConsentSubscriptionRequest & CustomRequestBody;
-        }>): Promise<ConsentSubscription>;
+        }>): Promise<ConsentSubscriptionUpdateResponse>;
         /**
-         * Update the consent status for a given subscription.
+         * Update the consent status for a single subscription.
          *
          * @param options - An object containing the options for this method.
          * @param options.parameters - An object containing the parameters for this method.
@@ -987,7 +1442,7 @@ declare namespace ShopperConsentsApiTypes {
          * @param options.body - The data to send as the request body.
          * @param rawResponse - Set to true to return entire Response object instead of DTO.
          *
-         * @returns A promise of type Response if rawResponse is true, a promise of type ConsentSubscription otherwise.
+         * @returns A promise of type Response if rawResponse is true, a promise of type ConsentSubscriptionUpdateResponse otherwise.
          */
         updateSubscription<T extends boolean>(options: RequireParametersUnlessAllAreOptional<{
             parameters?: CompositeParameters<{
@@ -999,18 +1454,88 @@ declare namespace ShopperConsentsApiTypes {
                 [key: string]: string;
             };
             body: ConsentSubscriptionRequest & CustomRequestBody;
-        }>, rawResponse?: T): Promise<T extends true ? Response : ConsentSubscription>;
+        }>, rawResponse?: T): Promise<T extends true ? Response : ConsentSubscriptionUpdateResponse>;
+        /**
+         * Update the consent status for multiple subscriptions in a single bulk request. Supports 1-50 subscription updates per request with partial success handling.
+         *
+         * If you would like to get a raw Response object use the other updateSubscriptions function.
+         *
+         * @param options - An object containing the options for this method.
+         * @param options.parameters - An object containing the parameters for this method.
+         * @param options.parameters.organizationId - An identifier for the organization the request is being made by
+         * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
+         * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
+         * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
+         * @param options.body - The data to send as the request body.
+         *
+         * @returns A promise of type ConsentSubscriptionBulkResponse.
+         */
+        updateSubscriptions(options: RequireParametersUnlessAllAreOptional<{
+            parameters?: CompositeParameters<{
+                organizationId: string;
+                siteId: string;
+                locale?: LocaleCode$0;
+            } & QueryParameters, ConfigParameters>;
+            headers?: {
+                [key: string]: string;
+            };
+            body: ConsentSubscriptionBulkRequest & CustomRequestBody;
+        }>): Promise<ConsentSubscriptionBulkResponse>;
+        /**
+         * Update the consent status for multiple subscriptions in a single bulk request. Supports 1-50 subscription updates per request with partial success handling.
+         *
+         * @param options - An object containing the options for this method.
+         * @param options.parameters - An object containing the parameters for this method.
+         * @param options.parameters.organizationId - An identifier for the organization the request is being made by
+         * @param options.parameters.siteId - The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.
+         * @param options.parameters.locale - A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.
+         * @param options.headers - An object literal of key value pairs of the headers to be sent with this request.
+         * @param options.body - The data to send as the request body.
+         * @param rawResponse - Set to true to return entire Response object instead of DTO.
+         *
+         * @returns A promise of type Response if rawResponse is true, a promise of type ConsentSubscriptionBulkResponse otherwise.
+         */
+        updateSubscriptions<T extends boolean>(options: RequireParametersUnlessAllAreOptional<{
+            parameters?: CompositeParameters<{
+                organizationId: string;
+                siteId: string;
+                locale?: LocaleCode$0;
+            } & QueryParameters, ConfigParameters>;
+            headers?: {
+                [key: string]: string;
+            };
+            body: ConsentSubscriptionBulkRequest & CustomRequestBody;
+        }>, rawResponse?: T): Promise<T extends true ? Response : ConsentSubscriptionBulkResponse>;
     }
 }
 declare namespace ShopperConsentsModelTypes {
+    /**
+     *
+     */
+    type ChannelType = "email" | "sms" | "whatsapp";
     /**
      * The consent status of the subscription as supplied or recorded by this system
      */
     type ConsentStatus = "opt_in" | "opt_out";
     /**
+     * @type SubscriptionStatusEntry: Individual subscription status entry for a specific channel
+     *
+     * @property channel:
+     *
+     * @property contactPointValue: The customer\'s contact point value, polymorphic based on the channel type as below: - `sms` - Subject\'s phone number in E.164 format, ex: `+1 424 535 3546` - `email` - Subject\'s email address in RFC 5321 & RFC 5322 format, ex: `jack.sparrow@salesforce.com`
+     * - **Min Length:** 3
+     * - **Max Length:** 320
+     *
+     * @property status:
      *
      */
-    type SubscriptionChannel = "email" | "sms" | "push_notification" | "in_app" | "postal_mail" | "whatsapp";
+    type SubscriptionStatusEntry = {
+        channel: ChannelType;
+        contactPointValue: string;
+        status: ConsentStatus;
+    } & {
+        [key: string]: any;
+    };
     /**
      * @type ConsentSubscription:
      *
@@ -1019,41 +1544,42 @@ declare namespace ShopperConsentsModelTypes {
      * - **Min Length:** 1
      * - **Max Length:** 255
      *
-     * @property consentId: Identifier for the shopper communication subscription consent -- formatted as `<contactPointValue>#<communicationSubscriptionChannelId>`
-     * - **Min Length:** 19
-     * - **Max Length:** 339
-     *
-     * @property contactPointValue: The customer\'s contact point value, polymorphic based on the channel type as below: - `sms` - Subject\'s phone number in E.164 format, ex: `+1 424 535 3546` - `email` - Subject\'s email address in RFC 5321 & RFC 5322 format, ex: `jack.sparrow@salesforce.com`
-     * - **Min Length:** 3
-     * - **Max Length:** 320
-     *
-     * @property channel:
+     * @property channels:
      *
-     * @property status:
+     * @property consentStatus: Array of subscription status entries for different channels
      *
-     * @property title:
+     * @property title: The localized title of the subscription for shopper displays
      * - **Min Length:** 1
      * - **Max Length:** 255
      *
-     * @property subtitle:
+     * @property subtitle: The localized subtitle of the subscription for shopper displays, may contain HTML markup
      * - **Min Length:** 1
-     * - **Max Length:** 255
+     * - **Max Length:** 2000
      *
      * @property tags:
      *
+     * @property consentType: Type of consent subscription
+     *
+     * @property consentRequired: Whether this subscription is mandatory for the user
+     *
+     * @property defaultStatus: Default consent status for this subscription
+     *
      */
     type ConsentSubscription = {
         subscriptionId: string;
-        consentId?: string;
-        contactPointValue?: string;
-        channel: SubscriptionChannel;
-        status?: ConsentStatus;
+        channels: Set<ChannelType>;
+        consentStatus?: Array<SubscriptionStatusEntry>;
         title?: string;
         subtitle?: string;
         tags?: Array<string>;
+        consentType?: ConsentSubscriptionConsentTypeEnum;
+        consentRequired?: boolean;
+        defaultStatus?: ConsentSubscriptionDefaultStatusEnum;
     } & {
         [key: string]: any;
     };
+    type ConsentSubscriptionConsentTypeEnum = "marketing" | "legal";
+    type ConsentSubscriptionDefaultStatusEnum = "opt_in" | "opt_out";
     /**
      * @type ConsentSubscriptionRequest: Consent subscription update request
      *
@@ -1074,8 +1600,80 @@ declare namespace ShopperConsentsModelTypes {
     type ConsentSubscriptionRequest = {
         subscriptionId: string;
         contactPointValue: string;
-        channel: SubscriptionChannel;
+        channel: ChannelType;
+        status: ConsentStatus;
+    } & {
+        [key: string]: any;
+    };
+    /**
+     * @type ConsentSubscriptionBulkRequest: Bulk request for updating multiple consent subscriptions
+     *
+     * @property subscriptions: Array of subscription consent updates to process
+     *
+     */
+    type ConsentSubscriptionBulkRequest = {
+        subscriptions: Array<ConsentSubscriptionRequest>;
+    } & {
+        [key: string]: any;
+    };
+    /**
+     * @type ConsentSubscriptionError: Error details for failed subscription updates
+     *
+     * @property code: Error code indicating the type of failure
+     * - **Max Length:** 100
+     *
+     * @property message: Human-readable error message
+     * - **Max Length:** 500
+     *
+     * @property details: Additional error details
+     *
+     */
+    type ConsentSubscriptionError = {
+        code: string;
+        message: string;
+        details?: object;
+    } & {
+        [key: string]: any;
+    };
+    /**
+     * @type ConsentSubscriptionResult: Individual subscription update result with input parameters
+     *
+     * @property subscriptionId: Identifier for the communication subscription
+     * - **Pattern:** /^[a-z0-9]+(?:-[a-z0-9]+)*$/
+     * - **Min Length:** 1
+     * - **Max Length:** 255
+     *
+     * @property channel:
+     *
+     * @property contactPointValue: The customer\'s contact point value, polymorphic based on the channel type as below: - `sms` - Subject\'s phone number in E.164 format, ex: `+1 424 535 3546` - `email` - Subject\'s email address in RFC 5321 & RFC 5322 format, ex: `jack.sparrow@salesforce.com`
+     * - **Min Length:** 3
+     * - **Max Length:** 320
+     *
+     * @property status:
+     *
+     * @property success: Whether the subscription update was successful
+     *
+     * @property error:
+     *
+     */
+    type ConsentSubscriptionResult = {
+        subscriptionId: string;
+        channel: ChannelType;
+        contactPointValue: string;
         status: ConsentStatus;
+        success: boolean;
+        error?: ConsentSubscriptionError;
+    } & {
+        [key: string]: any;
+    };
+    /**
+     * @type ConsentSubscriptionBulkResponse: Bulk response with results for each subscription update request
+     *
+     * @property results: Results for each subscription update request
+     *
+     */
+    type ConsentSubscriptionBulkResponse = {
+        results: Array<ConsentSubscriptionResult>;
     } & {
         [key: string]: any;
     };
@@ -1090,6 +1688,31 @@ declare namespace ShopperConsentsModelTypes {
     } & {
         [key: string]: any;
     };
+    /**
+     * @type ConsentSubscriptionUpdateResponse: Single subscription update response
+     *
+     * @property subscriptionId: Identifier for the communication subscription
+     * - **Pattern:** /^[a-z0-9]+(?:-[a-z0-9]+)*$/
+     * - **Min Length:** 1
+     * - **Max Length:** 255
+     *
+     * @property channel:
+     *
+     * @property contactPointValue: The customer\'s contact point value, polymorphic based on the channel type as below: - `sms` - Subject\'s phone number in E.164 format, ex: `+1 424 535 3546` - `email` - Subject\'s email address in RFC 5321 & RFC 5322 format, ex: `jack.sparrow@salesforce.com`
+     * - **Min Length:** 3
+     * - **Max Length:** 320
+     *
+     * @property status:
+     *
+     */
+    type ConsentSubscriptionUpdateResponse = {
+        subscriptionId: string;
+        channel: ChannelType;
+        contactPointValue: string;
+        status: ConsentStatus;
+    } & {
+        [key: string]: any;
+    };
     /**
      * A specialized value indicating the system default values for locales.
      */
@@ -1126,17 +1749,28 @@ declare namespace ShopperConsentsModelTypes {
 declare namespace ShopperConsentsTypes {
     type ShopperConsentsPathParameters = ShopperConsentsApiTypes.ShopperConsentsPathParameters;
     type ShopperConsentsQueryParameters = ShopperConsentsApiTypes.ShopperConsentsQueryParameters;
+    type GetSubscriptionsExpandEnum = ShopperConsentsApiTypes.GetSubscriptionsExpandEnum;
     type getSubscriptionsQueryParameters = ShopperConsentsApiTypes.getSubscriptionsQueryParameters;
     type getSubscriptionsPathParameters = ShopperConsentsApiTypes.getSubscriptionsPathParameters;
     type updateSubscriptionQueryParameters = ShopperConsentsApiTypes.updateSubscriptionQueryParameters;
     type updateSubscriptionPathParameters = ShopperConsentsApiTypes.updateSubscriptionPathParameters;
+    type updateSubscriptionsQueryParameters = ShopperConsentsApiTypes.updateSubscriptionsQueryParameters;
+    type updateSubscriptionsPathParameters = ShopperConsentsApiTypes.updateSubscriptionsPathParameters;
+    type ChannelType = ShopperConsentsModelTypes.ChannelType;
     type ConsentStatus = ShopperConsentsModelTypes.ConsentStatus;
     type ConsentSubscription = ShopperConsentsModelTypes.ConsentSubscription;
+    type ConsentSubscriptionConsentTypeEnum = ShopperConsentsModelTypes.ConsentSubscriptionConsentTypeEnum;
+    type ConsentSubscriptionDefaultStatusEnum = ShopperConsentsModelTypes.ConsentSubscriptionDefaultStatusEnum;
+    type ConsentSubscriptionBulkRequest = ShopperConsentsModelTypes.ConsentSubscriptionBulkRequest;
+    type ConsentSubscriptionBulkResponse = ShopperConsentsModelTypes.ConsentSubscriptionBulkResponse;
+    type ConsentSubscriptionError = ShopperConsentsModelTypes.ConsentSubscriptionError;
     type ConsentSubscriptionRequest = ShopperConsentsModelTypes.ConsentSubscriptionRequest;
     type ConsentSubscriptionResponse = ShopperConsentsModelTypes.ConsentSubscriptionResponse;
+    type ConsentSubscriptionResult = ShopperConsentsModelTypes.ConsentSubscriptionResult;
+    type ConsentSubscriptionUpdateResponse = ShopperConsentsModelTypes.ConsentSubscriptionUpdateResponse;
     type DefaultFallback = ShopperConsentsModelTypes.DefaultFallback;
     type ErrorResponse = ShopperConsentsModelTypes.ErrorResponse;
     type LocaleCode = ShopperConsentsModelTypes.LocaleCode;
-    type SubscriptionChannel = ShopperConsentsModelTypes.SubscriptionChannel;
+    type SubscriptionStatusEntry = ShopperConsentsModelTypes.SubscriptionStatusEntry;
 }
-export { defaultBaseUri, getSubscriptionsQueryParameters, getSubscriptionsPathParameters, updateSubscriptionQueryParameters, updateSubscriptionPathParameters, ShopperConsentsPathParameters, ShopperConsentsQueryParameters, ShopperConsentsParameters, ShopperConsents, ConsentStatus, ConsentSubscription, ConsentSubscriptionRequest, ConsentSubscriptionResponse, DefaultFallback, ErrorResponse, LocaleCode$0 as LocaleCode, SubscriptionChannel, ShopperConsentsTypes };
+export { defaultBaseUri, GetSubscriptionsExpandEnum, getSubscriptionsQueryParameters, getSubscriptionsPathParameters, updateSubscriptionQueryParameters, updateSubscriptionPathParameters, updateSubscriptionsQueryParameters, updateSubscriptionsPathParameters, ShopperConsentsPathParameters, ShopperConsentsQueryParameters, ShopperConsentsParameters, ShopperConsents, ChannelType, ConsentStatus, ConsentSubscription, ConsentSubscriptionConsentTypeEnum, ConsentSubscriptionDefaultStatusEnum, ConsentSubscriptionBulkRequest, ConsentSubscriptionBulkResponse, ConsentSubscriptionError, ConsentSubscriptionRequest, ConsentSubscriptionResponse, ConsentSubscriptionResult, ConsentSubscriptionUpdateResponse, DefaultFallback, ErrorResponse, LocaleCode$0 as LocaleCode, SubscriptionStatusEntry, ShopperConsentsTypes };