@salesforce/b2c-tooling-sdk 2.0.0 → 2.2.0

package/data/xsd/library.xsd

@@ -171,6 +171,14 @@
                     </xsd:documentation>
                 </xsd:annotation>
             </xsd:element>
+            <xsd:element name="content-tag-assignments" type="complexType.Content.ContentTagAssignments" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                        The content-tag-assignments can be set for pages and components. Each content can be assigned to
+                        multiple tags, and each tag can be assigned to multiple content assets within the same library.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
             <xsd:element name="sitemap-included-flag" type="sharedType.SiteSpecificBoolean" minOccurs="0" maxOccurs="unbounded" nillable="true">
                 <xsd:annotation>
                     <xsd:documentation>
@@ -287,6 +295,29 @@
         <xsd:attribute name="content-id" type="simpleType.Generic.NonEmptyString.256" use="required" />
     </xsd:complexType>
 
+    <!-- ContentTagAssignment -->
+    <xsd:complexType name="complexType.Content.ContentTagAssignments" mixed="false">
+        <xsd:annotation>
+            <xsd:documentation>
+                These assignments represent tags linked to a content asset (page or component). Tags are scoped to
+                the library the content belongs to.
+            </xsd:documentation>
+        </xsd:annotation>
+        <xsd:sequence>
+            <xsd:element name="content-tag-assignment" type="complexType.Content.ContentTagAssignment" minOccurs="0" maxOccurs="unbounded" />
+        </xsd:sequence>
+    </xsd:complexType>
+
+    <xsd:complexType name="complexType.Content.ContentTagAssignment" mixed="false">
+        <xsd:annotation>
+            <xsd:documentation>
+                Represents a single tag assignment. The tag is resolved (or created) by name, case-insensitively,
+                within the library that owns the content.
+            </xsd:documentation>
+        </xsd:annotation>
+        <xsd:attribute name="tag-name" type="simpleType.Generic.NonEmptyString.256" use="required" />
+    </xsd:complexType>
+
     <xsd:simpleType name="simpleType.AssignedObjectType">
         <xsd:restriction base="xsd:string">
             <xsd:enumeration value="category" />

package/data/xsd/order.xsd

@@ -33,6 +33,9 @@
                     fields account-id and account-type are exported. Since version 22.9 details to a 
                     Salesforce Payments payment are no longer exported in a custom method element.
                     Since version 26.5 multi-level tax items can be exported for line items.
+                    Since version 26.9 custom attributes are exported for tax items.
+                    Since version 26.10 payment-details, fraud-decisions and transaction-details
+                    elements can be exported per payment.
                 </xsd:documentation>
             </xsd:annotation>
             <xsd:enumeration value="18.5" />
@@ -45,6 +48,8 @@
             <xsd:enumeration value="22.9" />
             <xsd:enumeration value="23.4" />
             <xsd:enumeration value="26.5" />
+            <xsd:enumeration value="26.9" />
+            <xsd:enumeration value="26.10" />
         </xsd:restriction>
     </xsd:simpleType>
 
@@ -230,6 +235,8 @@
                     <xsd:documentation>Tax amount in purchase currency.</xsd:documentation>
                 </xsd:annotation>
             </xsd:element>
+            <!-- Since 26.9: custom attributes on a tax item -->
+            <xsd:element name="custom-attributes" type="sharedType.CustomAttributes" minOccurs="0"/>
         </xsd:sequence>
     </xsd:complexType>
 
@@ -631,6 +638,23 @@
                 <xsd:element name="custom-method" type="complexType.CustomPaymentMethod" />
             </xsd:choice>
 
+            <xsd:element name="payment-details" type="complexType.PaymentDetails" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    Since version 26.10.
+                    The normalized payment details for the order payment instrument.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="fraud-decisions" type="complexType.FraudDecisions" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    Since version 26.10.
+                    The normalized fraud decisions for the order payment instrument.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+
             <!--  payment transaction details -->
             <xsd:element name="amount" type="xsd:decimal" minOccurs="0" maxOccurs="1"/>
             <xsd:element name="processor-id" type="simpleType.Generic.NonEmptyString.256" minOccurs="0" maxOccurs="1" />
@@ -652,6 +676,14 @@
                     </xsd:documentation>
                 </xsd:annotation>
             </xsd:element>
