@vtex/faststore-plugin-buyer-portal 2.0.28 → 2.0.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vtex/faststore-plugin-buyer-portal",
-  "version": "2.0.28",
+  "version": "2.0.30",
   "description": "A plugin for faststore with buyer portal",
   "main": "index.js",
   "files": [
@@ -16,6 +16,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
+    "i18n:check": "node scripts/check-localization-keys.mjs check --base=main",
+    "i18n:refresh": "node scripts/check-localization-keys.mjs refresh",
     "prepare": "husky",
     "release": "yarn release:stable",
     "release:stable": "yarn check --integrity && yarn release-it -c .release-it.json --ci --no-npm",

package/src/features/addresses/components/AddressDropdownMenu/AddressDropdownMenu.tsx

@@ -12,7 +12,11 @@ import {
 } from "..";
 import { AddRecipientsDrawer } from "../../../recipients/components";
 import { BasicDropdownMenu, Icon } from "../../../shared/components";
-import { useBuyerPortal, useDrawerProps } from "../../../shared/hooks";
+import {
+  useBuyerPortal,
+  useDrawerProps,
+  useIsAddressEditingRestricted,
+} from "../../../shared/hooks";
 import { useLocalization } from "../../../shared/localization/LocalizationContext";
 import { buyerPortalRoutes } from "../../../shared/utils/buyerPortalRoutes";
 import { useAddRecipientsToAddress } from "../../hooks/useAddRecipientsToAddress";
@@ -42,6 +46,7 @@ export const AddressDropdownMenu = ({
   const router = useRouter();
   const { pushToast } = useUI();
   const { t } = useLocalization();
+  const isAddressEditingRestricted = useIsAddressEditingRestricted();
   const { featureFlags } = useBuyerPortal();
   const isRecipientsContractLevelEnabled = Boolean(
     featureFlags?.enableRecipientsContractLevel
@@ -187,27 +192,31 @@ ${t("shared.messages.changesTimeout")}`,
       <BasicDropdownMenu data-fs-bp-dropdown-menu>
         <DropdownItem onClick={handleOpenNewTab}>
           <Icon name="OpenNewTab" {...sizeProps} />
-          Open
-        </DropdownItem>
-        <DropdownItem onClick={openEditDrawerProps}>
-          <Icon name="Edit" {...sizeProps} />
-          {t("addresses.dropdown.editDetails")}
-        </DropdownItem>
-        <DropdownItem
-          data-fs-bp-testid="dropdown-item-add-location"
-          onClick={openLocationDrawer}
-        >
-          <UIIcon name="PlusCircle" {...sizeProps} />
-          {t("addresses.actions.addLocations", [resolvedLocationsLabel])}
+          {t("shared.buttons.open")}
         </DropdownItem>
-        {!isRecipientsContractLevelEnabled && (
-          <DropdownItem
-            data-fs-bp-testid="dropdown-item-add-recipient"
-            onClick={openRecipientsDrawer}
-          >
-            <UIIcon name="PlusCircle" {...sizeProps} />
-            {t("addresses.actions.addRecipients")}
-          </DropdownItem>
+        {!isAddressEditingRestricted && (
+          <>
+            <DropdownItem onClick={openEditDrawerProps}>
+              <Icon name="Edit" {...sizeProps} />
+              {t("addresses.dropdown.editDetails")}
+            </DropdownItem>
+            <DropdownItem
+              data-fs-bp-testid="dropdown-item-add-location"
+              onClick={openLocationDrawer}
+            >
+              <UIIcon name="PlusCircle" {...sizeProps} />
+              {t("addresses.actions.addLocations", [resolvedLocationsLabel])}
+            </DropdownItem>
+            {!isRecipientsContractLevelEnabled && (
+              <DropdownItem
+                data-fs-bp-testid="dropdown-item-add-recipient"
+                onClick={openRecipientsDrawer}
+              >
+                <UIIcon name="PlusCircle" {...sizeProps} />
+                {t("addresses.actions.addRecipients")}
+              </DropdownItem>
+            )}
+          </>
         )}
         {currentAddress.isDefault ? (
           <DropdownItem onClick={handleUnsetAsDefault}>
@@ -229,16 +238,15 @@ ${t("shared.messages.changesTimeout")}`,
           <UIIcon name="MinusCircle" {...sizeProps} />
           {t("addresses.actions.removeFromUnit")}
         </DropdownItem>
-        {/* Remove validation while we reevaluate the rule */}
-        {/* {isRootLevelOrgUnit && ( */}
-        <DropdownItem
-          onClick={openDeleteAddressDrawer}
-          data-fs-bp-dropdown-menu-item-mode="danger"
-        >
-          <Icon name="Delete" {...sizeProps} data-fs-bp-delete-address />
-          <span data-fs-bp-delete-address>{t("shared.buttons.delete")}</span>
-        </DropdownItem>
-        {/* )} */}
+        {!isAddressEditingRestricted && (
+          <DropdownItem
+            onClick={openDeleteAddressDrawer}
+            data-fs-bp-dropdown-menu-item-mode="danger"
+          >
+            <Icon name="Delete" {...sizeProps} data-fs-bp-delete-address />
+            <span data-fs-bp-delete-address>{t("shared.buttons.delete")}</span>
+          </DropdownItem>
+        )}
       </BasicDropdownMenu>
       {isEditDrawerOpen && (
         <EditAddressDrawer
@@ -257,22 +265,24 @@ ${t("shared.messages.changesTimeout")}`,
           locationsLabel={resolvedLocationsLabel}
         />
       )}
-      {!isRecipientsContractLevelEnabled && isOpenRecipientsDrawer && (
-        <AddRecipientsDrawer
-          readonly
-          {...recipientDrawerProps}
-          isOpen={isOpenRecipientsDrawer}
-          isSubmitting={isAddRecipientToAddressLoading}
-          onSubmit={handleAddRecipientsSubmit}
-          onSubmitted={() => router.reload()}
-          addressId={currentAddress.id}
-          viewLink={`${buyerPortalRoutes.addressDetails({
-            orgUnitId,
-            contractId: customerId,
-            addressId: currentAddress.id,
-          })}?tab=recipient-tab`}
-        />
-      )}
+      {!isAddressEditingRestricted &&
+        !isRecipientsContractLevelEnabled &&
+        isOpenRecipientsDrawer && (
+          <AddRecipientsDrawer
+            readonly
+            {...recipientDrawerProps}
+            isOpen={isOpenRecipientsDrawer}
+            isSubmitting={isAddRecipientToAddressLoading}
+            onSubmit={handleAddRecipientsSubmit}
+            onSubmitted={() => router.reload()}
+            addressId={currentAddress.id}
+            viewLink={`${buyerPortalRoutes.addressDetails({
+              orgUnitId,
+              contractId: customerId,
+              addressId: currentAddress.id,
+            })}?tab=recipient-tab`}
+          />
+        )}
       {isOpenRemoveAddressDrawer && (
         <RemoveAddressDrawer
           readonly

package/src/features/addresses/components/AddressLocationsList/AddressLocationsList.tsx

@@ -15,6 +15,7 @@ import { getTableColumns } from "../../../shared/components/Table/utils/tableCol
 import {
   useBuyerPortal,
   useDrawerProps,
+  useIsAddressEditingRestricted,
   usePageItems,
 } from "../../../shared/hooks";
 import { PAGE_PARAMS, SEARCH_PARAMS } from "../../../shared/hooks/usePageItems";
@@ -78,6 +79,7 @@ export const AddressLocationsList = forwardRef<
     const [totalLocations, setTotalLocations] = useState(total);
     const { currentOrgUnit } = useBuyerPortal();
     const router = useRouter();
+    const isAddressEditingRestricted = useIsAddressEditingRestricted();
     const { listLocationData, listLocationRefresh } = useAddressLocationList({
       addressId: (router.query.addressId as string) || "",
       page,
@@ -118,8 +120,40 @@ export const AddressLocationsList = forwardRef<
       refreshLocations: handleRefreshLocations,
     }));
 
+    const locationActions = isAddressEditingRestricted
+      ? []
+      : [
+          {
+            testId: "location-action-delete",
+            iconName: "Trash",
+            ariaLabel: "remove location action",
+            onSelect: openDeleteLocation,
+          },
+          {
+            testId: "location-action-edit",
+            iconName: "Edit",
+            ariaLabel: "edit location action",
+            onSelect: openEditLocation,
+          },
+        ];
+
+    const renderActions = (item: LocationData) =>
+      locationActions.map(({ testId, iconName, ariaLabel, onSelect }) => (
+        <IconButton
+          key={testId}
+          data-fs-bp-address-tabs-actions-icon
+          data-fs-bp-testid={testId}
+          icon={<Icon name={iconName} width={20} height={20} />}
+          aria-label={ariaLabel}
+          onClick={() => {
+            selectLocation(item);
+            onSelect();
+          }}
+        />
+      ));
+
     const columns = getTableColumns({
-      actionsLength: 2,
+      actionsLength: locationActions.length,
       nameColumnLabel: t("shared.labels.name"),
     });
 
@@ -141,13 +175,15 @@ export const AddressLocationsList = forwardRef<
             iconSize={56}
             title={t("addresses.empty.noResults")}
           >
-            <Button
-              variant="primary"
-              onClick={() => onOpenAddDrawer?.()}
-              data-fs-bp-address-tabs-empty-state
-            >
-              {t("addresses.buttons.addLocations")}
-            </Button>
+            {!isAddressEditingRestricted && (
+              <Button
+                variant="primary"
+                onClick={() => onOpenAddDrawer?.()}
+                data-fs-bp-address-tabs-empty-state
+              >
+                {t("addresses.buttons.addLocations")}
+              </Button>
+            )}
           </EmptyState>
         ) : (
           <div data-fs-bp-address-tabs-table>
@@ -162,28 +198,7 @@ export const AddressLocationsList = forwardRef<
                       key={item.id}
                       title={item.value}
                       searchTerm={search}
-                      actionIcons={[
-                        <IconButton
-                          data-fs-bp-address-tabs-actions-icon
-                          data-fs-bp-testid="location-action-delete"
-                          icon={<Icon name="Trash" width={20} height={20} />}
-                          aria-label={"remove location action"}
-                          onClick={() => {
-                            selectLocation(item);
-                            openDeleteLocation();
-                          }}
-                        />,
-                        <IconButton
-                          data-fs-bp-address-tabs-actions-icon
-                          data-fs-bp-testid="location-action-edit"
-                          icon={<Icon name="Edit" width={20} height={20} />}
-                          aria-label={"edit location action"}
-                          onClick={() => {
-                            selectLocation(item);
-                            openEditLocation();
-                          }}
-                        />,
-                      ]}
+                      actionIcons={renderActions(item)}
                     />
                   ))
                 )}

package/src/features/addresses/components/AddressesCard/AddressesCard.tsx

@@ -67,7 +67,7 @@ export default function AddressesCard({
                     <DropdownMenu>
                       <DropdownItem data-fs-card-dropdown-item>
                         <Icon name="ArrowSquareOut" data-fs-dropdown-icon />
-                        Open
+                        {t("shared.buttons.open")}
                       </DropdownItem>
                       <DropdownItem>
                         <Icon

package/src/features/addresses/components/CreateAddressSettingsDrawer/CreateAddressSettingsDrawer.tsx

@@ -14,7 +14,11 @@ import {
 } from "../../../shared/components";
 import { OptionSelected } from "../../../shared/components/OptionSelected/OptionSelected";
 import { SearchHighlight } from "../../../shared/components/SearchHighlight/SearchHighlight";
-import { useSetScopeConfig, SCOPE_KEYS } from "../../../shared/hooks";
+import {
+  SCOPE_KEYS,
+  useIsAddressEditingRestricted,
+  useSetScopeConfig,
+} from "../../../shared/hooks";
 import { useLocalization } from "../../../shared/localization/LocalizationContext";
 import { useEditAddressLocationSettings } from "../../hooks";
 import { useDebouncedSearchAddressByUnitId } from "../../hooks/useDebouncedSearchAddressByUnitId";
@@ -41,6 +45,7 @@ export const CreateAddressSettingsDrawer = ({
 }: CreateAddressSettingsDrawerProps) => {
   const { pushToast } = useUI();
   const { t } = useLocalization();
+  const isAddressEditingRestricted = useIsAddressEditingRestricted();
   const addressListTypeOptions = createListTypeOptions("addresses", t);
   const router = useRouter();
   const locationLabelText = initialLocationsLabel;
@@ -172,7 +177,9 @@ export const CreateAddressSettingsDrawer = ({
     });
     const formData = getFormData();
     const locationLabelChanged =
-      !!locationsLabel && locationsLabel !== initialLocationsLabel;
+      !isAddressEditingRestricted &&
+      !!locationsLabel &&
+      locationsLabel !== initialLocationsLabel;
 
     if (formData.length === 0 && !locationLabelChanged) {
       // Close drawer and trigger update when only list type changed
@@ -337,21 +344,25 @@ export const CreateAddressSettingsDrawer = ({
           />
         )}
 
-        <h4
-          data-fs-bp-default-addresses-title
-          data-fs-bp-default-addresses-locations-field
-        >
-          {t("addresses.labels.locations")}
-        </h4>
-        <h4 data-fs-bp-default-addresses-subtitle>
-          {t("addresses.forms.setLocationsFieldName", [locationLabelText])}
-        </h4>
-        <InputText
-          label={t("addresses.forms.fieldLabel")}
-          value={locationsLabel}
-          onChange={(event) => setLocationsLabel(event.target.value)}
-          name="locations-label"
-        />
+        {!isAddressEditingRestricted && (
+          <>
+            <h4
+              data-fs-bp-default-addresses-title
+              data-fs-bp-default-addresses-locations-field
+            >
+              {t("addresses.labels.locations")}
+            </h4>
+            <h4 data-fs-bp-default-addresses-subtitle>
+              {t("addresses.forms.setLocationsFieldName", [locationLabelText])}
+            </h4>
+            <InputText
+              label={t("addresses.forms.fieldLabel")}
+              value={locationsLabel}
+              onChange={(event) => setLocationsLabel(event.target.value)}
+              name="locations-label"
+            />
+          </>
+        )}
       </div>
     </SettingsDrawer>
   );

package/src/features/addresses/layouts/AddressDetailsLayout/AddressDetailsLayout.tsx

@@ -21,7 +21,11 @@ import {
 import { TabBar } from "../../../shared/components/Tab/TabBar";
 import { TabContent } from "../../../shared/components/Tab/TabContent";
 import { TabOption } from "../../../shared/components/Tab/TabOption";
-import { useBuyerPortal, useDrawerProps } from "../../../shared/hooks";
+import {
+  useBuyerPortal,
+  useDrawerProps,
+  useIsAddressEditingRestricted,
+} from "../../../shared/hooks";
 import {
   PAGE_PARAMS,
   SEARCH_PARAMS,
@@ -81,6 +85,7 @@ export const AddressDetailsLayout = ({
     currentContract: contract,
     featureFlags,
   } = useBuyerPortal();
+  const isAddressEditingRestricted = useIsAddressEditingRestricted();
   const isRecipientsContractLevelEnabled = Boolean(
     featureFlags?.enableRecipientsContractLevel
   );
@@ -273,8 +278,12 @@ export const AddressDetailsLayout = ({
     if (deleteRecipientErrorRef.current) throw deleteRecipientErrorRef.current;
   };
 
-  const renderActionButton = () =>
-    ({
+  const renderActionButton = () => {
+    if (isAddressEditingRestricted) {
+      return null;
+    }
+
+    return {
       ["address-tab"]: (
         <button
           type="button"
@@ -302,7 +311,8 @@ export const AddressDetailsLayout = ({
           {t("shared.buttons.add")}
         </button>
       ),
-    }[activeTabId]);
+    }[activeTabId];
+  };
 
   return (
     <GlobalLayout>
@@ -389,11 +399,13 @@ export const AddressDetailsLayout = ({
                     );
                   })}
 
-                <EditAddressDrawer
-                  readonly
-                  {...createDrawerProps}
-                  currentAddress={addressDetails}
-                />
+                {!isAddressEditingRestricted && (
+                  <EditAddressDrawer
+                    readonly
+                    {...createDrawerProps}
+                    currentAddress={addressDetails}
+                  />
+                )}
               </TabContent>
 
               <TabContent id="location-tab">
@@ -406,15 +418,17 @@ export const AddressDetailsLayout = ({
                   onOpenAddDrawer={openLocationsDrawer}
                   locationsLabel={locationSettingsData?.name}
                 />
-                <LocationDrawer
-                  {...locationsDrawerProps}
-                  isOpen={isOpenLocationsDrawer}
-                  addressId={addressDetails.id}
-                  locationsLabel={locationSettingsData?.name}
-                  onAddLocationSuccess={() =>
-                    addressLocationsListRef.current?.refreshLocations()
-                  }
-                />
+                {!isAddressEditingRestricted && (
+                  <LocationDrawer
+                    {...locationsDrawerProps}
+                    isOpen={isOpenLocationsDrawer}
+                    addressId={addressDetails.id}
+                    locationsLabel={locationSettingsData?.name}
+                    onAddLocationSuccess={() =>
+                      addressLocationsListRef.current?.refreshLocations()
+                    }
+                  />
+                )}
               </TabContent>
 
               {!isRecipientsContractLevelEnabled && (
@@ -446,6 +460,7 @@ export const AddressDetailsLayout = ({
                           isLoading={isRecipientsLoading}
                           searchTerm={recipientsSearchTerm}
                           countryCode="USA"
+                          hideActions={isAddressEditingRestricted}
                           onEditRecipient={(recipient) => {
                             setCurrentRecipient(recipient);
                             openEditRecipientDrawer();
@@ -477,7 +492,7 @@ export const AddressDetailsLayout = ({
                     )}
                   </div>
 
-                  {isOpenRecipientsDrawer && (
+                  {isOpenRecipientsDrawer && !isAddressEditingRestricted && (
                     <AddRecipientsDrawer
                       readonly
                       {...recipientDrawerProps}
@@ -489,31 +504,35 @@ export const AddressDetailsLayout = ({
                     />
                   )}
 
-                  {isOpenEditRecipientDrawer && currentRecipient && (
-                    <EditRecipientDrawer
-                      readonly
-                      recipient={currentRecipient}
-                      {...editRecipientDrawerProps}
-                      isOpen={isOpenEditRecipientDrawer}
-                      isSubmitting={isEditRecipientToAddressLoading}
-                      onSubmit={handleEditRecipientSubmit}
-                      onSubmitted={handleRefetchRecipients}
-                      addressId={addressDetails.id}
-                    />
-                  )}
+                  {isOpenEditRecipientDrawer &&
+                    currentRecipient &&
+                    !isAddressEditingRestricted && (
+                      <EditRecipientDrawer
+                        readonly
+                        recipient={currentRecipient}
+                        {...editRecipientDrawerProps}
+                        isOpen={isOpenEditRecipientDrawer}
+                        isSubmitting={isEditRecipientToAddressLoading}
+                        onSubmit={handleEditRecipientSubmit}
+                        onSubmitted={handleRefetchRecipients}
+                        addressId={addressDetails.id}
+                      />
+                    )}
 
-                  {isOpenDeleteRecipientDrawer && currentRecipient && (
-                    <DeleteRecipientDrawer
-                      readonly
-                      recipient={currentRecipient}
-                      {...deleteRecipientDrawerProps}
-                      isOpen={isOpenDeleteRecipientDrawer}
-                      isSubmitting={isDeleteRecipientAddressLoading}
-                      onSubmit={handleDeleteRecipientSubmit}
-                      onSubmitted={handleRefetchRecipients}
-                      addressId={addressDetails.id}
-                    />
-                  )}
+                  {isOpenDeleteRecipientDrawer &&
+                    currentRecipient &&
+                    !isAddressEditingRestricted && (
+                      <DeleteRecipientDrawer
+                        readonly
+                        recipient={currentRecipient}
+                        {...deleteRecipientDrawerProps}
+                        isOpen={isOpenDeleteRecipientDrawer}
+                        isSubmitting={isDeleteRecipientAddressLoading}
+                        onSubmit={handleDeleteRecipientSubmit}
+                        onSubmitted={handleRefetchRecipients}
+                        addressId={addressDetails.id}
+                      />
+                    )}
                 </TabContent>
               )}
             </Tab>

package/src/features/addresses/layouts/AddressesLayout/AddressesLayout.tsx

@@ -17,6 +17,7 @@ import {
   useBuyerPortal,
   useDrawerProps,
   useGetScopeConfig,
+  useIsAddressEditingRestricted,
   useUrlPaginatedSearch,
   SCOPE_KEYS,
 } from "../../../shared/hooks";
@@ -34,6 +35,7 @@ export const AddressLayout = () => {
   const { currentOrgUnit } = useBuyerPortal();
   const { pushToast } = useUI();
   const { t } = useLocalization();
+  const isAddressEditingRestricted = useIsAddressEditingRestricted();
 
   const {
     page,
@@ -165,7 +167,9 @@ export const AddressLayout = () => {
                   style={{ backgroundColor: "transparent", color: "#1f1f1f" }}
                   onClick={openCreateAddressSettingsDrawer}
                 />
-                <HeaderInside.Button onClick={openCreateDrawer} />
+                {!isAddressEditingRestricted && (
+                  <HeaderInside.Button onClick={openCreateDrawer} />
+                )}
               </>
             )}
           </HeaderInside>
@@ -180,11 +184,15 @@ export const AddressLayout = () => {
               title={
                 committedSearch.length > 0
                   ? t("addresses.empty.noResults")
+                  : isAddressEditingRestricted
+                  ? t("addresses.empty.managedByMerchant")
                   : t("addresses.empty.noAddressesYet")
               }
               description={
                 committedSearch.length > 0
                   ? t("addresses.empty.tryDifferentTerms")
+                  : isAddressEditingRestricted
+                  ? t("addresses.empty.managedByMerchantDescription")
                   : undefined
               }
               iconName={
@@ -263,7 +271,7 @@ export const AddressLayout = () => {
             </div>
           )}
 
-          {isCreateAddressDrawerOpen && (
+          {isCreateAddressDrawerOpen && !isAddressEditingRestricted && (
             <CreateAddressDrawer
               readonly
               isOpen={isCreateAddressDrawerOpen}

package/src/features/buying-policies/components/AccountingFieldCriteriaSelector/AccountingFieldCriteriaSelector.tsx

@@ -4,6 +4,7 @@ import { useUI } from "@faststore/ui";
 
 import { useListAccountingFields } from "../../../accounting-fields/hooks";
 import { CustomDropdown } from "../../../shared/components/CustomDropdown/CustomDropdown";
+import { LocalizationEslintIgnore } from "../../../shared/components/LocalizationEslintIgnore/LocalizationEslintIgnore";
 import { useBuyerPortal } from "../../../shared/hooks";
 import { useLocalization } from "../../../shared/localization/LocalizationContext";
 import {
@@ -91,7 +92,9 @@ export const AccountingFieldCriteriaSelector = ({
     <div data-fs-bp-accounting-field-criteria-selector>
       <div data-fs-bp-accounting-fields-criteria-string>
         <span onClick={handleEditablePartClick} data-fs-bp-editable-part>
-          $exists(customData.customFields.fields[customFieldId="
+          <LocalizationEslintIgnore>
+            $exists(customData.customFields.fields[customFieldId="
+          </LocalizationEslintIgnore>
         </span>
 
         <div onClick={handleFieldClick} style={{ display: "inline-block" }}>
@@ -115,7 +118,7 @@ export const AccountingFieldCriteriaSelector = ({
         </div>
 
         <span onClick={handleEditablePartClick} data-fs-bp-editable-part>
-          "].value)
+          <LocalizationEslintIgnore>"].value)</LocalizationEslintIgnore>
         </span>
       </div>
     </div>

package/src/features/buying-policies/components/AccountingFieldCriteriaSelector/AccountingValueCriteriaSelector.tsx

@@ -8,6 +8,7 @@ import {
   useListAccountingValues,
 } from "../../../accounting-fields/hooks";
 import { CustomDropdown } from "../../../shared/components/CustomDropdown/CustomDropdown";
+import { LocalizationEslintIgnore } from "../../../shared/components/LocalizationEslintIgnore/LocalizationEslintIgnore";
 import { useBuyerPortal, useDebounce } from "../../../shared/hooks";
 import { useLocalization } from "../../../shared/localization/LocalizationContext";
 import {
@@ -216,7 +217,9 @@ export const AccountingValueCriteriaSelector = ({
     <div data-fs-bp-accounting-field-criteria-selector>
       <div data-fs-bp-accounting-fields-criteria-string>
         <span onClick={handleEditablePartClick} data-fs-bp-editable-part>
-          customData.customFields.fields[customFieldId="
+          <LocalizationEslintIgnore>
+            customData.customFields.fields[customFieldId="
+          </LocalizationEslintIgnore>
         </span>
 
         <div onClick={handleFieldClick} style={{ display: "inline-block" }}>
@@ -244,7 +247,9 @@ export const AccountingValueCriteriaSelector = ({
         </div>
 
         <span onClick={handleEditablePartClick} data-fs-bp-editable-part>
-          "].customFieldValueId="
+          <LocalizationEslintIgnore>
+            "].customFieldValueId="
+          </LocalizationEslintIgnore>
         </span>
 
         <div onClick={handleValueClick} style={{ display: "inline-block" }}>
@@ -275,7 +280,7 @@ export const AccountingValueCriteriaSelector = ({
         </div>
 
         <span onClick={handleEditablePartClick} data-fs-bp-editable-part>
-          "
+          <LocalizationEslintIgnore>"</LocalizationEslintIgnore>
         </span>
       </div>
     </div>

package/src/features/buying-policies/components/BudgetCriteriaSelector/BudgetCriteriaSelector.tsx

@@ -1,6 +1,7 @@
 import { useState, useEffect } from "react";
 
 import { CustomDropdown } from "../../../shared/components/CustomDropdown/CustomDropdown";
+import { LocalizationEslintIgnore } from "../../../shared/components/LocalizationEslintIgnore/LocalizationEslintIgnore";
 import { useBuyerPortal } from "../../../shared/hooks";
 import { useLocalization } from "../../../shared/localization/LocalizationContext";
 import { useGetBudgets } from "../../hooks/useGetBudgets";
@@ -90,7 +91,9 @@ export const BudgetCriteriaSelector = ({
     <div data-fs-bp-budget-criteria-selector>
       <div data-fs-bp-budget-criteria-string>
         <span onClick={handleEditablePartClick} data-fs-bp-editable-part>
-          $exists(budgetData.budgets[id="
+          <LocalizationEslintIgnore>
+            $exists(budgetData.budgets[id="
+          </LocalizationEslintIgnore>
         </span>
 
         <div onClick={handleBudgetValueClick}>
@@ -115,7 +118,7 @@ export const BudgetCriteriaSelector = ({
         </div>
 
         <span onClick={handleEditablePartClick} data-fs-bp-editable-part>
-          "])
+          <LocalizationEslintIgnore>"])</LocalizationEslintIgnore>
         </span>
       </div>
     </div>

package/src/features/contracts/components/UnableToRemoveContractsDrawer/UnableToRemoveContractsDrawer.tsx

@@ -37,6 +37,7 @@ export const UnableToRemoveContractsDrawer = ({
         </p>
         <p>
           {t("contracts.removeDrawer.unableDeselectHint", [
+            // eslint-disable-next-line no-restricted-syntax -- legacy hardcoded string, pending migration (see specs/custom-localization-system.md#out-of-scope)
             <strong key="organizationalUnit">organizational unit</strong>,
           ])}
         </p>

package/src/features/org-units/components/AddAllToOrgUnitDropdown/AddAllToOrgUnitDropdown.tsx

@@ -12,7 +12,10 @@ import { AddBuyingPolicyDrawer } from "../../../buying-policies/components";
 import { CreateCreditCardDrawer } from "../../../credit-cards/components";
 import { useGetRolesOptions } from "../../../roles/hooks";
 import { BasicDropdownMenu, Icon } from "../../../shared/components";
-import { useDrawerProps } from "../../../shared/hooks";
+import {
+  useDrawerProps,
+  useIsAddressEditingRestricted,
+} from "../../../shared/hooks";
 import { useLocalization } from "../../../shared/localization/LocalizationContext";
 import { CreateUserDrawerSelector } from "../../../users/components";
 
@@ -38,6 +41,7 @@ export const AddAllToOrgUnitDropdown = ({
   const { t } = useLocalization();
   const sizeProps = { width: 20, height: 20 };
   const { rolesOptions } = useGetRolesOptions(unitId);
+  const isAddressEditingRestricted = useIsAddressEditingRestricted();
 
   const {
     open: openCreditCardDrawer,
@@ -119,10 +123,12 @@ export const AddAllToOrgUnitDropdown = ({
 
         {isSingleContract && (
           <>
-            <DropdownItem onClick={openAddressDrawer}>
-              <Icon name="LocalPostOffice" {...sizeProps} />
-              {t("shared.orgUnitDropdown.addAddress")}
-            </DropdownItem>
+            {!isAddressEditingRestricted && (
+              <DropdownItem onClick={openAddressDrawer}>
+                <Icon name="LocalPostOffice" {...sizeProps} />
+                {t("shared.orgUnitDropdown.addAddress")}
+              </DropdownItem>
+            )}
             <DropdownItem onClick={openCreditCardDrawer}>
               <Icon name="CreditCard" {...sizeProps} />
               {t("shared.orgUnitDropdown.addCreditCard")}
@@ -181,7 +187,7 @@ export const AddAllToOrgUnitDropdown = ({
         />
       )}
 
-      {isOpenAddressDrawer && (
+      {isOpenAddressDrawer && !isAddressEditingRestricted && (
         <CreateAddressDrawer
           {...addressDrawerProps}
           isOpen={isOpenAddressDrawer}

package/src/features/recipients/components/RecipientsList/RecipientsList.tsx

@@ -18,6 +18,7 @@ export type RecipientsListProps = {
   countryCode?: CountryCodes;
   onEditRecipient: (recipient: RecipientData) => void;
   onDeleteRecipient: (recipient: RecipientData) => void;
+  hideActions?: boolean;
 };
 
 export const RecipientsList = ({
@@ -27,11 +28,12 @@ export const RecipientsList = ({
   countryCode,
   onEditRecipient,
   onDeleteRecipient,
+  hideActions = false,
 }: RecipientsListProps) => {
   const { t } = useLocalization();
 
   const columns = getTableColumns({
-    actionsLength: 2,
+    actionsLength: hideActions ? 0 : 2,
     nameColumnSize: "11.125rem",
     nameColumnLabel: t("shared.labels.name"),
     extraColumns: [
@@ -46,6 +48,10 @@ export const RecipientsList = ({
   });
 
   const renderActions = (recipient: RecipientData) => {
+    if (hideActions) {
+      return undefined;
+    }
+
     return [
       <IconButton
         data-fs-bp-recipients-action-icon

package/src/features/shared/clients/Auth.ts

@@ -2,6 +2,8 @@ import { getApiUrl } from "../../shared/utils";
 
 import { Client } from "./Client";
 
+import type { StorefrontResourceName } from "../utils/constants";
+
 type AuthContextProps = {
   cookie: string;
 };
@@ -28,6 +30,18 @@ export default class AuthClient extends Client {
       },
     });
   }
+
+  hasStorefrontResource(
+    resourceName: StorefrontResourceName,
+    context: AuthContextProps
+  ) {
+    return this.get<boolean | string>(`permissions/granted/${resourceName}`, {
+      headers: {
+        Cookie: context.cookie,
+        "Content-Type": "text/plain",
+      },
+    });
+  }
 }
 
 const authClient = new AuthClient();

package/src/features/shared/components/BuyerPortalProvider/BuyerPortalProvider.tsx

@@ -20,6 +20,11 @@ export type FeatureFlags = {
   authSettings?: AuthSettingsFeatureFlags;
   suma?: boolean;
   enableRecipientsContractLevel?: boolean;
+  enableAddressRestriction?: boolean;
+};
+
+export type StorefrontPermissions = {
+  canManageAddresses: boolean;
 };
 
 export type BuyerPortalContextType = {
@@ -28,6 +33,7 @@ export type BuyerPortalContextType = {
   currentContract?: ContractData | null;
   currentUser?: UserData | null;
   featureFlags?: FeatureFlags;
+  permissions?: StorefrontPermissions;
 };
 
 export const BuyerPortalContext = createContext<

package/src/features/shared/components/LocalizationEslintIgnore/LocalizationEslintIgnore.tsx

@@ -0,0 +1,12 @@
+export type LocalizationEslintIgnoreProps = {
+  children: React.ReactNode;
+};
+
+/**
+ * Wraps non-translatable literals (e.g. technical/DSL syntax) so the
+ * localization guardrail ignores them. `eslint.config.mjs` exempts this
+ * component by name. See docs/conventions.md#localization.
+ */
+export const LocalizationEslintIgnore = ({
+  children,
+}: LocalizationEslintIgnoreProps) => <>{children}</>;

package/src/features/shared/components/index.ts

@@ -35,6 +35,7 @@ export {
   type BuyerPortalContextType,
   type BuyerPortalProviderProps,
   type FeatureFlags,
+  type StorefrontPermissions,
 } from "./BuyerPortalProvider/BuyerPortalProvider";
 export { Card, CardBody, CardFooter, CardHeader } from "./Card";
 export {
@@ -73,6 +74,10 @@ export {
   LevelDivider,
   type LevelDividerProps,
 } from "./LevelDivider/LevelDivider";
+export {
+  LocalizationEslintIgnore,
+  type LocalizationEslintIgnoreProps,
+} from "./LocalizationEslintIgnore/LocalizationEslintIgnore";
 export { Logo } from "./Logo/Logo";
 export { MainLinksDropdownMenu } from "./MainLinksDropdownMenu/MainLinksDropdownMenu";
 export { Pagination } from "./Pagination/Pagination";

package/src/features/shared/hooks/index.ts

@@ -1,4 +1,5 @@
 export { useBuyerPortal } from "./useBuyerPortal";
+export { useIsAddressEditingRestricted } from "./useIsAddressEditingRestricted";
 export { useDrawerProps, type DrawerProps } from "./useDrawerProps";
 export {
   useMutation,

package/src/features/shared/hooks/useIsAddressEditingRestricted.ts

@@ -0,0 +1,12 @@
+import { isAddressEditingRestricted } from "../utils/isAddressEditingRestricted";
+
+import { useBuyerPortal } from "./useBuyerPortal";
+
+export const useIsAddressEditingRestricted = (): boolean => {
+  const { featureFlags, permissions } = useBuyerPortal();
+
+  return isAddressEditingRestricted({
+    enableAddressRestriction: featureFlags?.enableAddressRestriction,
+    canManageAddresses: permissions?.canManageAddresses,
+  });
+};

package/src/features/shared/layouts/SumaPageLayout/SumaSidebar.tsx

@@ -48,7 +48,7 @@ export const SumaSidebar = ({
           aria-label="Back to contracts"
         >
           <Icon name="ChevronRight" width={16} height={16} />
-          Contracts
+          {t("layouts.navigation.contracts")}
         </Link>
       )}
 

package/src/features/shared/services/__tests__/has-storefront-resource.service.test.ts

@@ -0,0 +1,69 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+vi.mock("discovery.config", () => ({
+  default: {
+    api: { storeId: "test-store" },
+    secureSubdomain: "https://test.vtex.com",
+  },
+}));
+
+const hasStorefrontResourceMock = vi.fn();
+
+vi.mock("../../clients/Auth", () => ({
+  authClient: {
+    hasStorefrontResource: (...args: unknown[]) =>
+      hasStorefrontResourceMock(...args),
+  },
+}));
+
+import { hasStorefrontResourceService } from "../has-storefront-resource.service";
+
+describe("hasStorefrontResourceService", () => {
+  beforeEach(() => {
+    hasStorefrontResourceMock.mockReset();
+  });
+
+  it("returns true when the BFF answers true", async () => {
+    hasStorefrontResourceMock.mockResolvedValue(true);
+
+    await expect(
+      hasStorefrontResourceService({
+        cookie: "cookie",
+        resourceName: "manage-addresses",
+      })
+    ).resolves.toBe(true);
+  });
+
+  it("returns true when the BFF answers the string true", async () => {
+    hasStorefrontResourceMock.mockResolvedValue("true");
+
+    await expect(
+      hasStorefrontResourceService({
+        cookie: "cookie",
+        resourceName: "manage-addresses",
+      })
+    ).resolves.toBe(true);
+  });
+
+  it("returns false when the BFF answers false", async () => {
+    hasStorefrontResourceMock.mockResolvedValue(false);
+
+    await expect(
+      hasStorefrontResourceService({
+        cookie: "cookie",
+        resourceName: "manage-addresses",
+      })
+    ).resolves.toBe(false);
+  });
+
+  it("fails closed when the BFF throws", async () => {
+    hasStorefrontResourceMock.mockRejectedValue(new Error("network"));
+
+    await expect(
+      hasStorefrontResourceService({
+        cookie: "cookie",
+        resourceName: "manage-addresses",
+      })
+    ).resolves.toBe(false);
+  });
+});

package/src/features/shared/services/feature-flags/__tests__/get-feature-flags.service.test.ts

@@ -51,11 +51,16 @@ describe("normalizeFlagsEndpointBooleans", () => {
 
   it("preserves other flags alongside suma", () => {
     const result = normalizeFlagsEndpointBooleans({
-      flags: { suma: true, enable_alternative_login: true },
+      flags: {
+        suma: true,
+        enable_alternative_login: true,
+        enable_address_restriction: true,
+      },
     });
 
     expect(result["suma"]).toBe(true);
     expect(result["enable_alternative_login"]).toBe(true);
+    expect(result["enable_address_restriction"]).toBe(true);
   });
 });
 

package/src/features/shared/services/feature-flags/get-feature-flags.service.ts

@@ -100,5 +100,6 @@ export async function getBuyerPortalFeatureFlags(
     enableRecipientsContractLevel:
       normalized["enable_recipients_contract_level"] ?? false,
     suma: normalized["suma"] ?? false,
+    enableAddressRestriction: normalized["enable_address_restriction"] ?? false,
   };
 }

package/src/features/shared/services/has-storefront-resource.service.ts

@@ -0,0 +1,27 @@
+import { authClient } from "../clients/Auth";
+
+import type { StorefrontResourceName } from "../utils/constants";
+
+export type HasStorefrontResourceServiceProps = {
+  cookie: string;
+  resourceName: StorefrontResourceName;
+};
+
+function isGranted(value: unknown): boolean {
+  return value === true || value === "true";
+}
+
+export const hasStorefrontResourceService = async ({
+  cookie,
+  resourceName,
+}: HasStorefrontResourceServiceProps): Promise<boolean> => {
+  try {
+    const result = await authClient.hasStorefrontResource(resourceName, {
+      cookie,
+    });
+
+    return isGranted(result);
+  } catch {
+    return false;
+  }
+};

package/src/features/shared/services/index.ts

@@ -14,6 +14,10 @@ export {
   validateOrderEntryAccessService,
   type ValidateOrderEntryAccessServiceProps,
 } from "./validate-order-entry-access.service";
+export {
+  hasStorefrontResourceService,
+  type HasStorefrontResourceServiceProps,
+} from "./has-storefront-resource.service";
 export * from "./logger";
 export {
   getDependenciesVersionService,

package/src/features/shared/utils/__tests__/isAddressEditingRestricted.test.ts

@@ -0,0 +1,44 @@
+import { describe, expect, it } from "vitest";
+
+import { isAddressEditingRestricted } from "../isAddressEditingRestricted";
+
+describe("isAddressEditingRestricted", () => {
+  it("is false when the flag is off", () => {
+    expect(
+      isAddressEditingRestricted({
+        enableAddressRestriction: false,
+        canManageAddresses: false,
+      })
+    ).toBe(false);
+  });
+
+  it("is false when the flag is on and the user can manage addresses", () => {
+    expect(
+      isAddressEditingRestricted({
+        enableAddressRestriction: true,
+        canManageAddresses: true,
+      })
+    ).toBe(false);
+  });
+
+  it("is true when the flag is on and the user cannot manage addresses", () => {
+    expect(
+      isAddressEditingRestricted({
+        enableAddressRestriction: true,
+        canManageAddresses: false,
+      })
+    ).toBe(true);
+  });
+
+  it("fails closed when the flag is on and the permission is unknown", () => {
+    expect(
+      isAddressEditingRestricted({
+        enableAddressRestriction: true,
+      })
+    ).toBe(true);
+  });
+
+  it("is false when both values are omitted", () => {
+    expect(isAddressEditingRestricted({})).toBe(false);
+  });
+});

package/src/features/shared/utils/__tests__/withAuthLoader.test.ts

@@ -5,6 +5,8 @@ import { withAuthLoader } from "../withAuthLoader";
 import type { LoaderData } from "../../types";
 
 const validateAccessServiceMock = vi.fn();
+const hasStorefrontResourceServiceMock = vi.fn();
+const getBuyerPortalFeatureFlagsMock = vi.fn().mockResolvedValue({});
 
 vi.mock("../../services", () => ({
   validateAccessService: (...args: unknown[]) =>
@@ -12,7 +14,13 @@ vi.mock("../../services", () => ({
 }));
 
 vi.mock("../../services/feature-flags/get-feature-flags.service", () => ({
-  getBuyerPortalFeatureFlags: vi.fn().mockResolvedValue({}),
+  getBuyerPortalFeatureFlags: (...args: unknown[]) =>
+    getBuyerPortalFeatureFlagsMock(...args),
+}));
+
+vi.mock("../../services/has-storefront-resource.service", () => ({
+  hasStorefrontResourceService: (...args: unknown[]) =>
+    hasStorefrontResourceServiceMock(...args),
 }));
 
 vi.mock("../getClientContext", () => ({
@@ -35,6 +43,9 @@ const createLoaderData = (): LoaderData => ({
 describe("withAuthLoader", () => {
   beforeEach(() => {
     validateAccessServiceMock.mockReset();
+    hasStorefrontResourceServiceMock.mockReset();
+    getBuyerPortalFeatureFlagsMock.mockReset();
+    getBuyerPortalFeatureFlagsMock.mockResolvedValue({});
   });
 
   it("uses the custom validateAccess option instead of the default when granted", async () => {
@@ -81,4 +92,41 @@ describe("withAuthLoader", () => {
     });
     expect(result.authorized).toBe(true);
   });
+
+  it("does not call the permission API when address restriction is off", async () => {
+    validateAccessServiceMock.mockResolvedValue(true);
+    getBuyerPortalFeatureFlagsMock.mockResolvedValue({
+      enableAddressRestriction: false,
+    });
+
+    await withAuthLoader(createLoaderData(), async () => ({ context: {} }));
+
+    expect(hasStorefrontResourceServiceMock).not.toHaveBeenCalled();
+  });
+
+  it("calls the permission API and merges the result when address restriction is on", async () => {
+    validateAccessServiceMock.mockResolvedValue(true);
+    getBuyerPortalFeatureFlagsMock.mockResolvedValue({
+      enableAddressRestriction: true,
+    });
+    hasStorefrontResourceServiceMock.mockResolvedValue(false);
+
+    const result = await withAuthLoader(createLoaderData(), async () => ({
+      context: {},
+    }));
+
+    expect(hasStorefrontResourceServiceMock).toHaveBeenCalledWith({
+      cookie: "cookie-value",
+      resourceName: "manage-addresses",
+    });
+    expect(result).toMatchObject({
+      authorized: true,
+      data: {
+        context: {
+          featureFlags: { enableAddressRestriction: true },
+          permissions: { canManageAddresses: false },
+        },
+      },
+    });
+  });
 });

package/src/features/shared/utils/constants.ts

@@ -4,7 +4,7 @@ export const API_URL = (checkoutUrl: string, operation?: string) =>
   `${checkoutUrl}/_v/store-front/${operation}`;
 // DEV URL - CHANGE BEFORE MERGE
 // export const API_URL = (checkoutUrl?: string, operation?: string) =>
-//   `https://altphonenumber--b2bfaststoredev.myvtex.com/_v/store-front/${operation}`;
+//   `https://nicholasb2b--b2bfaststoreqa.myvtex.com/_v/store-front/${operation}`;
 
 export const DEBOUNCE_TIMEOUT = 500;
 
@@ -25,4 +25,12 @@ export const SCOPE_KEYS = {
   CREDIT_CARDS: "creditCards",
 } as const;
 
-export const CURRENT_VERSION = "2.0.28";
+/** Public names for GET /_v/store-front/permissions/granted/:resourceName */
+export const STOREFRONT_RESOURCE_NAMES = {
+  MANAGE_ADDRESSES: "manage-addresses",
+} as const;
+
+export type StorefrontResourceName =
+  (typeof STOREFRONT_RESOURCE_NAMES)[keyof typeof STOREFRONT_RESOURCE_NAMES];
+
+export const CURRENT_VERSION = "2.0.30";

package/src/features/shared/utils/index.ts

@@ -13,7 +13,11 @@ export {
   DEBOUNCE_TIMEOUT,
   DEFAULT_PAGE_SIZE,
   SCOPE_KEYS,
+  STOREFRONT_RESOURCE_NAMES,
+  type StorefrontResourceName,
 } from "./constants";
+export { isAddressEditingRestricted } from "./isAddressEditingRestricted";
+export type { AddressRestrictionInput } from "./isAddressEditingRestricted";
 export {
   getAuthCookie,
   getCookieAsString,

package/src/features/shared/utils/isAddressEditingRestricted.ts

@@ -0,0 +1,10 @@
+export type AddressRestrictionInput = {
+  enableAddressRestriction?: boolean;
+  canManageAddresses?: boolean;
+};
+
+export const isAddressEditingRestricted = ({
+  enableAddressRestriction,
+  canManageAddresses,
+}: AddressRestrictionInput): boolean =>
+  enableAddressRestriction === true && canManageAddresses !== true;

package/src/features/shared/utils/withAuthLoader.ts

@@ -2,7 +2,9 @@ import { LOCALIZATION_ENTRY_IDS } from "../localization/constants";
 import { getLocalizationLabelsService } from "../localization/services/get-localization-labels.service";
 import { validateAccessService } from "../services";
 import { getBuyerPortalFeatureFlags } from "../services/feature-flags/get-feature-flags.service";
+import { hasStorefrontResourceService } from "../services/has-storefront-resource.service";
 
+import { STOREFRONT_RESOURCE_NAMES } from "./constants";
 import { ClientContext, getClientContext } from "./getClientContext";
 
 import type { FeatureFlags } from "../components/BuyerPortalProvider/BuyerPortalProvider";
@@ -46,10 +48,23 @@ export const withAuthLoader = async <T>(
     }
 
     const featureFlagsPromise = getBuyerPortalFeatureFlags(cookie);
-
-    const [pageData, featureFlags] = await Promise.all([
+    const canManageAddressesPromise = featureFlagsPromise.then(
+      async (flags) => {
+        if (!flags.enableAddressRestriction) {
+          return true;
+        }
+
+        return hasStorefrontResourceService({
+          cookie,
+          resourceName: STOREFRONT_RESOURCE_NAMES.MANAGE_ADDRESSES,
+        });
+      }
+    );
+
+    const [pageData, featureFlags, canManageAddresses] = await Promise.all([
       dataLoader({ cookie, userId, ...clientContext, featureFlagsPromise }),
       featureFlagsPromise,
+      canManageAddressesPromise,
     ]);
 
     const mergedPageData = (() => {
@@ -67,9 +82,12 @@ export const withAuthLoader = async <T>(
       const currentFeatureFlags =
         (currentContext as { featureFlags?: Record<string, unknown> })
           .featureFlags ?? {};
+      const currentPermissions =
+        (currentContext as { permissions?: Record<string, unknown> })
+          .permissions ?? {};
 
       return {
-        ...(pageData as Record<string, unknown>),
+        ...(pageData as unknown as Record<string, unknown>),
         context: {
           ...currentContext,
           featureFlags: {
@@ -78,8 +96,14 @@ export const withAuthLoader = async <T>(
               ? currentFeatureFlags
               : {}),
           },
+          permissions: {
+            canManageAddresses,
+            ...(typeof currentPermissions === "object"
+              ? currentPermissions
+              : {}),
+          },
         },
-      } as T;
+      } as unknown as T;
     })();
 
     return {