+            <xsd:element name="transaction-details" type="complexType.TransactionDetails" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    Since version 26.10.
+                    The normalized transaction details for the order payment transaction.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
             <xsd:element name="custom-attributes" type="sharedType.CustomAttributes" minOccurs="0" maxOccurs="1">
                 <xsd:annotation>
                     <xsd:documentation>These are the custom attributes of the PaymentTransaction system object.</xsd:documentation>
@@ -1168,6 +1200,54 @@
         </xsd:restriction>
     </xsd:simpleType>
 
+    <xsd:simpleType name="simpleType.Generic.NonEmptyString.4">
+        <xsd:restriction base="simpleType.Generic.String">
+            <xsd:minLength value="1" />
+            <xsd:maxLength value="4" />
+            <xsd:pattern value="\S|(\S(.*)\S)" />
+        </xsd:restriction>
+    </xsd:simpleType>
+
+    <xsd:simpleType name="simpleType.Generic.NonEmptyString.8">
+        <xsd:restriction base="simpleType.Generic.String">
+            <xsd:minLength value="1" />
+            <xsd:maxLength value="8" />
+            <xsd:pattern value="\S|(\S(.*)\S)" />
+        </xsd:restriction>
+    </xsd:simpleType>
+
+    <xsd:simpleType name="simpleType.Generic.NonEmptyString.1">
+        <xsd:restriction base="simpleType.Generic.String">
+            <xsd:minLength value="1" />
+            <xsd:maxLength value="1" />
+            <xsd:pattern value="\S" />
+        </xsd:restriction>
+    </xsd:simpleType>
+
+    <xsd:simpleType name="simpleType.Generic.NonEmptyString.2">
+        <xsd:restriction base="simpleType.Generic.String">
+            <xsd:minLength value="1" />
+            <xsd:maxLength value="2" />
+            <xsd:pattern value="\S|(\S(.*)\S)" />
+        </xsd:restriction>
+    </xsd:simpleType>
+
+    <xsd:simpleType name="simpleType.Generic.NonEmptyString.3">
+        <xsd:restriction base="simpleType.Generic.String">
+            <xsd:minLength value="1" />
+            <xsd:maxLength value="3" />
+            <xsd:pattern value="\S|(\S(.*)\S)" />
+        </xsd:restriction>
+    </xsd:simpleType>
+
+    <xsd:simpleType name="simpleType.Generic.NonEmptyString.20">
+        <xsd:restriction base="simpleType.Generic.String">
+            <xsd:minLength value="1" />
+            <xsd:maxLength value="20" />
+            <xsd:pattern value="\S|(\S(.*)\S)" />
+        </xsd:restriction>
+    </xsd:simpleType>
+
     <xsd:simpleType name="simpleType.Generic.NonEmptyString.40">
         <xsd:restriction base="simpleType.Generic.String">
             <xsd:minLength value="1" />
@@ -1224,6 +1304,243 @@
         </xsd:restriction>
     </xsd:simpleType>
 
+    <xsd:complexType name="complexType.PaymentDetails">
+        <xsd:annotation>
+            <xsd:documentation>
+                Since version 26.10.
+                Normalized payment details for the order payment instrument. Specific fields are populated depending on
+                the type value.
+            </xsd:documentation>
+        </xsd:annotation>
+        <xsd:sequence>
+            <xsd:element name="brand" type="simpleType.Generic.NonEmptyString.20" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The normalized card brand. Expected values are amex, diners, discover, jcb,
+                    mastercard, unionpay, visa, and unknown. A custom value may also be returned.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="last-4" type="simpleType.Generic.NonEmptyString.4" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The last four digits of the payment instrument.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="wallet-type" type="simpleType.Generic.NonEmptyString.20" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The normalized digital wallet used for the payment. Expected values are
+                    apple_pay and google_pay. A custom value may also be returned.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="expiration-month" type="simpleType.PaymentDetails.ExpirationMonth" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The month when the payment instrument expires.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="expiration-year" type="xsd:int" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The year when the payment instrument expires.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="token" type="simpleType.Generic.NonEmptyString.40" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The reference token representing the payment instrument. This is an opaque
+                    identifier, not the card number (PAN).
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="token-type" type="simpleType.Generic.NonEmptyString.20" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The type of token backing the reference token. Expected values are NETWORK
+                    and GATEWAY. A custom value may also be returned.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="account-holder-name" type="simpleType.Generic.NonEmptyString.256" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The name of the payment instrument account holder.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="bin" type="simpleType.Generic.NonEmptyString.8" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The bank identification number (BIN) of the payment card.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="dpan-last-4" type="simpleType.Generic.NonEmptyString.4" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The last four digits of the device primary account number for a
+                    wallet-tokenized card.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="issuing-country" type="simpleType.CountryCode" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The ISO 3166-1 alpha-2 country code of the issuing bank.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="funding-type" type="simpleType.Generic.NonEmptyString.20" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The normalized card funding type. Expected values are CREDIT, DEBIT, and
+                    PREPAID. A custom value may also be returned.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+        </xsd:sequence>
+        <xsd:attribute name="type" type="simpleType.Generic.NonEmptyString.256" use="required">
+            <xsd:annotation>
+                <xsd:documentation>
+                The normalized payment method type. Expected values are bancontact, card,
+                eps, gift_card, ideal, klarna, sepa_debit, paypal, venmo, afterpay_clearpay,
+                amazon_pay, and twint. A custom value may also be returned.
+                </xsd:documentation>
+            </xsd:annotation>
+        </xsd:attribute>
+    </xsd:complexType>
+
+    <xsd:complexType name="complexType.TransactionDetails">
+        <xsd:annotation>
+            <xsd:documentation>
+            Since version 26.10.
+            Normalized transaction details for the order payment transaction. Specific fields
+            are populated depending on the payment-details type value.
+            </xsd:documentation>
+        </xsd:annotation>
+        <xsd:sequence>
+            <xsd:element name="cvc-result" type="simpleType.Generic.NonEmptyString.20" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The card verification code check result. Expected values are MATCH, NO_MATCH,
+                    NOT_PROCESSED, and UNAVAILABLE. A custom value may also be returned.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="avs-result" type="simpleType.Generic.NonEmptyString.1" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The address verification service result. Expected values are Y (full match),
+                    N (no match), A (address only), Z (postal code only), U (unavailable), S
+                    (unsupported), and R (retry). A custom value may also be returned.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="three-ds-result" type="simpleType.Generic.NonEmptyString.20" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The 3D Secure authentication result. Expected values are AUTHENTICATED,
+                    ATTEMPTED, FAILED, REJECTED, and UNAVAILABLE. A custom value may also be returned.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="three-ds-version" type="simpleType.Generic.NonEmptyString.2" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The 3D Secure protocol version. Expected values are V1 and V2. A custom value may also be returned.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="three-ds-transaction-id" type="simpleType.Generic.NonEmptyString.40" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The 3D Secure transaction identifier.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="electronic-commerce-indicator" type="simpleType.Generic.NonEmptyString.3" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The electronic commerce indicator (ECI) value returned by the processor.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="approval-code" type="simpleType.Generic.NonEmptyString.256" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The approval code returned by the provider on a successful gift card capture.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="reason-code" type="simpleType.Generic.NonEmptyString.256" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The reason code returned by the provider on a failed gift card capture.
+                    Expected values are DECLINED and INSUFFICIENT_FUNDS. A custom value may also
+                    be returned.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="processor-response-text" type="simpleType.Generic.NonEmptyString.256" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The human-readable gift card processor response text. The language and localization of this
+                    text are provider-defined and may vary by provider integration.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+        </xsd:sequence>
+    </xsd:complexType>
+
+    <xsd:complexType name="complexType.FraudDecisions">
+        <xsd:annotation>
+            <xsd:documentation>
+            Since version 26.10.
+            Normalized fraud decisions for the order payment instrument. The values remain
+            readable for historical orders.
+            </xsd:documentation>
+        </xsd:annotation>
+        <xsd:sequence>
+            <xsd:element name="pre-authorization" type="simpleType.Generic.NonEmptyString.256" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The pre-authorization fraud decision used by the client to orchestrate
+                    checkout. Expected values are NOT_REVIEWED (no pre-authorization fraud
+                    decision was made), APPROVED (the payment authorization can proceed),
+                    CHALLENGE (the payment authorization should be challenged with additional
+                    verification such as a 3D Secure challenge before it can proceed), and
+                    DECLINED (the payment authorization is declined). A custom value may also be
+                    returned.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+            <xsd:element name="post-authorization" type="simpleType.Generic.NonEmptyString.256" minOccurs="0" maxOccurs="1">
+                <xsd:annotation>
+                    <xsd:documentation>
+                    The post-authorization fraud decision indicating whether the transaction is
+                    covered by a fraud guarantee. Expected values are NOT_REVIEWED (no
+                    post-authorization fraud decision was made), GUARANTEED (the transaction is
+                    covered by a fraud guarantee), NOT_GUARANTEED (the transaction is not covered
+                    by a fraud guarantee), and PENDING (the post-authorization fraud decision is
+                    still pending). A custom value may also be returned.
+                    </xsd:documentation>
+                </xsd:annotation>
+            </xsd:element>
+        </xsd:sequence>
+    </xsd:complexType>
+
+    <xsd:simpleType name="simpleType.PaymentDetails.ExpirationMonth">
+        <xsd:restriction base="xsd:int">
+            <xsd:minInclusive value="1"/>
+            <xsd:maxInclusive value="12"/>
+        </xsd:restriction>
+    </xsd:simpleType>
+
     <xsd:simpleType name="simpleType.OrderBusinessType">
         <xsd:restriction base="xsd:string">
             <xsd:enumeration value="B2C" />

package/data/xsd/search2.xsd

@@ -467,7 +467,7 @@
     <xsd:simpleType name="simpleType.Generic.String.256">
         <xsd:restriction base="simpleType.Generic.String">
             <xsd:minLength value="0"/>
-            <xsd:maxLength value="10"/>
+            <xsd:maxLength value="256"/>
         </xsd:restriction>
     </xsd:simpleType>
 

package/data/xsd/sort.xsd

@@ -191,8 +191,16 @@
             <xsd:element name="description" type="LocalizedString" minOccurs="0" maxOccurs="unbounded" />
         </xsd:sequence>
         <xsd:attribute name="option-id" type="Generic.NonEmptyString.256" use="required" />
+        <xsd:attribute name="search-type" type="SearchType" use="optional" />
     </xsd:complexType>
 
+    <xsd:simpleType name="SearchType">
+        <xsd:restriction base="xsd:string">
+            <xsd:enumeration value="standard" />
+            <xsd:enumeration value="agentic" />
+        </xsd:restriction>
+    </xsd:simpleType>
+
     <xsd:simpleType name="SortingDirection">
         <xsd:restriction base="xsd:string">
             <xsd:enumeration value="ascending" />
@@ -268,9 +276,18 @@
         </xsd:restriction>
     </xsd:simpleType>
 
+    <!-- Owning system object type for a boostable attribute. -->
+    <xsd:simpleType name="BoostableObjectType">
+        <xsd:restriction base="xsd:string">
+            <xsd:enumeration value="Product" />
+            <xsd:enumeration value="ProductActiveData" />
+        </xsd:restriction>
+    </xsd:simpleType>
+
     <xsd:complexType name="BoostableAttribute">
         <xsd:attribute name="attribute-id" type="Generic.NonEmptyString.256" use="required" />
         <xsd:attribute name="system" type="xsd:boolean" use="required" />
+        <xsd:attribute name="object-type" type="BoostableObjectType" use="optional" default="Product" />
         <xsd:attribute name="mode" type="ImportMode" use="optional" />
     </xsd:complexType>
 

package/data/xsd/storefronts.xsd

@@ -24,21 +24,50 @@
     <xsd:complexType name="complexType.Storefront" mixed="false">
         <xsd:sequence>
             <xsd:element name="ecom-site" type="simpleType.Generic.String.48" minOccurs="0" maxOccurs="1"/>
-            <xsd:element name="storefront-type" type="simpleType.StorefrontType" minOccurs="1" maxOccurs="1"/>
-            <xsd:element name="storefront-status" type="simpleType.StorefrontStatus" minOccurs="1" maxOccurs="1"/>
+            <!-- Accepted values (case-insensitive on import): composable, pwa_kit. Export emits lowercase. -->
+            <xsd:element name="storefront-type" type="simpleType.Generic.String.32" minOccurs="1" maxOccurs="1"/>
+            <!--
+                Deprecated. Retained solely for backward compatibility: storefront import validates incoming
+                files against this schema (StorefrontImpexUnit.setSchema), so pre-cleanup export files that still
+                carry <storefront-status> must remain declared here to pass validation. Optional and ignored on
+                import; no longer emitted on export. Do not add new consumers.
+            -->
+            <xsd:element name="storefront-status" type="simpleType.Generic.String.32" minOccurs="0" maxOccurs="1"/>
             <xsd:element name="associated-sites" type="complexType.AssociatedSites" minOccurs="0" maxOccurs="1"/>
-            <xsd:element name="user-id" type="simpleType.Generic.String.48" minOccurs="1" maxOccurs="1"/>
+            <!--
+                Optional. For interactive Business Manager (session-based) imports the importer's authenticated
+                session identity is authoritative and this value is ignored. It supplies the acting identity only for
+                server-to-server (client-credentials) imports, which have no session; such imports are rejected if it
+                is absent or unauthorized. Retained and declared here because storefront import validates incoming
+                files against this schema (StorefrontImpexUnit.setSchema).
+            -->
+            <xsd:element name="user-id" type="simpleType.Generic.String.48" minOccurs="0" maxOccurs="1"/>
             <xsd:element name="org-slug" type="simpleType.Generic.String.64" minOccurs="1" maxOccurs="1"/>
             <xsd:element name="mrt-site" type="simpleType.Generic.String.64" minOccurs="1" maxOccurs="1"/>
             <xsd:element name="scm-repo" type="simpleType.Generic.String.512" minOccurs="0" maxOccurs="1"/>
             <xsd:element name="scm-target" type="simpleType.Generic.String.64" minOccurs="0" maxOccurs="1"/>
+            <!--
+                Deprecated (W-23546554). Retained solely for backward compatibility: storefront import validates
+                incoming files against this schema (StorefrontImpexUnit.setSchema), so pre-cleanup export files that
+                still carry <github-app-installation> must remain declared here to pass validation. Optional and
+                ignored on import; no longer emitted on export. Carrying the source realm's GitHub App installation
+                onto a target would enable a cross-realm credential-leak (spike W-23298074 3.3), so it is dropped on
+                import and the GitHub App must be reconnected manually. Do not add new consumers. This element will be
+                removed in a future schema version once all pre-cleanup export files carrying it have cycled out.
+            -->
             <xsd:element name="github-app-installation" type="complexType.GitHubAppInstallation" minOccurs="0" maxOccurs="1"/>
         </xsd:sequence>
         <xsd:attribute name="storefront-name" type="simpleType.Generic.NonEmptyString.64" use="required"/>
-        <xsd:attribute name="mode" type="simpleType.ImportMode"/>
+        <!--
+            Deprecated. Retained solely for backward compatibility: pre-cleanup delta-export files could carry
+            mode="delete". Optional and ignored on import (the import delete decision is driven by the framework
+            import mode, not this attribute); no longer emitted on export. Do not add new consumers.
+        -->
+        <xsd:attribute name="mode" type="simpleType.Generic.String.32"/>
     </xsd:complexType>
 
-    <!-- GitHub App Installation -->
+    <!-- GitHub App Installation. Deprecated (W-23546554): declared only so legacy files that still carry
+         <github-app-installation> validate on import. Ignored on import, never exported. Do not add new consumers. -->
     <xsd:complexType name="complexType.GitHubAppInstallation" mixed="false">
         <xsd:sequence>
             <xsd:element name="app-id" type="simpleType.Generic.String.64" minOccurs="1" maxOccurs="1"/>
@@ -57,49 +86,6 @@
         </xsd:sequence>
     </xsd:complexType>
 
-    <!-- Storefront Type enumeration -->
-    <xsd:simpleType name="simpleType.StorefrontType">
-        <xsd:restriction base="xsd:string">
-            <xsd:enumeration value="composable"/>
-            <xsd:enumeration value="headless"/>
-        </xsd:restriction>
-    </xsd:simpleType>
-
-    <!--
-        Storefront Status enumeration.
-
-        These values must stay in sync with StorefrontSetupStatusEnum (core/internal/storefront).
-        There is no compile-time link between this XSD and the Java enum; drift is caught by
-        comparing the JAXB-generated SimpleTypeStorefrontStatus against StorefrontSetupStatusEnum
-        in _JAXBStorefrontExportHandler (testStorefrontStatusEnumAndXsdInSync).
-
-        Export currently restricts output to SUCCESS storefronts only
-        (JAXBStorefrontExportHandler.mapStorefront). Adding a new exportable status requires:
-          1. Adding the value here
-          2. Adding the enum constant in StorefrontSetupStatusEnum
-          3. Updating the export guard in mapStorefront to allow the new status
-          4. Updating the sync unit test's expected set if needed
-    -->
-    <xsd:simpleType name="simpleType.StorefrontStatus">
-        <xsd:restriction base="xsd:string">
-            <xsd:enumeration value="in_progress"/>
-            <xsd:enumeration value="success"/>
-            <xsd:enumeration value="backfilled"/>
-            <xsd:enumeration value="failed"/>
-            <xsd:enumeration value="delete_in_progress"/>
-            <xsd:enumeration value="delete_failed"/>
-            <xsd:enumeration value="deleted"/>
-            <xsd:enumeration value="unknown"/>
-        </xsd:restriction>
-    </xsd:simpleType>
-
-    <!-- Import Mode -->
-    <xsd:simpleType name="simpleType.ImportMode">
-        <xsd:restriction base="xsd:string">
-            <xsd:enumeration value="delete"/>
-        </xsd:restriction>
-    </xsd:simpleType>
-
     <!-- simple generic types -->
     <xsd:simpleType name="simpleType.Generic.String">
         <xsd:restriction base="xsd:string"/>

package/dist/esm/cli/config.js

@@ -1,6 +1,7 @@
 import { ALL_AUTH_METHODS } from '../auth/types.js';
 import { resolveConfig } from '../config/index.js';
 import { findDwJson } from '../config/dw-json.js';
+import { getStorefrontNextEnvironmentConfig } from '../config/sources/env-source.js';
 import { getLogger } from '../logging/logger.js';
 export { ALL_AUTH_METHODS };
 export { findDwJson };
@@ -161,9 +162,14 @@ export function extractMrtFlags(flags) {
  */
 export async function loadConfig(flags = {}, options = {}, pluginSources = {}) {
     const logger = getLogger();
+    // oclif has already populated `flags` from explicit arguments and canonical
+    // toolkit environment variables. Add Storefront Next names only where those
+    // higher-priority values are absent.
+    const definedFlags = Object.fromEntries(Object.entries(flags).filter(([, value]) => value !== undefined));
     // Preserve instanceName and projectDirectory from options if not already in flags
     const effectiveFlags = {
-        ...flags,
+        ...getStorefrontNextEnvironmentConfig(),
+        ...definedFlags,
         instanceName: flags.instanceName ?? options.instance,
         projectDirectory: flags.projectDirectory ?? options.projectDirectory,
         workingDirectory: flags.workingDirectory ?? options.workingDirectory,

package/dist/esm/cli/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/cli/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/cli/config.ts"],"names":[],"mappings":"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"}

package/dist/esm/cli/mrt-command.d.ts

@@ -76,6 +76,20 @@ export declare abstract class MrtCommand<T extends typeof Command> extends OAuth
     private mrtReadOnlyWarned;
     /** Warn once if any read is served while Managed Runtime is in read-only mode. */
     _run<R>(): Promise<R>;
+    /**
+     * Suppress human-readable logging in `--json` mode.
+     *
+     * MRT commands emit progress/status lines via {@link BaseCommand.log}, which
+     * routes to the structured logger on stderr. When `--json` is set the caller
+     * wants machine-readable output only, so these lines are swallowed centrally
+     * here instead of guarding every call site with `if (!this.jsonEnabled())`.
+     *
+     * This only affects `this.log()` (stderr diagnostics). Structured stdout
+     * output — tables and detail views written via `ux.stdout` — is untouched and
+     * must still be guarded by `jsonEnabled()` at its call site so it never
+     * corrupts the JSON payload on stdout.
+     */
+    log(message?: string, ...args: unknown[]): void;
     protected loadConfiguration(): Promise<ResolvedB2CConfig>;
     /** Resolved `--mrt-backend` preference (default `'auto'`). */
     protected get mrtBackendPreference(): 'auto' | 'legacy' | 'scapi';
@@ -140,10 +154,12 @@ export declare abstract class MrtCommand<T extends typeof Command> extends OAuth
     protected getScapiMrtConfig(): ScapiClientConfig | undefined;
     /**
      * Whether this command implements the SCAPI MRT backend. Defaults to `false`;
-     * the supported commands (`mrt bundle history`, `mrt bundle deploy <bundleId>`)
-     * override it to `true`. Used by {@link init} to reject an explicit
-     * `--mrt-backend scapi` on commands that would otherwise silently fall back to
-     * legacy — an explicit SCAPI request must never be quietly downgraded.
+     * the supported commands (`mrt bundle history`, `mrt bundle list`,
+     * `mrt bundle deploy` — both the local-build push and `<bundleId>` deploy —
+     * and the `mrt env var` family: `list`, `set`, `delete`, `push`) override it
+     * to `true`. Used by {@link init} to reject an explicit `--mrt-backend scapi`
+     * on commands that would otherwise silently fall back to legacy — an explicit
+     * SCAPI request must never be quietly downgraded.
      */
     protected supportsScapiMrt(): boolean;
     init(): Promise<void>;