From b917e621cc25d387a395c6c83f8a783ec7f4b821 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 11 Oct 2023 17:05:44 +0200
Subject: [PATCH 01/49] fix(admin-ui): Make ExtensionHostComponent work with
 new extension APIs

The new APIs require standalone components.
---
 .../components/extension-host/extension-host.component.ts      | 3 +++
 packages/admin-ui/src/lib/core/src/shared/shared.module.ts     | 2 --
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/packages/admin-ui/src/lib/core/src/shared/components/extension-host/extension-host.component.ts b/packages/admin-ui/src/lib/core/src/shared/components/extension-host/extension-host.component.ts
index f4f7e4ed74..ffabc06563 100644
--- a/packages/admin-ui/src/lib/core/src/shared/components/extension-host/extension-host.component.ts
+++ b/packages/admin-ui/src/lib/core/src/shared/components/extension-host/extension-host.component.ts
@@ -9,6 +9,7 @@ import {
 } from '@angular/core';
 import { DomSanitizer, SafeResourceUrl } from '@angular/platform-browser';
 import { ActivatedRoute } from '@angular/router';
+import { SharedModule } from '../../shared.module';
 
 import { ExtensionHostConfig } from './extension-host-config';
 import { ExtensionHostService } from './extension-host.service';
@@ -22,6 +23,8 @@ import { ExtensionHostService } from './extension-host.service';
     templateUrl: './extension-host.component.html',
     styleUrls: ['./extension-host.component.scss'],
     changeDetection: ChangeDetectionStrategy.Default,
+    standalone: true,
+    imports: [SharedModule],
     providers: [ExtensionHostService],
 })
 export class ExtensionHostComponent implements OnInit, AfterViewInit, OnDestroy {
diff --git a/packages/admin-ui/src/lib/core/src/shared/shared.module.ts b/packages/admin-ui/src/lib/core/src/shared/shared.module.ts
index 5f03fd28de..9ca91622c4 100644
--- a/packages/admin-ui/src/lib/core/src/shared/shared.module.ts
+++ b/packages/admin-ui/src/lib/core/src/shared/shared.module.ts
@@ -59,7 +59,6 @@ import { DropdownComponent } from './components/dropdown/dropdown.component';
 import { EditNoteDialogComponent } from './components/edit-note-dialog/edit-note-dialog.component';
 import { EmptyPlaceholderComponent } from './components/empty-placeholder/empty-placeholder.component';
 import { EntityInfoComponent } from './components/entity-info/entity-info.component';
-import { ExtensionHostComponent } from './components/extension-host/extension-host.component';
 import { FacetValueChipComponent } from './components/facet-value-chip/facet-value-chip.component';
 import { FacetValueSelectorComponent } from './components/facet-value-selector/facet-value-selector.component';
 import { FocalPointControlComponent } from './components/focal-point-control/focal-point-control.component';
@@ -249,7 +248,6 @@ const DECLARATIONS = [
     ChannelAssignmentControlComponent,
     ChannelLabelPipe,
     IfDefaultChannelActiveDirective,
-    ExtensionHostComponent,
     CustomFieldLabelPipe,
     CustomFieldDescriptionPipe,
     FocalPointControlComponent,

From 92cad43fdc005230a91013290ba6f6de58307840 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Thu, 12 Oct 2023 14:13:41 +0200
Subject: [PATCH 02/49] fix(core): Fix regression in ProductService.findOne not
 using relations

Fixes #2443
---
 packages/core/src/service/services/product.service.ts | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/core/src/service/services/product.service.ts b/packages/core/src/service/services/product.service.ts
index b5f2dbd98a..39ec1c63c3 100644
--- a/packages/core/src/service/services/product.service.ts
+++ b/packages/core/src/service/services/product.service.ts
@@ -120,12 +120,7 @@ export class ProductService {
             effectiveRelations.push('facetValues.facet');
         }
         const product = await this.connection.findOneInChannel(ctx, Product, productId, ctx.channelId, {
-            // relations: unique(effectiveRelations),
-            relations: {
-                facetValues: {
-                    facet: true,
-                },
-            },
+            relations: unique(effectiveRelations),
             where: {
                 deletedAt: IsNull(),
             },

From eb548906dd0c180e0e74e0866ef39249ab647203 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Thu, 12 Oct 2023 14:29:47 +0200
Subject: [PATCH 03/49] docs: Add redirects for old docs urls

---
 docs/static/_redirects | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 docs/static/_redirects

diff --git a/docs/static/_redirects b/docs/static/_redirects
new file mode 100644
index 0000000000..95e6949e57
--- /dev/null
+++ b/docs/static/_redirects
@@ -0,0 +1,22 @@
+# Add redirects for popular pages from old docs
+/getting-started                            /guides/getting-started/installation
+/developer-guide/customizing-models         /guides/developer-guide/custom-fields
+/developer-guide/authentication             /guides/core-concepts/auth
+/developer-guide/payment-integrations       /reference/core-plugins/payments-plugin
+/plugins                                    /guides/developer-guide/plugins
+/plugins/extending-the-admin-ui             /guides/extending-the-admin-ui/getting-started
+/storefront/building-a-storefront           /guides/storefront/storefront-starters
+/developer-guide/multi-vendor-marketplaces  /guides/how-to/multi-vendor-marketplaces
+/developer-guide/configuration              /guides/developer-guide/configuration
+/plugins/plugin-examples/extending-graphql-api  /guides/developer-guide/extend-graphql-api
+/storefront/order-workflow                  /guides/storefront/active-order
+/typescript-api/custom-fields               /reference/typescript-api/custom-fields
+/developer-guide/migrations                 /guides/developer-guide/migrations
+/typescript-api/core-plugins/payments-plugin/stripe-plugin  /reference/core-plugins/payments-plugin/stripe-plugin
+/developer-guide/channels                   /guides/core-concepts/channels
+/graphql-api/shop                           /reference/graphql-api/shop/queries
+/developer-guide/customizing-the-order-process  /guides/core-concepts/orders
+/developer-guide/importing-product-data     /guides/developer-guide/importing-data
+/plugins/plugin-examples                    /guides/developer-guide/plugins
+/plugins/writing-a-vendure-plugin           /guides/developer-guide/plugins
+/deployment/using-docker                    /guides/deployment/using-docker

From 9aac191e7e39b0501d0891b147b562a8206e972e Mon Sep 17 00:00:00 2001
From: Gautier Darchen <gautier.darchen@swile.co>
Date: Thu, 12 Oct 2023 14:32:00 +0200
Subject: [PATCH 04/49] fix(common): Remove trademark symbols from normalized
 strings (#2447)

---
 packages/common/src/normalize-string.spec.ts | 2 +-
 packages/common/src/normalize-string.ts      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/common/src/normalize-string.spec.ts b/packages/common/src/normalize-string.spec.ts
index 27bfca888d..b0324c8ac1 100644
--- a/packages/common/src/normalize-string.spec.ts
+++ b/packages/common/src/normalize-string.spec.ts
@@ -25,7 +25,7 @@ describe('normalizeString()', () => {
     it('strips non-alphanumeric characters', () => {
         expect(normalizeString('hi!!!')).toBe('hi');
         expect(normalizeString('who? me?')).toBe('who me');
-        expect(normalizeString('!"£$%^&*()+[]{};:@#~?/,|\\><`¬\'=')).toBe('');
+        expect(normalizeString('!"£$%^&*()+[]{};:@#~?/,|\\><`¬\'=©®™')).toBe('');
     });
 
     it('allows a subset of non-alphanumeric characters to pass through', () => {
diff --git a/packages/common/src/normalize-string.ts b/packages/common/src/normalize-string.ts
index 48aa45c676..b3fc74c814 100644
--- a/packages/common/src/normalize-string.ts
+++ b/packages/common/src/normalize-string.ts
@@ -8,6 +8,6 @@ export function normalizeString(input: string, spaceReplacer = ' '): string {
         .normalize('NFD')
         .replace(/[\u0300-\u036f]/g, '')
         .toLowerCase()
-        .replace(/[!"£$%^&*()+[\]{};:@#~?\\/,|><`¬'=‘’]/g, '')
+        .replace(/[!"£$%^&*()+[\]{};:@#~?\\/,|><`¬'=‘’©®™]/g, '')
         .replace(/\s+/g, spaceReplacer);
 }

From b594c55a9db4a1a1bc2ff0ef17e27da28fa8fd10 Mon Sep 17 00:00:00 2001
From: kristiand00 <63717005+kristiand00@users.noreply.github.com>
Date: Thu, 12 Oct 2023 14:33:33 +0200
Subject: [PATCH 05/49] feat(admin-ui): Add Croatian translation (#2442)

---
 .../src/lib/static/i18n-messages/hr.json      | 795 ++++++++++++++++++
 1 file changed, 795 insertions(+)
 create mode 100644 packages/admin-ui/src/lib/static/i18n-messages/hr.json

diff --git a/packages/admin-ui/src/lib/static/i18n-messages/hr.json b/packages/admin-ui/src/lib/static/i18n-messages/hr.json
new file mode 100644
index 0000000000..9119278775
--- /dev/null
+++ b/packages/admin-ui/src/lib/static/i18n-messages/hr.json
@@ -0,0 +1,795 @@
+{
+  "admin": {
+    "create-new-administrator": "Kreiraj novog administratora"
+  },
+  "asset": {
+    "add-asset": "Dodaj medij",
+    "add-asset-with-count": "Dodaj {count, plural, =0 {medija} one {1 medij} few {{count} medija} other {{count} medija}}",
+    "assets-selected-count": "Odabrano {count} medija",
+    "dimensions": "Dimenzije",
+    "focal-point": "Fokalna točka",
+    "notify-create-assets-success": "Kreirano {count, plural, one {1 novo sredstvo} few {{count} nova sredstva} other {{count} novih sredstava}}",
+    "original-asset-size": "Izvorna veličina",
+    "preview": "Pregled",
+    "remove-asset": "Ukloni medij",
+    "select-asset": "Odaberi medij",
+    "select-assets": "Odaberi medije",
+    "set-as-featured-asset": "Postavi kao istaknuti medij",
+    "set-focal-point": "Postavi fokalnu točku",
+    "source-file": "Izvorna datoteka",
+    "unset-focal-point": "Poništi",
+    "update-focal-point": "Ažuriraj točku",
+    "update-focal-point-error": "Nije moguće ažurirati fokalnu točku",
+    "update-focal-point-success": "Fokalna točka ažurirana",
+    "upload-assets": "Prenesi medije",
+    "uploading": "Prenosim..."
+  },
+  "breadcrumb": {
+    "administrators": "Administratori",
+    "assets": "Mediji",
+    "channels": "Kanali",
+    "collections": "Kolekcije",
+    "countries": "Zemlje",
+    "customer-groups": "Grupa kupaca",
+    "customers": "Kupci",
+    "dashboard": "Kontrolna ploča",
+    "facets": "Aspekti",
+    "global-settings": "Globalne postavke",
+    "job-queue": "Red poslova",
+    "manage-variants": "Upravljaj varijantama",
+    "modifying": "Uređivanje",
+    "orders": "Narudžbe",
+    "payment-methods": "Načini plaćanja",
+    "product-options": "Opcije proizvoda",
+    "products": "Artikli",
+    "profile": "Profil",
+    "promotions": "Promocije",
+    "roles": "Uloge",
+    "seller-orders": "Narudžbe prodavača",
+    "sellers": "Prodavači",
+    "shipping-methods": "Načini dostave",
+    "stock-locations": "Lokacije zaliha",
+    "system-status": "Status sustava",
+    "tax-categories": "Porezne kategorije",
+    "tax-rates": "Porezne stope",
+    "zones": "Zone"
+  },
+  "catalog": {
+    "add-facet-value": "Dodaj vrijednost aspekta",
+    "add-facets": "Dodaj aspekte",
+    "add-option": "Dodaj opciju",
+    "add-price-in-another-currency": "Dodaj cijenu u drugoj valuti",
+    "add-stock-location": "Dodaj lokaciju zaliha",
+    "add-stock-to-location": "Dodaj zalihe na lokaciju",
+    "asset": "Sredstvo",
+    "asset-preview-links": "Poveznice za pregled sredstva",
+    "assets": "Sredstva",
+    "assign-product-to-channel-success": "Uspješno dodijeljeno {count, plural, one {1 proizvod} other {{count} proizvoda}} kanalu {channel}",
+    "assign-products-to-channel": "Dodijeli proizvode kanalu",
+    "assign-to-channel": "Dodijeli kanalu",
+    "assign-to-named-channel": "Dodijeli kanalu {channelCode}",
+    "assign-variant-to-channel-success": "Uspješno dodijeljeno {count, plural, one {1 varijanta proizvoda} other {{count} varijanti proizvoda}} kanalu {channel}",
+    "assign-variants-to-channel": "Dodijeli varijante proizvoda kanalu",
+    "auto-update-option-variant-name": "Automatski ažuriraj nazive varijanti proizvoda koristeći ovu opciju",
+    "auto-update-product-variant-name": "Automatski ažuriraj nazive varijanti proizvoda",
+    "cannot-create-variants-without-options": "Nije moguće stvoriti varijante proizvoda dok nije definirana grupa opcija s najmanje dvije opcije proizvoda",
+    "channel-price-preview": "Pregled cijene za kanal",
+    "collection": "Kolekcija",
+    "collection-contents": "Sadržaj kolekcije",
+    "collections": "Kolekcije",
+    "confirm-bulk-delete-products": "Izbrisati {count} proizvoda?",
+    "confirm-cancel": "Odustati?",
+    "confirm-delete-assets": "Izbrisati {count} {count, plural, one {sredstvo} other {sredstava}}?",
+    "confirm-delete-facet-value": "Izbrisati vrijednost aspekta?",
+    "confirm-delete-product": "Izbrisati proizvod?",
+    "confirm-delete-product-option": "Izbrisati opciju proizvoda \"{name}\"?",
+    "confirm-delete-product-option-group": "Izbrisati grupu opcija proizvoda \"{name}\"?",
+    "confirm-delete-product-option-group-body": "Ova grupa opcija se koristi za {count} {count, plural, one {varijantu} other {varijante}}. Jeste li sigurni da želite izbrisati?",
+    "confirm-delete-product-variant": "Izbrisati varijantu proizvoda \"{name}\"?",
+    "confirm-deletion-of-unused-variants-body": "Sljedeće varijante proizvoda su postale zastarjele zbog dodavanja novih opcija. Bit će izbrisane tijekom stvaranja novih varijanti proizvoda.",
+    "confirm-deletion-of-unused-variants-title": "",
+    "create-draft-order": "Kreiraj privremenu narudžbu",
+    "create-new-collection": "Kreiraj novu kolekciju",
+    "create-new-facet": "Kreiraj novi aspekt",
+    "create-new-product": "Novi proizvod",
+    "create-new-stock-location": "Kreiraj novu lokaciju zaliha",
+    "create-product-option-group": "Kreiraj grupu opcija proizvoda",
+    "create-product-variant": "Kreiraj varijantu proizvoda",
+    "default-currency": "Zadana valuta",
+    "do-not-inherit-filters": "Ne nasljeđuj filtre",
+    "drop-files-to-upload": "Ispustite datoteke za prijenos",
+    "edit-facet-values": "Uredi vrijednosti aspekta",
+    "edit-options": "Uredi opcije",
+    "facet": "Aspekt",
+    "facet-value-not-available": "Vrijednost aspekta \"{id}\" nije dostupna",
+    "facet-values": "Vrijednosti aspekta",
+    "facets": "Aspekti",
+    "filter-by-name": "Filtriraj po imenu",
+    "filter-by-sku": "Filtriraj po SKU",
+    "filter-inheritance": "Nasljeđivanje filtera",
+    "filters": "Filteri",
+    "inherit-filters-from-parent": "Naslijedi filtere od roditelja",
+    "live-preview-contents": "Sadržaj uživo",
+    "manage-variants": "Upravljanje varijantama",
+    "move-collection-to": "Premjesti u {name}",
+    "move-collections": "Premjesti kolekcije",
+    "move-collections-success": "Premješteno {count} kolekcija",
+    "move-down": "Premjesti dolje",
+    "move-to": "Premjesti na",
+    "move-up": "Premjesti gore",
+    "name": "Naziv",
+    "no-channel-selected": "Nije odabran kanal",
+    "no-featured-asset": "Nema istaknutih sredstava",
+    "no-selection": "Nema odabira",
+    "no-stock-locations-available-on-current-channel": "Nema dostupnih lokacija zaliha na trenutnom kanalu. Postavite barem jednu lokaciju zaliha prije dodavanja proizvoda.",
+    "notify-bulk-delete-products-success": "Uspješno izbrisano {count, plural, one {1 proizvod} other {{count} proizvoda}}",
+    "notify-remove-facets-from-channel-success": "Uspješno uklonjeno {count, plural, one {1 aspekt} other {{count} aspekta}} iz kanala {channelCode}",
+    "notify-remove-product-from-channel-error": "Nije moguće ukloniti proizvod iz kanala",
+    "notify-remove-product-from-channel-success": "Uspješno uklonjen proizvod iz kanala",
+    "notify-remove-variant-from-channel-error": "Nije moguće ukloniti varijantu proizvoda iz kanala",
+    "notify-remove-variant-from-channel-success": "Uspješno uklonjena varijanta proizvoda iz kanala",
+    "number-of-variants": "Broj varijanti",
+    "option": "Opcija",
+    "option-name": "Naziv opcije",
+    "option-values": "Vrijednosti opcije",
+    "out-of-stock-threshold": "Prag rasprodaje",
+    "out-of-stock-threshold-tooltip": "Postavlja razinu zaliha na kojoj se ova varijanta smatra rasprodanom. Upotreba negativne vrijednosti omogućuje podršku za narudžbe proizvoda koji trenutačno nisu dostupni.",
+    "page-description-options-editor": "Uredi nazive i kodove opcija za ovaj proizvod. Za dodavanje ili uklanjanje opcija koristite gumb \"Upravljanje varijantama\" ispod popisa varijanti proizvoda.",
+    "price": "Cijena",
+    "price-and-tax": "Cijena i porez",
+    "price-conversion-factor": "Faktor konverzije cijene",
+    "price-in-channel": "Cijena u { channel }",
+    "price-includes-tax-at": "Uključuje porez od { rate }%",
+    "price-with-tax-in-default-zone": "Uklj. { rate }% poreza: { price }",
+    "private": "Privatno",
+    "product": "Proizvod",
+    "product-name": "Naziv proizvoda",
+    "product-options": "Opcije proizvoda",
+    "product-variant-exists": "Varijanta proizvoda s ovim opcijama već postoji",
+    "product-variants": "Varijante proizvoda",
+    "products": "Proizvodi",
+    "public": "Javno",
+    "quick-jump-placeholder": "Brzo pretraživanje varijante",
+    "rebuild-search-index": "Obnovi indeks pretraživanja",
+    "reindex-error": "Došlo je do pogreške prilikom obnove indeksa pretraživanja",
+    "reindex-successful": "Indeksirano {count, plural, one {proizvodna varijanta} other {{count} proizvodnih varijanti}} u {time}ms",
+    "reindexing": "Obnova indeksa pretraživanja",
+    "remove-from-channel": "Ukloni iz {channelCode, select, undefined{kanala} other{{channelCode}}}",
+    "remove-option": "Ukloni opciju",
+    "remove-product-from-channel": "Ukloni proizvod iz kanala",
+    "remove-product-variant-from-channel": "Ukloni varijantu proizvoda iz kanala",
+    "reorder-collection": "Promijeni redoslijed kolekcije",
+    "root-collection": "Glavna kolekcija",
+    "run-pending-search-index-updates": "Pretraživanje: izvrši {count, plural, one {1 čekajuću nadogradnju} other {{count} čekajućih nadogradnji}}",
+    "running-search-index-updates": "Izvršava se {count, plural, one {1 nadogradnja} other {{count} nadogradnji}} indeksa pretraživanja",
+    "search-asset-name-or-tag": "Pretraži po nazivu sredstva ili oznakama",
+    "search-for-term": "Pretraži po terminu",
+    "search-product-name-or-code": "Pretraži po nazivu proizvoda ili kodu",
+    "select-product": "Odaberi proizvod",
+    "select-product-variant": "Odaberi varijantu proizvoda",
+    "sku": "SKU",
+    "slug": "Slug",
+    "slug-pattern-error": "Slug nije valjan",
+    "stock-allocated": "Dodijeljeno",
+    "stock-levels": "Razine zaliha",
+    "stock-location": "Lokacija zaliha",
+    "stock-locations": "Lokacije zaliha",
+    "stock-on-hand": "Na skladištu",
+    "tax-category": "Porezna kategorija",
+    "taxes": "Porezi",
+    "track-inventory": "Prati inventar",
+    "track-inventory-false": "Ne prati",
+    "track-inventory-inherit": "Naslijedi iz globalnih postavki",
+    "track-inventory-tooltip": "Kada se prati, razine zaliha varijanti proizvoda automatski će se prilagođavati prilikom prodaje",
+    "track-inventory-true": "Prati",
+    "update-product-option": "Ažuriraj opciju proizvoda",
+    "use-global-value": "Koristi globalnu vrijednost",
+    "values": "Vrijednosti",
+    "variant": "Varijanta",
+    "variant-count": "{count, plural, one {1 varijanta} other {{count} varijante}}",
+    "view-contents": "Pregledaj sadržaj",
+    "visibility": "Vidljivost"
+  },
+  "common": {
+    "ID": "ID",
+    "add-filter": "Dodaj filter",
+    "add-item-to-list": "Dodaj stavku na popis",
+    "add-note": "Dodaj bilješku",
+    "apply": "Primijeni",
+    "assign-to-channel": "Dodijeli kanalu",
+    "available-currencies": "Dostupne valute",
+    "available-languages": "Dostupni jezici",
+    "boolean-and": "i",
+    "boolean-false": "netočno",
+    "boolean-or": "ili",
+    "boolean-true": "točno",
+    "breadcrumb": "Trag",
+    "browser-default": "Zadano za preglednik",
+    "cancel": "Odustani",
+    "cancel-navigation": "Prekini navigaciju",
+    "change-selection": "Promijeni odabir",
+    "channel": "Kanal",
+    "channels": "Kanali",
+    "clear-selection": "Očisti odabir",
+    "code": "Kod",
+    "collapse-entries": "Skupi unose",
+    "confirm": "Potvrdi",
+    "confirm-bulk-assign-to-channel": "Dodijeliti stavke kanalu?",
+    "confirm-bulk-delete": "Izbrisati odabrane stavke?",
+    "confirm-bulk-remove-from-channel": "Ukloniti stavke iz trenutnog kanala?",
+    "confirm-delete-note": "Izbrisati bilješku?",
+    "confirm-navigation": "Potvrdi navigaciju",
+    "contents": "Sadržaj",
+    "create": "Stvori",
+    "created-at": "Stvoreno u",
+    "custom-fields": "Prilagođena polja",
+    "data-table-filter-date-mode": "Mod datuma",
+    "data-table-filter-date-range": "Raspon datuma",
+    "data-table-filter-date-relative": "Relativan datum",
+    "default-channel": "Zadani kanal",
+    "default-language": "Zadani jezik",
+    "default-tax-category": "Zadana porezna kategorija",
+    "delete": "Izbriši",
+    "description": "Opis",
+    "details": "Detalji",
+    "disabled": "Onemogućeno",
+    "discard-changes": "Odbaci promjene",
+    "edit": "Uredi",
+    "edit-field": "Uredi polje",
+    "edit-note": "Uredi bilješku",
+    "enabled": "Omogućeno",
+    "end-date": "Datum završetka",
+    "expand-entries": "Proširi unose",
+    "extension-running-in-separate-window": "Proširenje radi u zasebnom prozoru",
+    "filter": "Filter",
+    "filter-preset-name": "Filter preset name",
+    "force-delete": "Snažno izbriši",
+    "force-remove": "Snažno ukloni",
+    "general": "Općenito",
+    "guest": "Gost",
+    "id": "ID",
+    "image": "Slika",
+    "items-per-page-option": "{ count } po stranici",
+    "items-selected-count": "{ count } {count, plural, one {stavka} other {stavke}} odabrano",
+    "keep-editing": "Nastavi uređivanje",
+    "language": "Jezik",
+    "launch-extension": "Pokreni proširenje",
+    "list-items-and-n-more": "{ items } i {nMore} više",
+    "live-update": "Stvarno vrijeme ažuriranje",
+    "locale": "Lokalno",
+    "log-out": "Odjava",
+    "login": "Prijava",
+    "login-image-title": "Bok! Dobrodošli natrag. Drago nam je vidjeti vas.",
+    "login-title": "Prijavi se na {brand}",
+    "manage-tags": "Upravljanje oznakama",
+    "manage-tags-description": "Ažurirajte ili izbrišite oznake globalno.",
+    "medium-date": "Srednji datum",
+    "more": "Više...",
+    "name": "Ime",
+    "no-alerts": "Nema upozorenja",
+    "no-bulk-actions-available": "Nema dostupnih grupnih radnji",
+    "no-results": "Nema rezultata",
+    "not-applicable": "Nije primjenjivo",
+    "not-set": "Nije postavljeno",
+    "notify-assign-to-channel-success-with-count": "Uspješno dodijeljeno {count, plural, one {1 stavka} other {{count} stavki}} kanalu { channelCode }",
+    "notify-bulk-update-success": "Ažurirano { count } { entity }",
+    "notify-create-error": "Došlo je do pogreške, nije moguće stvoriti { entity }",
+    "notify-create-success": "Stvoreno novo { entity }",
+    "notify-delete-error": "Došlo je do pogreške, nije moguće izbrisati { entity }",
+    "notify-delete-error-with-count": "Nije moguće izbrisati {count, plural, one {1 stavku} other {{count} stavki}}",
+    "notify-delete-success": "Izbrisano { entity }",
+    "notify-delete-success-with-count": "Uspješno izbrisano {count, plural, one {1 stavka} other {{count} stavki}}",
+    "notify-remove-from-channel-success-with-count": "Uspješno uklonjeno { count } stavki iz kanala",
+    "notify-save-changes-error": "Došlo je do pogreške, nije moguće spremiti promjene",
+    "notify-saved-changes": "Spremljene promjene",
+    "notify-update-error": "Došlo je do pogreške, nije moguće ažurirati { entity }",
+    "notify-update-success": "Ažurirano { entity }",
+    "notify-updated-tags-success": "Uspješno ažurirane oznake",
+    "okay": "U redu",
+    "operator-contains": "sadrži",
+    "operator-eq": "jednako",
+    "operator-gt": "veće od",
+    "operator-lt": "manje od",
+    "operator-not-contains": "ne sadrži",
+    "operator-not-eq": "nije jednako",
+    "operator-notContains": "ne sadrži",
+    "operator-regex": "odgovara regexu",
+    "password": "Lozinka",
+    "position": "Pozicija",
+    "price": "Cijena",
+    "price-with-tax": "Cijena s porezom",
+    "private": "Privatno",
+    "public": "Javno",
+    "remember-me": "Zapamti me",
+    "remove": "Ukloni",
+    "remove-from-channel": "Ukloni iz trenutnog kanala",
+    "remove-item-from-list": "Ukloni stavku s popisa",
+    "rename-filter-preset": "Rename preset",
+    "reset-columns": "Ponovno postavi stupce",
+    "results-count": "{ count } {count, plural, one {rezultat} other {rezultata}}",
+    "sample-formatting": "Primjer formatiranja",
+    "save-filter-preset": "Spremi kao prečac",
+    "search-and-filter-list": "Pretraži i filtriraj ovaj popis",
+    "search-by-name": "Pretraži po imenu",
+    "select": "Odaberi...",
+    "select-display-language": "Odaberi jezik prikaza",
+    "select-items-with-count": "Odaberi { count } {count, plural, one {stavku} other {stavki}}",
+    "select-products": "Odaberi proizvode",
+    "select-relation-id": "Odaberi ID odnosa",
+    "select-table-columns": "Odaberi stupce tablice",
+    "select-today": "Odaberi danas",
+    "select-variants": "Odaberi varijante",
+    "seller": "Prodavač",
+    "set-language": "Postavi jezik",
+    "short-date": "Kratki datum",
+    "slug": "Slug",
+    "start-date": "Datum početka",
+    "status": "Status",
+    "tags": "Oznake",
+    "theme": "Tema",
+    "there-are-unsaved-changes": "Imate nespremljenih promjena. Napuštanje će rezultirati gubitkom tih promjena.",
+    "toggle-all": "Uključi/Isključi sve",
+    "total-items": "{currentStart} - {currentEnd} od {totalItems}",
+    "update": "Ažuriraj",
+    "updated-at": "Ažurirano u",
+    "username": "Korisničko ime",
+    "value": "Vrijednost",
+    "view-contents": "Pogledaj sadržaj",
+    "view-next-month": "Pogledaj sljedeći mjesec",
+    "view-previous-month": "Pogledaj prethodni mjesec",
+    "visibility": "Vidljivost",
+    "with-selected": "S odabranima ({count})..."
+  },
+  "customer": {
+    "add-customer-to-group": "Dodaj kupca u grupu",
+    "add-customer-to-groups-with-count": "Dodaj kupca u {count, plural, one {1 grupu} other {{count} grupe}}",
+    "add-customers-to-group": "Dodaj kupce u grupu",
+    "add-customers-to-group-success": "Dodano {customerCount, plural, one {1 kupac} other {{customerCount} kupaca}} u \"{ groupName }\"",
+    "add-customers-to-group-with-count": "Dodaj {count, plural, one {1 kupca} other {{count} kupaca}}",
+    "add-customers-to-group-with-name": "Dodaj kupce u \"{ groupName }\"",
+    "addresses": "Adrese",
+    "city": "Grad",
+    "company": "Tvrtka",
+    "confirm-remove-customer-from-group": "Ukloniti kupca iz grupe?",
+    "country": "Država",
+    "create-customer-group": "Stvori grupu kupaca",
+    "create-new-address": "Stvori novu adresu",
+    "create-new-customer": "Stvori novog kupca",
+    "create-new-customer-group": "Stvori novu grupu kupaca",
+    "customer": "Kupac",
+    "customer-group": "Grupa kupaca",
+    "customer-groups": "Grupe kupaca",
+    "customer-history": "Povijest kupca",
+    "customers": "Kupci",
+    "default-billing-address": "Zadana adresa za naplatu",
+    "default-shipping-address": "Zadana adresa za dostavu",
+    "email-address": "Adresa e-pošte",
+    "email-verification-sent": "Na { emailAddress } poslana je verifikacijska e-pošta",
+    "first-name": "Ime",
+    "full-name": "Puno ime",
+    "guest": "Gost",
+    "history-customer-added-to-group": "Kupac dodan u grupu \"{ groupName }\"",
+    "history-customer-address-created": "Adresa stvorena",
+    "history-customer-address-deleted": "Adresa izbrisana",
+    "history-customer-address-updated": "Adresa ažurirana",
+    "history-customer-detail-updated": "Ažurirani detalji kupca",
+    "history-customer-email-update-requested": "Zahtjev za ažuriranje adrese e-pošte",
+    "history-customer-email-update-verified": "Verifikacija ažurirane adrese e-pošte",
+    "history-customer-password-reset-requested": "Zahtjev za resetiranje lozinke",
+    "history-customer-password-reset-verified": "Verifikacija resetirane lozinke",
+    "history-customer-password-updated": "Ažurirana lozinka",
+    "history-customer-registered": "Kupac registriran",
+    "history-customer-removed-from-group": "Kupac uklonjen iz grupe \"{ groupName }\"",
+    "history-customer-verified": "Kupac verificiran",
+    "history-using-external-auth-strategy": "koristi { strategy }",
+    "history-using-native-auth-strategy": "koristi adresu e-pošte",
+    "last-login": "Posljednja prijava",
+    "last-name": "Prezime",
+    "name": "Ime",
+    "new-email-address": "Nova adresa e-pošte",
+    "no-orders-placed": "Nema postavljenih narudžbi",
+    "not-a-member-of-any-groups": "Ovaj kupac nije član nijedne grupe",
+    "old-email-address": "Stara adresa e-pošte",
+    "orders": "Narudžbe",
+    "password": "Lozinka",
+    "phone-number": "Broj telefona",
+    "postal-code": "Poštanski broj",
+    "province": "Županija",
+    "registered": "Registriran",
+    "remove-customers-from-group-success": "Uklonjeno {customerCount, plural, one {1 kupac} other {{customerCount} kupaca}} iz \"{ groupName }\"",
+    "remove-from-group": "Ukloni iz ove grupe",
+    "search-customers-by-email": "Pretraži po adresi e-pošte",
+    "search-customers-by-email-last-name-postal-code": "Pretraži po adresi e-pošte / prezimenu / poštanskom broju",
+    "select-customer": "Odaberi kupca",
+    "set-as-default-billing-address": "Postavi kao zadanu adresu za naplatu",
+    "set-as-default-shipping-address": "Postavi kao zadanu adresu za dostavu",
+    "street-line-1": "Adresa, redak 1",
+    "street-line-2": "Adresa, redak 2",
+    "title": "Naslov",
+    "update-customer-group": "Ažuriraj grupu kupaca",
+    "verified": "Verificirano",
+    "view-group-members": "Pogledaj članove grupe"
+  },
+  "dashboard": {
+    "add-widget": "Dodaj widget",
+    "latest-orders": "Najnovije narudžbe",
+    "metric-average-order-value": "Prosječna vrijednost narudžbe",
+    "metric-number-of-orders": "Broj narudžbi",
+    "metric-order-total-value": "Ukupna vrijednost narudžbe",
+    "metrics": "Statistika",
+    "orders-summary": "Sažetak narudžbi",
+    "remove-widget": "Ukloni widget",
+    "thisMonth": "Ovaj mjesec",
+    "thisWeek": "Ovaj tjedan",
+    "today": "Danas",
+    "total-order-value": "Ukupna vrijednost",
+    "total-orders": "Ukupno narudžbi",
+    "widget-resize": "Promijeni veličinu",
+    "widget-width": "Širina: {width}",
+    "yesterday": "Jučer"
+  },
+  "datetime": {
+    "ago-days": "{count, plural, one {prije 1 dan} other {prije {count} dana}}",
+    "ago-hours": "{count, plural, one {prije 1 sat} other {prije {count} sati}}",
+    "ago-minutes": "{count, plural, one {prije 1 minutu} other {prije {count} minuta}}",
+    "ago-seconds": "{count, plural, =0 {upravo sada} one {prije 1 sekunde} other {prije {count} sekundi}}",
+    "ago-years": "{count, plural, one {prije 1 godinu} other {prije {count} godina}}",
+    "day": "dan",
+    "duration-milliseconds": "{ms}ms",
+    "duration-minutes:seconds": "{m}:{s}m",
+    "duration-seconds": "{s}s",
+    "month": "mjesec",
+    "month-apr": "Travanj",
+    "month-aug": "Kolovoz",
+    "month-dec": "Prosinac",
+    "month-feb": "Veljača",
+    "month-jan": "Siječanj",
+    "month-jul": "Srpanj",
+    "month-jun": "Lipanj",
+    "month-mar": "Ožujak",
+    "month-may": "Svibanj",
+    "month-nov": "Studeni",
+    "month-oct": "Listopad",
+    "month-sep": "Rujan",
+    "relative-past-days": "Prošao {count, plural, one {1 dan} other {{count} dana}}",
+    "relative-past-months": "Prošao {count, plural, one {1 mjesec} other {{count} mjeseci}}",
+    "relative-past-years": "Prošlo {count, plural, one {1 godina} other {{count} godina}}",
+    "time": "Vrijeme",
+    "weekday-fr": "Pet",
+    "weekday-mo": "Pon",
+    "weekday-sa": "Sub",
+    "weekday-su": "Ned",
+    "weekday-th": "Čet",
+    "weekday-tu": "Uto",
+    "weekday-we": "Sri",
+    "year": "godina"
+  },
+  "editor": {
+    "image-alt": "Opis (alt)",
+    "image-src": "Izvor",
+    "image-title": "Naziv",
+    "insert-image": "Umetni sliku",
+    "link-href": "Link",
+    "link-target": "Target linka",
+    "link-title": "Naziv linka",
+    "remove-link": "Ukloni",
+    "set-link": "Postavi link"
+  },
+  "error": {
+    "403-forbidden": "Trenutno nemate ovlaštenje za pristup \"{ path }\". Ili vam nedostaju ovlasti ili je vaša sesija istekla.",
+    "could-not-connect-to-server": "Nije moguće povezati se s Vendure serverom na { url }",
+    "facet-value-form-values-do-not-match": "Broj vrijednosti u obrascu za aspekte ne podudara se s stvarnim brojem vrijednosti",
+    "health-check-failed": "Provjera zdravlja sustava nije uspjela",
+    "no-default-shipping-zone-set": "Ovaj kanal nema zadaniu zonu dostave. To može uzrokovati pogreške pri izračunavanju troškova dostave narudžbe.",
+    "no-default-tax-zone-set": "Ovaj kanal nema zadaniu poreznu zonu, što će uzrokovati pogreške pri izračunavanju cijena. Molimo kreirajte ili odaberite zonu."
+  },
+  "marketing": {
+    "actions": "Radnje",
+    "add-action": "Dodaj radnju",
+    "add-condition": "Dodaj uvjet",
+    "conditions": "Uvjeti",
+    "coupon-code": "Kod kupona",
+    "create-new-promotion": "Stvori novu promociju",
+    "ends-at": "Završava u",
+    "per-customer-limit": "Limit po kupcu",
+    "per-customer-limit-tooltip": "Maksimalni broj puta koje ovu promociju može koristiti jedan pojedinačni kupac",
+    "promotion": "Promocija",
+    "search-by-name-or-coupon-code": "Pretraži po imenu ili kodu kupona",
+    "starts-at": "Počinje u",
+    "usage-limit": "Ukupno ograničenje upotrebe",
+    "usage-limit-tooltip": "Maksimalni broj puta koje se ovu promociju može koristiti ukupno"
+  },
+  "nav": {
+    "administrators": "Administratori",
+    "assets": "Resursi",
+    "catalog": "Katalog",
+    "channels": "Kanali",
+    "collections": "Kolekcije",
+    "countries": "Države",
+    "customer-groups": "Grupe kupaca",
+    "customers": "Kupci",
+    "facets": "Aspekti",
+    "global-settings": "Globalne postavke",
+    "job-queue": "Red čekanja poslova",
+    "marketing": "Oglašavanje",
+    "orders": "Narudžbe",
+    "payment-methods": "Načini plaćanja",
+    "products": "Proizvodi",
+    "promotions": "Promocije",
+    "roles": "Uloge",
+    "sales": "Prodaja",
+    "sellers": "Prodavači",
+    "settings": "Postavke",
+    "shipping-methods": "Načini dostave",
+    "stock-locations": "Lokacije zaliha",
+    "system": "Sustav",
+    "system-status": "Status sustava",
+    "tax-categories": "Porezne kategorije",
+    "tax-rates": "Porezne stope",
+    "zones": "Zone"
+  },
+  "order": {
+    "add-item-to-order": "Dodaj stavku u narudžbu",
+    "add-note": "Dodaj napomenu",
+    "add-payment": "Dodaj plaćanje",
+    "add-payment-to-order": "Dodaj plaćanje narudžbi",
+    "add-payment-to-order-success": "Uspješno dodano plaćanje narudžbi",
+    "add-surcharge": "Dodaj nadoplatu",
+    "added-items": "Dodane stavke",
+    "amount": "Iznos",
+    "arrange-additional-payment": "Organiziraj dodatno plaćanje",
+    "billing-address": "Adresa za naplatu",
+    "cancel": "Otkaži",
+    "cancel-entire-order": "Otkaži cijelu narudžbu",
+    "cancel-fulfillment": "Otkaži ispunjenje",
+    "cancel-modification": "Otkaži izmjenu",
+    "cancel-order": "Otkaži narudžbu ili stavke",
+    "cancel-payment": "Otkaži plaćanje",
+    "cancel-reason-customer-request": "Zahtjev kupca",
+    "cancel-reason-not-available": "Nedostupno",
+    "cancel-selected-items": "Otkaži odabrane stavke",
+    "cancel-specified-items": "Otkaži određene stavke",
+    "cancellation-reason": "Razlog otkazivanja",
+    "cancelled-order-success": "Narudžba uspješno otkazana",
+    "complete-draft-order": "Završi skicu",
+    "confirm-modifications": "Potvrdi izmjene",
+    "contents": "Sadržaj",
+    "create-fulfillment": "Stvori ispunjenje",
+    "create-fulfillment-success": "Ispunjenje stvoreno",
+    "customer": "Kupac",
+    "delete-draft-order": "Izbriši skicu",
+    "draft-order": "Skica narudžbe",
+    "edit-billing-address": "Uredi adresu za naplatu",
+    "edit-shipping-address": "Uredi adresu za dostavu",
+    "error-message": "Poruka o grešci",
+    "existing-address": "Postojeća adresa",
+    "existing-customer": "Postojeći kupac",
+    "filter-is-active": "Aktivan je",
+    "fulfill": "Ispuni",
+    "fulfill-order": "Ispuni narudžbu",
+    "fulfillment": "Ispunjenje",
+    "fulfillment-method": "Metoda ispunjenja",
+    "history-coupon-code-applied": "Primijenjen kod kupona",
+    "history-coupon-code-removed": "Uklonjen kod kupona",
+    "history-fulfillment-created": "Ispunjenje stvoreno",
+    "history-fulfillment-delivered": "Ispunjenje isporučeno",
+    "history-fulfillment-shipped": "Ispunjenje poslano",
+    "history-fulfillment-transition": "Ispunjenje prešlo iz {from} u {to}",
+    "history-items-cancelled": "{count} {count, plural, one {stavka} other {stavke}} otkazane",
+    "history-order-cancelled": "Narudžba otkazana",
+    "history-order-created": "Narudžba stvorena",
+    "history-order-fulfilled": "Narudžba ispunjena",
+    "history-order-modified": "Narudžba izmijenjena",
+    "history-order-transition": "Narudžba prešla iz {from} u {to}",
+    "history-payment-settled": "Plaćanje riješeno",
+    "history-payment-transition": "Plaćanje #{id} prešlo iz {from} u {to}",
+    "history-refund-transition": "Povrat #{id} prešao iz {from} u {to}",
+    "item-count": "{count} {count, plural, one {stavka} other {stavke}}",
+    "line-fulfillment-all": "Sve stavke su ispunjene",
+    "line-fulfillment-none": "Nijedna stavka nije ispunjena",
+    "line-fulfillment-partial": "{ count } od { total } stavki ispunjeno",
+    "manually-transition-to-state": "Ručno prijeđite u stanje...",
+    "manually-transition-to-state-message": "Ručno prijeđite narudžbu u drugo stanje. Napomena da su stanja narudžbe regulirana pravilima koja mogu spriječiti određene prijelaze.",
+    "modification-adding-items": "Dodavanje {count} {count, plural, one {stavka} other {stavke}}",
+    "modification-adding-surcharges": "Dodavanje {count} {count, plural, one {nadoplata} other {nadoplata}}",
+    "modification-adjusting-lines": "Prilagođavanje {count} {count, plural, one {linija} other {linija}}",
+    "modification-not-settled": "Nije riješeno",
+    "modification-recalculate-shipping": "Ponovno izračunaj dostavu",
+    "modification-settled": "Riješeno",
+    "modification-summary": "Sažetak izmjena",
+    "modification-updating-billing-address": "Ažuriranje adrese za naplatu",
+    "modification-updating-shipping-address": "Ažuriranje adrese za dostavu",
+    "modifications": "Izmjene",
+    "modify-order": "Izmijeni narudžbu",
+    "modify-order-price-difference": "Razlika u cijeni",
+    "net-price": "Neto cijena",
+    "note": "Napomena",
+    "note-is-private": "Napomena je privatna",
+    "note-only-visible-to-administrators": "Vidljivo samo administratorima",
+    "note-visible-to-customer": "Vidljivo administratorima i kupcu",
+    "order": "Narudžba",
+    "order-history": "Povijest narudžbe",
+    "order-is-empty": "Narudžba je prazna",
+    "order-state-diagram": "Dijagram stanja narudžbe",
+    "order-type": "Vrsta narudžbe",
+    "order-type-aggregate": "Agregat",
+    "order-type-regular": "Redovita",
+    "order-type-seller": "Prodavač",
+    "orders": "Narudžbe",
+    "original-quantity-at-checkout": "Izvorna količina pri završetku kupovine",
+    "payment": "Plaćanje",
+    "payment-amount": "Iznos plaćanja",
+    "payment-metadata": "Metapodaci plaćanja",
+    "payment-method": "Metoda plaćanja",
+    "payment-state": "Stanje plaćanja",
+    "payment-to-refund": "Plaćanje za povrat",
+    "payments": "Plaćanja",
+    "placed-at": "Naručeno u",
+    "preview-changes": "Pregled promjena",
+    "product-name": "Naziv proizvoda",
+    "product-sku": "SKU",
+    "promotions-applied": "Primijenjeni promotivni kodovi",
+    "prorated-unit-price": "Proračunska cijena po komadu",
+    "quantity": "Količina",
+    "refund": "Povrat sredstava",
+    "refund-adjustment": "Prilagodba",
+    "refund-and-cancel-order": "Povrat sredstava i otkazivanje narudžbe",
+    "refund-cancellation-reason": "Razlog povrata sredstava/otkazivanja",
+    "refund-cancellation-reason-required": "Razlog povrata sredstava/otkazivanja je obavezan",
+    "refund-metadata": "Metapodaci povrata sredstava",
+    "refund-order-failed": "Povrat narudžbe nije uspio",
+    "refund-order-success": "Uspješno izvršen povrat narudžbe",
+    "refund-reason": "Razlog povrata sredstava",
+    "refund-reason-customer-request": "Zahtjev kupca",
+    "refund-reason-not-available": "Nedostupno",
+    "refund-shipping": "Povrat troškova dostave",
+    "refund-total": "Ukupan iznos povrata",
+    "refund-total-error": "Ukupan iznos povrata mora biti između {min} i {max}",
+    "refund-total-warning": "Ukupan iznos povrata premašuje odabrani iznos plaćanja. Preostali iznos povrata bit će vraćen iz drugih plaćanja.",
+    "refund-with-amount": "Povrat u iznosu od {amount}",
+    "refunded-count": "Povraćeno {count} {count, plural, one {stavka} other {stavki}}",
+    "removed-items": "Uklonjene stavke",
+    "search-by-order-filters": "Pretraga po imenu / kodu / ID transakcije",
+    "select-address": "Odaberi adresu",
+    "select-shipping-method": "Odaberi metodu dostave",
+    "select-state": "Odaberi državu",
+    "seller-orders": "Narudžbe prodavača",
+    "set-billing-address": "Postavi adresu za naplatu",
+    "set-coupon-codes": "Postavi kôdove kupona",
+    "set-customer-for-order": "Postavi kupca",
+    "set-fulfillment-state": "Označi kao {state}",
+    "set-shipping-address": "Postavi adresu za dostavu",
+    "set-shipping-method": "Postavi metodu dostave",
+    "settle-payment": "Izmiri plaćanje",
+    "settle-payment-error": "Plaćanje nije moglo biti izmireno",
+    "settle-payment-success": "Plaćanje je uspješno izmireno",
+    "settle-refund": "Izmiri povrat sredstava",
+    "settle-refund-manual-instructions": "Nakon ručnog povrata putem vašeg pružatelja plaćanja ({method}), unesite ID transakcije ovdje.",
+    "settle-refund-success": "Povrat sredstava je uspješno izmiren",
+    "shipping": "Dostava",
+    "shipping-address": "Adresa dostave",
+    "shipping-cancelled": "Dostava otkazana",
+    "shipping-method": "Metoda dostave",
+    "state": "Stanje",
+    "sub-total": "Prije poreza",
+    "successfully-updated-fulfillment": "Dostava je uspješno ažurirana",
+    "surcharges": "Dodatne naknade",
+    "tax-base": "Osnova za porez",
+    "tax-description": "Opis poreza",
+    "tax-rate": "Porezna stopa",
+    "tax-summary": "Porezni sažetak",
+    "tax-total": "Ukupan porez",
+    "total": "Ukupno",
+    "tracking-code": "Kôd za praćenje",
+    "transaction-id": "ID transakcije",
+    "transition-to-state": "Prijelaz u stanje {state}",
+    "transitioned-payment-to-state-success": "Uspješno izvršen prijelaz plaćanja u stanje {state}",
+    "transitioned-to-state-success": "Uspješno izvršen prijelaz u stanje {state}",
+    "unable-to-transition-to-state-try-another": "Narudžba se nije mogla vratiti u stanje \"{state}\". Molimo odaberite alternativno stanje",
+    "unfulfilled": "Neispunjeno",
+    "unit-price": "Jedinična cijena"
+  },
+  "settings": {
+    "add-countries-to-zone": "Dodaj države u { zoneName }",
+    "add-countries-to-zone-success": "Dodane su { countryCount } {countryCount, plural, one {država} other {države}} u zonu \"{ zoneName }\"",
+    "add-products-to-test-order": "Dodajte proizvode u test narudžbu",
+    "administrator": "Administrator",
+    "channel": "Kanal",
+    "channel-token": "Token kanala",
+    "country": "Država",
+    "create-new-channel": "Kreirajte novi kanal",
+    "create-new-country": "Kreirajte novu državu",
+    "create-new-payment-method": "Kreirajte novu metodu plaćanja",
+    "create-new-role": "Kreirajte novu ulogu",
+    "create-new-seller": "Kreirajte novog prodavača",
+    "create-new-shipping-method": "Kreirajte novu metodu dostave",
+    "create-new-tax-category": "Kreirajte novu kategoriju poreza",
+    "create-new-tax-rate": "Kreirajte novu stopu poreza",
+    "create-new-zone": "Kreirajte novu zonu",
+    "default-currency": "Zadana valuta",
+    "default-role-label": "Ovo je zadana uloga i ne može se mijenjati",
+    "default-shipping-zone": "Zadana zona dostave",
+    "default-tax-zone": "Zadana porezna zona",
+    "defaults": "Zadano",
+    "eligible": "Opravdan",
+    "email-address": "Adresa e-pošte",
+    "email-address-or-identifier": "Adresa e-pošte ili identifikator",
+    "first-name": "Ime",
+    "fulfillment-handler": "Izvršitelj",
+    "global-available-languages-tooltip": "Postavlja jezike koji su dostupni za sve kanale. Individualni kanali mogu podržavati podskup ovih jezika.",
+    "global-out-of-stock-threshold": "Globalni prag isteka zaliha",
+    "global-out-of-stock-threshold-tooltip": "Postavlja razinu zaliha na kojoj se varijanta smatra nedostupnom. Upotreba negativne vrijednosti omogućuje podršku za narudžbe izvan zaliha. Može se zamijeniti varijantama proizvoda.",
+    "last-name": "Prezime",
+    "no-eligible-shipping-methods": "Nema prikladnih metoda dostave",
+    "password": "Lozinka",
+    "payment-eligibility-checker": "Provjeravač opravdanosti plaćanja",
+    "payment-handler": "Rukovatelj plaćanjem",
+    "payment-method": "Metoda plaćanja",
+    "permissions": "Dozvole",
+    "prices-include-tax": "Cijene uključuju porez za zadanu zonu",
+    "profile": "Profil",
+    "rate": "Ocijeni",
+    "remove-countries-from-zone-success": "Uklonjeno { countryCount } {countryCount, plural, one {država} other {država}} iz zone \"{ zoneName }\"",
+    "remove-from-zone": "Uklonite iz zone",
+    "role": "Uloga",
+    "roles": "Uloge",
+    "search-by-product-name-or-sku": "Pretraži po nazivu proizvoda ili SKU",
+    "seller": "Prodavač",
+    "shipping-calculator": "Kalkulator dostave",
+    "shipping-eligibility-checker": "Provjera mogućnosti dostave",
+    "shipping-method": "Metoda dostave",
+    "tax-category": "Kategorija poreza",
+    "tax-rate": "Stopa poreza",
+    "test-address": "Testna adresa",
+    "test-result": "Rezultat testa",
+    "test-shipping-method": "Testna metoda dostave",
+    "test-shipping-methods": "Testne metode dostave",
+    "track-inventory-default": "Pratite zadani inventar",
+    "view-zone-members": "Pregledajte članove",
+    "zone": "Zona"
+  },
+  "state": {
+    "adding-items": "Dodavanje stavki",
+    "arranging-additional-payment": "Organizacija dodatnog plaćanja",
+    "arranging-payment": "Organizacija plaćanja",
+    "authorized": "Odobreno",
+    "cancelled": "Otkazano",
+    "created": "Kreirano",
+    "declined": "Odbijeno",
+    "delivered": "Isporučeno",
+    "draft": "Skica",
+    "error": "Greška",
+    "failed": "Neuspelo",
+    "modifying": "Izmene",
+    "partially-delivered": "Delimično isporučeno",
+    "partially-shipped": "Delimično otpremljeno",
+    "payment-authorized": "Odobreno plaćanje",
+    "payment-settled": "Plaćanje izmireno",
+    "pending": "U tijeku",
+    "settled": "Izmireno",
+    "shipped": "Otpremljeno"
+  },
+  "system": {
+    "all-job-queues": "Sve redove zadataka",
+    "health-all-systems-up": "Svi sistemi su dostupni",
+    "health-error": "Greška: jedan ili više sistema je nedostupno!",
+    "health-last-checked": "Poslednja provera",
+    "health-message": "Poruka",
+    "health-refresh": "Osvježi",
+    "health-status": "Status",
+    "health-status-down": "Nedostupno",
+    "health-status-up": "Dostupno",
+    "job-data": "Podaci o zadatku",
+    "job-duration": "Trajanje",
+    "job-error": "Greška zadatka",
+    "job-queue-name": "Ime reda zadatka",
+    "job-result": "Rezultat zadatka",
+    "job-state": "Stanje zadatka",
+    "job-state-all": "Svi statusi",
+    "job-state-cancelled": "Otkazano",
+    "job-state-completed": "Završeno",
+    "job-state-failed": "Neuspjelo",
+    "job-state-pending": "Na čekanju",
+    "job-state-running": "U tijeku"
+  }
+}
\ No newline at end of file

From 3fd93c77f8476b1c672032dfb265eca4408a5e3f Mon Sep 17 00:00:00 2001
From: Alessio Marano <46132382+Swampy469@users.noreply.github.com>
Date: Thu, 12 Oct 2023 14:35:07 +0200
Subject: [PATCH 06/49] fix(admin-ui): Improve Italian translations (#2445)

Co-authored-by: Alessio Marano <alessio.marano@sardexpay.net>
---
 .../src/lib/static/i18n-messages/it.json      | 64 +++++++++----------
 1 file changed, 32 insertions(+), 32 deletions(-)

diff --git a/packages/admin-ui/src/lib/static/i18n-messages/it.json b/packages/admin-ui/src/lib/static/i18n-messages/it.json
index 7608f60e5e..46e3fc4f0d 100644
--- a/packages/admin-ui/src/lib/static/i18n-messages/it.json
+++ b/packages/admin-ui/src/lib/static/i18n-messages/it.json
@@ -45,10 +45,10 @@
     "profile": "Profilo",
     "promotions": "Promozioni",
     "roles": "Ruoli",
-    "seller-orders": "Ordini venditore",
-    "sellers": "Venditore",
+    "seller-orders": "Ordini venditori",
+    "sellers": "Venditori",
     "shipping-methods": "Metodi di spedizione",
-    "stock-locations": "Posizioni magazzino",
+    "stock-locations": "Posizioni scorte",
     "system-status": "Stato del sistema",
     "tax-categories": "Impostazioni Tasse",
     "tax-rates": "Importo Tasse",
@@ -59,7 +59,7 @@
     "add-facets": "Aggiungi attributi",
     "add-option": "Aggiungi opzione",
     "add-price-in-another-currency": "Aggiungi un prezzo in un'altra valuta",
-    "add-stock-location": "Aggiungi posizione magazzino",
+    "add-stock-location": "Aggiungi posizione scorte",
     "add-stock-to-location": "ggiungi merce alla posizione",
     "asset": "Media",
     "asset-preview-links": "Media preview link",
@@ -92,8 +92,8 @@
     "create-new-collection": "Crea nuova Collezione",
     "create-new-facet": "Crea nuovo attributo",
     "create-new-product": "Crea nuovo prodotto",
-    "create-new-stock-location": "Creare una nuova posizione di magazzino",
-    "create-product-option-group": "Crea gruppo di opzione di prodotto",
+    "create-new-stock-location": "Creare una nuova posizione delle scorte ",
+    "create-product-option-group": "Crea gruppo di opzione del prodotto",
     "create-product-variant": "Crea variante prodotto",
     "default-currency": "Valuta predefinita",
     "do-not-inherit-filters": "Non ereditare i filtri",
@@ -121,7 +121,7 @@
     "no-channel-selected": "Nessun canale selezionato",
     "no-featured-asset": "Nessun media in evidenza",
     "no-selection": "Nessuna selezione",
-    "no-stock-locations-available-on-current-channel": "Non sono disponibili posizioni di magazzino nel canale corrente. Impostare almeno una posizione di magazzino prima di aggiungere prodotti.",
+    "no-stock-locations-available-on-current-channel": "Non sono disponibili posizioni delle scorte nel canale corrente. Impostare almeno una posizione delle scorte prima di aggiungere prodotti.",
     "notify-bulk-delete-products-success": "Rimossi con successo {count, plural, one {1 prodotto} other {{count} prodotti}}",
     "notify-remove-facets-from-channel-success": "Rimossi con successo {count, plural, one {1 attributo} other {{count} attributi}} da { channelCode }",
     "notify-remove-product-from-channel-error": "Impossibile rimuovere il prodotto dal canale",
@@ -159,7 +159,7 @@
     "remove-product-from-channel": "Rimuovi prodotto dal canale",
     "remove-product-variant-from-channel": "Rimuovi variante dal canale",
     "reorder-collection": "Riordina collezione",
-    "root-collection": "",
+    "root-collection": "Collezione base",
     "run-pending-search-index-updates": "Indice di ricerca: eseguire {count, plural, one {1 aggiornamento in attesa} other {{count} aggiornamenti in attesa}}",
     "running-search-index-updates": "Esecuzione {count, plural, one {1 aggiornamento} other {{count} aggiornamenti}} all'indice di ricerca",
     "search-asset-name-or-tag": "Cerca per nome o tag del media",
@@ -171,7 +171,7 @@
     "slug": "Slug",
     "slug-pattern-error": "Lo slug non è valido",
     "stock-allocated": "Allocato",
-    "stock-levels": "Livelli di scorte",
+    "stock-levels": "Livello delle scorte",
     "stock-location": "Posizione delle scorte",
     "stock-locations": "Posizioni delle scorte",
     "stock-on-hand": "Scorte",
@@ -203,7 +203,7 @@
     "boolean-false": "falso",
     "boolean-or": "o",
     "boolean-true": "vero",
-    "breadcrumb": "Breadcrump",
+    "breadcrumb": "Breadcrumb",
     "browser-default": "Predefinito del browser",
     "cancel": "Annulla",
     "cancel-navigation": "Annulla navigazione",
@@ -221,7 +221,7 @@
     "confirm-navigation": "Prosegui con la navigazione",
     "contents": "Contenuti",
     "create": "Crea",
-    "created-at": "Creato il",
+    "created-at": "Creata il",
     "custom-fields": "Campi personalizzati",
     "data-table-filter-date-mode": "Modalità data",
     "data-table-filter-date-range": "Intervallo date",
@@ -331,7 +331,7 @@
     "toggle-all": "Cambia tutti",
     "total-items": "{currentStart} - {currentEnd} di {totalItems}",
     "update": "Aggiorna",
-    "updated-at": "Aggiornare a",
+    "updated-at": "Aggiornata il",
     "username": "Username",
     "value": "Valore",
     "view-contents": "Mostra contenuti",
@@ -521,7 +521,7 @@
     "sellers": "Venditori",
     "settings": "Impostazioni",
     "shipping-methods": "Metodi di Spedizione",
-    "stock-locations": "Posizioni magazzino",
+    "stock-locations": "Posizioni scorte",
     "system": "Sistema",
     "system-status": "Stato del Sistema",
     "tax-categories": "Impostazioni Tasse",
@@ -581,7 +581,7 @@
     "history-order-fulfilled": "Ordine spedito",
     "history-order-modified": "Ordine modificato",
     "history-order-transition": "Ordine passato da {from} a {to}",
-    "history-payment-settled": "Pagamento incassato",
+    "history-payment-settled": "Pagamento ricevuto",
     "history-payment-transition": "Pagamento #{id} passato da {from} a {to}",
     "history-refund-transition": "Rimborso #{id} passato da {from} a {to}",
     "item-count": "{count} {count, plural, one {prodotto} other {prodotti}}",
@@ -593,12 +593,12 @@
     "modification-adding-items": "Aggiungo {count} {count, plural, one {prodotto} other {prodotti}}",
     "modification-adding-surcharges": "Aggiungo {count} {count, plural, one {sovrapprezzo} other {sovrapprezzi}}",
     "modification-adjusting-lines": "Modifico {count} {count, plural, one {linea} other {linee}} dell'ordine",
-    "modification-not-settled": "Non incassato",
+    "modification-not-settled": "Non ricevuto",
     "modification-recalculate-shipping": "Ricalcola spedizione",
-    "modification-settled": "Incassato",
+    "modification-settled": "Ricevuto",
     "modification-summary": "Riepilogo delle modifiche",
-    "modification-updating-billing-address": "Aggiorno indirizzo di fatturazione",
-    "modification-updating-shipping-address": "Aggiorno indirizzo di spedizione",
+    "modification-updating-billing-address": "Aggiornando l'indirizzo di fatturazione",
+    "modification-updating-shipping-address": "Aggiornando l'indirizzo di spedizione",
     "modifications": "Modifiche",
     "modify-order": "Modifica ordine",
     "modify-order-price-difference": "Differenza di prezzo",
@@ -692,7 +692,7 @@
   "settings": {
     "add-countries-to-zone": "Aggiungi nazioni a { zoneName }",
     "add-countries-to-zone-success": "Ho aggiunto { countryCount } {countryCount, plural, one {nazione} other {nazioni}} alla zona \"{ zoneName }\"",
-    "add-products-to-test-order": "Aggiunti prodotti all'ordine di test",
+    "add-products-to-test-order": "Aggiunti prodotti all'ordine di prova",
     "administrator": "Amministratore",
     "channel": "Canale",
     "channel-token": "Token del canale",
@@ -722,8 +722,8 @@
     "last-name": "Cognome",
     "no-eligible-shipping-methods": "Nessun metodo di spedizione compatibile",
     "password": "Password",
-    "payment-eligibility-checker": "Metodo di verifica compatibilità pagamento",
-    "payment-handler": "Funzione gestione pagamento",
+    "payment-eligibility-checker": "Criterio di idoneità metodo di pagamento",
+    "payment-handler": "Gestore Pagamento",
     "payment-method": "Metodo di pagamento",
     "permissions": "Permessi",
     "prices-include-tax": "I prezzi includono le tasse per la zona fiscale predefinita",
@@ -733,24 +733,24 @@
     "remove-from-zone": "Rimuovi dalla zona",
     "role": "Ruolo",
     "roles": "Ruoli",
-    "search-by-product-name-or-sku": "Cerca per prodotto o codice SKU",
+    "search-by-product-name-or-sku": "Cerca per nome prodotto o codice SKU",
     "seller": "Venditore",
-    "shipping-calculator": "Calcolo prezzo spedizioni",
-    "shipping-eligibility-checker": "Criterio di selezione metodi di spedizione",
+    "shipping-calculator": "Calcolo prezzo spedizione",
+    "shipping-eligibility-checker": "Criterio di idoneità metodo di spedizione",
     "shipping-method": "Metodo di spedizione",
     "tax-category": "Categoria tasse",
     "tax-rate": "Tasso fiscale",
-    "test-address": "Indirizzo di test",
-    "test-result": "Risultato test",
-    "test-shipping-method": "Testa metodo di spedizione",
-    "test-shipping-methods": "Testa metodi di spedizione",
+    "test-address": "Indirizzo di prova",
+    "test-result": "Risultato prova",
+    "test-shipping-method": "Prova metodo di spedizione",
+    "test-shipping-methods": "Prova metodi di spedizione",
     "track-inventory-default": "Monitora inventario automaticamente",
     "view-zone-members": "Vedi membri",
     "zone": "Zona"
   },
   "state": {
     "adding-items": "Aggiunta prodotti",
-    "arranging-additional-payment": "Scelta pagamento ulteriore",
+    "arranging-additional-payment": "Scelta ulteriore pagamento ",
     "arranging-payment": "Scelta pagamento",
     "authorized": "Autorizzato",
     "cancelled": "Cancellato",
@@ -770,8 +770,8 @@
     "shipped": "Spedito"
   },
   "system": {
-    "all-job-queues": "Tutte le code di operazioni",
-    "health-all-systems-up": "Tutto il sistema è attivo",
+    "all-job-queues": "Tutte le operazioni",
+    "health-all-systems-up": "I sistemi sono attivi",
     "health-error": "Errore: uno o più sistemi sono inattivi!",
     "health-last-checked": "Ultimo controllo",
     "health-message": "Messaggio",
@@ -792,4 +792,4 @@
     "job-state-pending": "In attesa",
     "job-state-running": "In esecuzione"
   }
-}
\ No newline at end of file
+}

From 8db459a84338331d829a4750ebc14351574bf5fe Mon Sep 17 00:00:00 2001
From: Martijn <martijnvdbrug@users.noreply.github.com>
Date: Thu, 12 Oct 2023 14:37:16 +0200
Subject: [PATCH 07/49] fix(payments-plugin): Fix Mollie klarna AutoCapture
 (#2446)

---
 packages/payments-plugin/e2e/mollie-payment.e2e-spec.ts | 7 ++++---
 packages/payments-plugin/src/mollie/mollie.service.ts   | 3 ++-
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/packages/payments-plugin/e2e/mollie-payment.e2e-spec.ts b/packages/payments-plugin/e2e/mollie-payment.e2e-spec.ts
index 0cab90543a..87c6bced31 100644
--- a/packages/payments-plugin/e2e/mollie-payment.e2e-spec.ts
+++ b/packages/payments-plugin/e2e/mollie-payment.e2e-spec.ts
@@ -381,8 +381,7 @@ describe('Mollie payments (with useDynamicRedirectUrl set to true)', () => {
                 body: JSON.stringify({ id: mockData.mollieOrderResponse.id }),
                 headers: { 'Content-Type': 'application/json' },
             });
-            // tslint:disable-next-line:no-non-null-assertion
-            const { order: adminOrder } = await adminClient.query(GET_ORDER_PAYMENTS, { id: order!.id });
+            const { order: adminOrder } = await adminClient.query(GET_ORDER_PAYMENTS, { id: order?.id });
             expect(adminOrder.state).toBe('ArrangingPayment');
         });
 
@@ -457,7 +456,7 @@ describe('Mollie payments (with useDynamicRedirectUrl set to true)', () => {
                 adminClient,
                 order.lines[0].id,
                 10,
-                // tslint:disable-next-line:no-non-null-assertion
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
                 order.payments!.find(p => p.amount === 108990)!.id,
                 SURCHARGE_AMOUNT,
             );
@@ -468,6 +467,8 @@ describe('Mollie payments (with useDynamicRedirectUrl set to true)', () => {
     });
 
     describe('Handle pay-later methods', () => {
+        // TODO: Add testcases that mock incoming webhook to: 1. Authorize payment and 2. AutoCapture payments
+
         it('Should prepare a new order', async () => {
             await shopClient.asUserWithCredentials(customers[0].emailAddress, 'test');
             const { addItemToOrder } = await shopClient.query<
diff --git a/packages/payments-plugin/src/mollie/mollie.service.ts b/packages/payments-plugin/src/mollie/mollie.service.ts
index e48b7e2051..27e1f90498 100644
--- a/packages/payments-plugin/src/mollie/mollie.service.ts
+++ b/packages/payments-plugin/src/mollie/mollie.service.ts
@@ -308,6 +308,7 @@ export class MollieService {
      * Settle an existing payment based on the given mollieOrder
      */
     async settleExistingPayment(ctx: RequestContext, order: Order, mollieOrderId: string): Promise<void> {
+        order = await this.entityHydrator.hydrate(ctx, order, { relations: ['payments'] });
         const payment = order.payments.find(p => p.transactionId === mollieOrderId);
         if (!payment) {
             throw Error(
@@ -335,7 +336,7 @@ export class MollieService {
         }
         const client = createMollieClient({ apiKey });
         // We use the orders API, so list available methods for that API usage
-        const methods = await client.methods.list({resource: 'orders'});
+        const methods = await client.methods.list({ resource: 'orders' });
         return methods.map(m => ({
             ...m,
             code: m.id,

From 3942690b8ebf80fdefa7a7d5c9f6208cdaeeb730 Mon Sep 17 00:00:00 2001
From: "(void *)0x0" <55084653+BijanRegmi@users.noreply.github.com>
Date: Mon, 16 Oct 2023 13:14:05 +0545
Subject: [PATCH 08/49] docs: Fix yarn add command (#2448)

---
 .../docs/guides/extending-the-admin-ui/getting-started/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/docs/guides/extending-the-admin-ui/getting-started/index.md b/docs/docs/guides/extending-the-admin-ui/getting-started/index.md
index ee58610e14..6974a33fa2 100644
--- a/docs/docs/guides/extending-the-admin-ui/getting-started/index.md
+++ b/docs/docs/guides/extending-the-admin-ui/getting-started/index.md
@@ -31,7 +31,7 @@ npm install --save-dev @vendure/ui-devkit
 <TabItem value="yarn" label="yarn">
 
 ```bash
-yarn add --save-dev @vendure/ui-devkit
+yarn add --dev @vendure/ui-devkit
 ```
 
 </TabItem>

From 09dd7df5e345d90b5bf7d171eabcbb103bc07543 Mon Sep 17 00:00:00 2001
From: armitjs <tianyingchun@outlook.com>
Date: Tue, 17 Oct 2023 07:27:15 -0500
Subject: [PATCH 09/49] fix(core): Fix custom field resolver for eager
 translatable relation (#2457)

Fixes #2453
---
 .../api/common/custom-field-relation-resolver.service.ts  | 8 ++++++++
 packages/core/src/api/config/generate-resolvers.ts        | 8 +++++---
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/packages/core/src/api/common/custom-field-relation-resolver.service.ts b/packages/core/src/api/common/custom-field-relation-resolver.service.ts
index 27ebba13ec..c008731fb6 100644
--- a/packages/core/src/api/common/custom-field-relation-resolver.service.ts
+++ b/packages/core/src/api/common/custom-field-relation-resolver.service.ts
@@ -55,6 +55,14 @@ export class CustomFieldRelationResolverService {
 
         const result = fieldDef.list ? await qb.getMany() : await qb.getOne();
 
+        return await this.translateEntity(ctx, result, fieldDef);
+    }
+
+    async translateEntity(
+        ctx: RequestContext,
+        result: VendureEntity | VendureEntity[] | null,
+        fieldDef: RelationCustomFieldConfig,
+    ) {
         if (fieldDef.entity === ProductVariant) {
             if (Array.isArray(result)) {
                 await Promise.all(result.map(r => this.applyVariantPrices(ctx, r as any)));
diff --git a/packages/core/src/api/config/generate-resolvers.ts b/packages/core/src/api/config/generate-resolvers.ts
index 065c747294..bfde3f677c 100644
--- a/packages/core/src/api/config/generate-resolvers.ts
+++ b/packages/core/src/api/config/generate-resolvers.ts
@@ -207,10 +207,12 @@ function generateCustomFieldRelationResolvers(
                 args: any,
                 context: any,
             ) => {
-                if (source[fieldDef.name] != null) {
-                    return source[fieldDef.name];
-                }
                 const ctx: RequestContext = context.req[REQUEST_CONTEXT_KEY];
+                const eagerEntity = source[fieldDef.name];
+                // If the relation is eager-loaded, we can simply try to translate this relation entity if they have translations
+                if (eagerEntity != null) {
+                    return customFieldRelationResolverService.translateEntity(ctx, eagerEntity, fieldDef);
+                }
                 const entityId = source[ENTITY_ID_KEY];
                 return customFieldRelationResolverService.resolveRelation({
                     ctx,

From 83c8a33226e7ad9826fa8619ca24d2911353177d Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Tue, 17 Oct 2023 14:29:01 +0200
Subject: [PATCH 10/49] test(core): Add e2e test for #2453

---
 .../e2e/custom-field-relations.e2e-spec.ts    |  50 +++++-
 .../test-plugins/issue-2453/api/index.ts      |  21 +++
 .../entities/campaign-translation.entity.ts   |  27 +++
 .../issue-2453/entities/campaign.entity.ts    |  33 ++++
 .../custom-fields-collection.entity.ts        |  51 ++++++
 .../issue-2453/plugin-issue2453.ts            |  30 ++++
 .../issue-2453/services/campaign.service.ts   | 161 ++++++++++++++++++
 .../default-campaigns/default-campaigns.ts    |  23 +++
 .../services/default-campaigns/index.ts       |   3 +
 9 files changed, 398 insertions(+), 1 deletion(-)
 create mode 100644 packages/core/e2e/fixtures/test-plugins/issue-2453/api/index.ts
 create mode 100644 packages/core/e2e/fixtures/test-plugins/issue-2453/entities/campaign-translation.entity.ts
 create mode 100644 packages/core/e2e/fixtures/test-plugins/issue-2453/entities/campaign.entity.ts
 create mode 100644 packages/core/e2e/fixtures/test-plugins/issue-2453/entities/custom-fields-collection.entity.ts
 create mode 100644 packages/core/e2e/fixtures/test-plugins/issue-2453/plugin-issue2453.ts
 create mode 100644 packages/core/e2e/fixtures/test-plugins/issue-2453/services/campaign.service.ts
 create mode 100644 packages/core/e2e/fixtures/test-plugins/issue-2453/services/default-campaigns/default-campaigns.ts
 create mode 100644 packages/core/e2e/fixtures/test-plugins/issue-2453/services/default-campaigns/index.ts

diff --git a/packages/core/e2e/custom-field-relations.e2e-spec.ts b/packages/core/e2e/custom-field-relations.e2e-spec.ts
index c92b8ca3e6..8057315516 100644
--- a/packages/core/e2e/custom-field-relations.e2e-spec.ts
+++ b/packages/core/e2e/custom-field-relations.e2e-spec.ts
@@ -34,6 +34,7 @@ import { testConfig, TEST_SETUP_TIMEOUT_MS } from '../../../e2e-common/test-conf
 
 import { testSuccessfulPaymentMethod } from './fixtures/test-payment-methods';
 import { TestPlugin1636_1664 } from './fixtures/test-plugins/issue-1636-1664/issue-1636-1664-plugin';
+import { PluginIssue2453 } from './fixtures/test-plugins/issue-2453/plugin-issue2453';
 import { TestCustomEntity, WithCustomEntity } from './fixtures/test-plugins/with-custom-entity';
 import { AddItemToOrderMutationVariables } from './graphql/generated-e2e-shop-types';
 import { ADD_ITEM_TO_ORDER } from './graphql/shop-definitions';
@@ -115,7 +116,7 @@ const customConfig = mergeConfig(testConfig(), {
         timezone: 'Z',
     },
     customFields: customFieldConfig,
-    plugins: [TestPlugin1636_1664, WithCustomEntity],
+    plugins: [TestPlugin1636_1664, WithCustomEntity, PluginIssue2453],
 });
 
 describe('Custom field relations', () => {
@@ -286,6 +287,53 @@ describe('Custom field relations', () => {
             assertTranslatableCustomFieldValues(product);
         });
 
+        // https://github.com/vendure-ecommerce/vendure/issues/2453
+        it('translatable eager-loaded relation works (issue 2453)', async () => {
+            const { collections } = await adminClient.query(gql`
+                query {
+                    collections(options: { sort: { name: DESC } }) {
+                        items {
+                            id
+                            name
+                            customFields {
+                                campaign {
+                                    name
+                                    languageCode
+                                }
+                            }
+                        }
+                    }
+                }
+            `);
+
+            expect(collections.items).toEqual([
+                {
+                    customFields: {
+                        campaign: null,
+                    },
+                    id: 'T_2',
+                    name: 'parent collection',
+                },
+                {
+                    customFields: {
+                        campaign: {
+                            languageCode: 'en',
+                            name: 'Clearance Up to 70% Off frames',
+                        },
+                    },
+                    id: 'T_3',
+                    name: 'children collection',
+                },
+                {
+                    customFields: {
+                        campaign: null,
+                    },
+                    id: 'T_4',
+                    name: 'Plants',
+                },
+            ]);
+        });
+
         it('ProductVariant prices get resolved', async () => {
             const { product } = await adminClient.query(gql`
                 query {
diff --git a/packages/core/e2e/fixtures/test-plugins/issue-2453/api/index.ts b/packages/core/e2e/fixtures/test-plugins/issue-2453/api/index.ts
new file mode 100644
index 0000000000..f01f20e29a
--- /dev/null
+++ b/packages/core/e2e/fixtures/test-plugins/issue-2453/api/index.ts
@@ -0,0 +1,21 @@
+import { gql } from 'graphql-tag';
+
+export const apiExtensions = gql`
+    type Campaign implements Node {
+        id: ID!
+        createdAt: DateTime!
+        updatedAt: DateTime!
+        name: String
+        code: String!
+        promotion: Promotion
+        promotionId: ID
+        languageCode: LanguageCode!
+        translations: [CampaignTranslation!]!
+    }
+
+    type CampaignTranslation implements Node {
+        id: ID!
+        languageCode: LanguageCode!
+        name: String!
+    }
+`;
diff --git a/packages/core/e2e/fixtures/test-plugins/issue-2453/entities/campaign-translation.entity.ts b/packages/core/e2e/fixtures/test-plugins/issue-2453/entities/campaign-translation.entity.ts
new file mode 100644
index 0000000000..eafbdc8104
--- /dev/null
+++ b/packages/core/e2e/fixtures/test-plugins/issue-2453/entities/campaign-translation.entity.ts
@@ -0,0 +1,27 @@
+import type { Translation } from '@vendure/core';
+import { DeepPartial, LanguageCode, VendureEntity } from '@vendure/core';
+import { Column, Entity, Relation, ManyToOne } from 'typeorm';
+
+import { Campaign } from './campaign.entity';
+
+/**
+ * @description This entity represents a front end campaign
+ *
+ * @docsCategory entities
+ */
+@Entity('campaign_translation')
+export class CampaignTranslation extends VendureEntity implements Translation<Campaign> {
+    constructor(input?: DeepPartial<Translation<Campaign>>) {
+        super(input);
+    }
+    @Column('varchar')
+    languageCode: LanguageCode;
+
+    @Column('varchar')
+    name: string;
+
+    @ManyToOne(() => Campaign, base => base.translations, {
+        onDelete: 'CASCADE',
+    })
+    base: Relation<Campaign>;
+}
diff --git a/packages/core/e2e/fixtures/test-plugins/issue-2453/entities/campaign.entity.ts b/packages/core/e2e/fixtures/test-plugins/issue-2453/entities/campaign.entity.ts
new file mode 100644
index 0000000000..deaf263c17
--- /dev/null
+++ b/packages/core/e2e/fixtures/test-plugins/issue-2453/entities/campaign.entity.ts
@@ -0,0 +1,33 @@
+import type { ID, LocaleString, Translation } from '@vendure/core';
+import { DeepPartial, Promotion, VendureEntity } from '@vendure/core';
+import { Column, Entity, ManyToOne, OneToMany } from 'typeorm';
+
+import { CampaignTranslation } from './campaign-translation.entity';
+
+/**
+ * @description This entity represents a front end campaign
+ *
+ * @docsCategory entities
+ */
+@Entity('campaign')
+export class Campaign extends VendureEntity {
+    constructor(input?: DeepPartial<Campaign>) {
+        super(input);
+    }
+
+    @Column({ unique: true })
+    code: string;
+
+    name: LocaleString;
+
+    @ManyToOne(() => Promotion, { onDelete: 'SET NULL' })
+    promotion: Promotion | null;
+
+    @Column('int', { nullable: true })
+    promotionId: ID | null;
+
+    @OneToMany(() => CampaignTranslation, translation => translation.base, {
+        eager: true,
+    })
+    translations: Array<Translation<Campaign>>;
+}
diff --git a/packages/core/e2e/fixtures/test-plugins/issue-2453/entities/custom-fields-collection.entity.ts b/packages/core/e2e/fixtures/test-plugins/issue-2453/entities/custom-fields-collection.entity.ts
new file mode 100644
index 0000000000..9fb9a86400
--- /dev/null
+++ b/packages/core/e2e/fixtures/test-plugins/issue-2453/entities/custom-fields-collection.entity.ts
@@ -0,0 +1,51 @@
+import type { CustomFieldConfig } from '@vendure/core';
+import { LanguageCode } from '@vendure/core';
+
+import { Campaign } from './campaign.entity.js';
+
+/**
+ * `Collection` basic custom fields for `campaign`
+ */
+export const collectionCustomFields: CustomFieldConfig[] = [
+    {
+        type: 'relation',
+        name: 'campaign',
+        nullable: true,
+        entity: Campaign,
+        eager: true,
+        // 当shop-api必须定义schema `Campaign` type,申明, 因为public=true
+        public: true,
+        graphQLType: 'Campaign',
+        label: [
+            {
+                languageCode: LanguageCode.en,
+                value: 'Campaign',
+            },
+        ],
+        description: [
+            {
+                languageCode: LanguageCode.en,
+                value: 'Campaign of this collection page',
+            },
+        ],
+    },
+    {
+        name: 'invisible',
+        type: 'boolean',
+        public: true,
+        nullable: true,
+        defaultValue: false,
+        label: [
+            {
+                languageCode: LanguageCode.en,
+                value: 'Invisible',
+            },
+        ],
+        description: [
+            {
+                languageCode: LanguageCode.en,
+                value: 'This flag indicates if current collection is visible or inVisible, against `public`',
+            },
+        ],
+    },
+];
diff --git a/packages/core/e2e/fixtures/test-plugins/issue-2453/plugin-issue2453.ts b/packages/core/e2e/fixtures/test-plugins/issue-2453/plugin-issue2453.ts
new file mode 100644
index 0000000000..7edca04861
--- /dev/null
+++ b/packages/core/e2e/fixtures/test-plugins/issue-2453/plugin-issue2453.ts
@@ -0,0 +1,30 @@
+import { PluginCommonModule, VendurePlugin } from '@vendure/core';
+
+import { apiExtensions } from './api/index';
+import { CampaignTranslation } from './entities/campaign-translation.entity';
+import { Campaign } from './entities/campaign.entity';
+import { collectionCustomFields } from './entities/custom-fields-collection.entity';
+import { CampaignService } from './services/campaign.service';
+
+@VendurePlugin({
+    imports: [PluginCommonModule],
+    entities: [Campaign, CampaignTranslation],
+    adminApiExtensions: {
+        schema: apiExtensions,
+    },
+    shopApiExtensions: {
+        schema: apiExtensions,
+    },
+    compatibility: '>=2.0.0',
+    providers: [CampaignService],
+    configuration: config => {
+        config.customFields.Collection.push(...collectionCustomFields);
+        return config;
+    },
+})
+export class PluginIssue2453 {
+    constructor(private campaignService: CampaignService) {}
+    async onApplicationBootstrap() {
+        await this.campaignService.initCampaigns();
+    }
+}
diff --git a/packages/core/e2e/fixtures/test-plugins/issue-2453/services/campaign.service.ts b/packages/core/e2e/fixtures/test-plugins/issue-2453/services/campaign.service.ts
new file mode 100644
index 0000000000..bba6ab1b20
--- /dev/null
+++ b/packages/core/e2e/fixtures/test-plugins/issue-2453/services/campaign.service.ts
@@ -0,0 +1,161 @@
+import { Injectable } from '@nestjs/common';
+import { DeletionResponse, DeletionResult } from '@vendure/common/lib/generated-types';
+import type { ID, ListQueryOptions, PaginatedList, Translated } from '@vendure/core';
+import {
+    assertFound,
+    CollectionService,
+    LanguageCode,
+    ListQueryBuilder,
+    RequestContext,
+    TransactionalConnection,
+    TranslatableSaver,
+    translateDeep,
+} from '@vendure/core';
+import { In } from 'typeorm';
+
+import { CampaignTranslation } from '../entities/campaign-translation.entity';
+import { Campaign } from '../entities/campaign.entity';
+
+import { defaultCampaignData } from './default-campaigns/index';
+
+@Injectable()
+export class CampaignService {
+    constructor(
+        private readonly connection: TransactionalConnection,
+        private readonly listQueryBuilder: ListQueryBuilder,
+        private readonly collectionService: CollectionService,
+        private readonly translatableSaver: TranslatableSaver,
+    ) {}
+
+    async initCampaigns() {
+        const item = await this.makeSureDefaultCampaigns();
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        await this.makeSureDefaultCollections(item!);
+    }
+
+    findAll(
+        ctx: RequestContext,
+        options?: ListQueryOptions<Campaign>,
+    ): Promise<PaginatedList<Translated<Campaign>>> {
+        return this.listQueryBuilder
+            .build(Campaign, options, { relations: ['promotion'], ctx })
+            .getManyAndCount()
+            .then(([campaignItems, totalItems]) => {
+                const items = campaignItems.map(campaignItem =>
+                    translateDeep(campaignItem, ctx.languageCode, ['promotion']),
+                );
+                return {
+                    items,
+                    totalItems,
+                };
+            });
+    }
+
+    findOne(ctx: RequestContext, id: ID): Promise<Translated<Campaign> | undefined | null> {
+        return this.connection
+            .getRepository(ctx, Campaign)
+            .findOne({ where: { id }, relations: ['promotion'] })
+            .then(campaignItem => {
+                return campaignItem && translateDeep(campaignItem, ctx.languageCode, ['promotion']);
+            });
+    }
+
+    findOneByCode(ctx: RequestContext, code: string): Promise<Translated<Campaign> | undefined | null> {
+        return this.connection
+            .getRepository(ctx, Campaign)
+            .findOne({ where: { code }, relations: ['promotion'] })
+            .then(campaignItem => {
+                return campaignItem && translateDeep(campaignItem, ctx.languageCode, ['promotion']);
+            });
+    }
+
+    async create(ctx: RequestContext, input: any): Promise<Translated<Campaign>> {
+        const campaignItem = await this.translatableSaver.create({
+            ctx,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            input,
+            entityType: Campaign,
+            translationType: CampaignTranslation,
+        });
+        return assertFound(this.findOne(ctx, campaignItem.id));
+    }
+
+    async update(ctx: RequestContext, input: any): Promise<Translated<Campaign>> {
+        const campaignItem = await this.translatableSaver.update({
+            ctx,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            input,
+            entityType: Campaign,
+            translationType: CampaignTranslation,
+        });
+        return assertFound(this.findOne(ctx, campaignItem.id));
+    }
+
+    async delete(ctx: RequestContext, ids: ID[]): Promise<DeletionResponse> {
+        const items = await this.connection.getRepository(ctx, Campaign).find({
+            where: {
+                id: In(ids),
+            },
+        });
+        await this.connection.getRepository(ctx, Campaign).delete(items.map(s => String(s.id)));
+
+        return {
+            result: DeletionResult.DELETED,
+            message: '',
+        };
+    }
+
+    private async makeSureDefaultCampaigns() {
+        const ctx = RequestContext.empty();
+        const { items } = await this.findAll(ctx);
+        let item;
+        for (const campaignItem of defaultCampaignData()) {
+            const hasOne = items.find(s => s.code === campaignItem.code);
+            if (!hasOne) {
+                item = await this.create(ctx, campaignItem);
+            } else {
+                item = await this.update(ctx, {
+                    ...campaignItem,
+                    id: hasOne.id,
+                });
+            }
+        }
+        return item;
+    }
+
+    private async makeSureDefaultCollections(campaign: Translated<Campaign>) {
+        const ctx = RequestContext.empty();
+        const { totalItems } = await this.collectionService.findAll(ctx);
+        if (totalItems > 0) {
+            return;
+        }
+        const parent = await this.collectionService.create(ctx, {
+            filters: [],
+            translations: [
+                {
+                    name: 'parent collection',
+                    slug: 'parent-collection',
+                    description: 'parent collection description',
+                    languageCode: LanguageCode.en,
+                    customFields: {},
+                },
+            ],
+        });
+        await this.collectionService.create(ctx, {
+            filters: [],
+            parentId: parent?.id,
+            customFields: {
+                campaignId: campaign?.id,
+            },
+            translations: [
+                {
+                    name: 'children collection',
+                    slug: 'children-collection',
+                    description: 'children collection description',
+                    languageCode: LanguageCode.en,
+                    customFields: {},
+                },
+            ],
+        });
+    }
+}
diff --git a/packages/core/e2e/fixtures/test-plugins/issue-2453/services/default-campaigns/default-campaigns.ts b/packages/core/e2e/fixtures/test-plugins/issue-2453/services/default-campaigns/default-campaigns.ts
new file mode 100644
index 0000000000..c402876ba7
--- /dev/null
+++ b/packages/core/e2e/fixtures/test-plugins/issue-2453/services/default-campaigns/default-campaigns.ts
@@ -0,0 +1,23 @@
+import { LanguageCode } from '@vendure/common/lib/generated-types';
+
+export const defaultCampaigns = () =>
+    [
+        {
+            code: 'discount',
+            campaignType: 'DirectDiscount',
+            needClaimCoupon: false,
+            enabled: true,
+            translations: [
+                {
+                    languageCode: LanguageCode.en,
+                    name: 'Clearance Up to 70% Off frames',
+                    shortDesc: 'Clearance Up to 70% Off frames',
+                },
+                {
+                    languageCode: LanguageCode.de,
+                    name: 'Clearance Up to 70% Off frames of de',
+                    shortDesc: 'Clearance Up to 70% Off frames of de',
+                },
+            ],
+        },
+    ] as any[];
diff --git a/packages/core/e2e/fixtures/test-plugins/issue-2453/services/default-campaigns/index.ts b/packages/core/e2e/fixtures/test-plugins/issue-2453/services/default-campaigns/index.ts
new file mode 100644
index 0000000000..31fab4a66d
--- /dev/null
+++ b/packages/core/e2e/fixtures/test-plugins/issue-2453/services/default-campaigns/index.ts
@@ -0,0 +1,3 @@
+import { defaultCampaigns } from './default-campaigns';
+
+export const defaultCampaignData = () => [...defaultCampaigns()];

From ec61b58f967eaac9f6001ad7a81e749e1ed1bd84 Mon Sep 17 00:00:00 2001
From: HoseinGhanbari <31586783+HoseinGhanbari@users.noreply.github.com>
Date: Tue, 17 Oct 2023 14:41:48 +0330
Subject: [PATCH 11/49] fix(admin-ui): Add missing RTL compatibility to some
 admin-ui components (#2451)

---
 .../app-shell/app-shell.component.ts          | 23 +++++++----
 .../notification/notification.component.html  | 21 ++++------
 .../notification/notification.component.ts    | 20 +++++++++-
 .../theme-switcher.component.scss             | 16 +++++++-
 .../localization/localization.service.spec.ts | 29 ++++++++++++++
 .../localization/localization.service.ts      | 34 ++++++++++++++++
 .../dropdown/dropdown-menu.component.ts       | 39 ++++++++++---------
 .../modal-dialog/modal-dialog.component.html  | 32 +++++++--------
 .../modal-dialog/modal-dialog.component.ts    | 30 ++++++++------
 9 files changed, 171 insertions(+), 73 deletions(-)
 create mode 100644 packages/admin-ui/src/lib/core/src/providers/localization/localization.service.spec.ts
 create mode 100644 packages/admin-ui/src/lib/core/src/providers/localization/localization.service.ts

diff --git a/packages/admin-ui/src/lib/core/src/components/app-shell/app-shell.component.ts b/packages/admin-ui/src/lib/core/src/components/app-shell/app-shell.component.ts
index 7fcf559b68..2a6d617200 100644
--- a/packages/admin-ui/src/lib/core/src/components/app-shell/app-shell.component.ts
+++ b/packages/admin-ui/src/lib/core/src/components/app-shell/app-shell.component.ts
@@ -13,6 +13,11 @@ import { I18nService } from '../../providers/i18n/i18n.service';
 import { LocalStorageService } from '../../providers/local-storage/local-storage.service';
 import { ModalService } from '../../providers/modal/modal.service';
 import { UiLanguageSwitcherDialogComponent } from '../ui-language-switcher-dialog/ui-language-switcher-dialog.component';
+import {
+    LocalizationDirectionType,
+    LocalizationLanguageCodeType,
+    LocalizationService,
+} from '../../providers/localization/localization.service';
 
 @Component({
     selector: 'vdr-app-shell',
@@ -22,8 +27,8 @@ import { UiLanguageSwitcherDialogComponent } from '../ui-language-switcher-dialo
 export class AppShellComponent implements OnInit {
     version = ADMIN_UI_VERSION;
     userName$: Observable<string>;
-    uiLanguageAndLocale$: Observable<[LanguageCode, string | undefined]>;
-    direction$: Observable<'ltr' | 'rtl'>;
+    uiLanguageAndLocale$: LocalizationLanguageCodeType;
+    direction$: LocalizationDirectionType;
     availableLanguages: LanguageCode[] = [];
     hideVendureBranding = getAppConfig().hideVendureBranding;
     pageTitle$: Observable<string>;
@@ -38,25 +43,27 @@ export class AppShellComponent implements OnInit {
         private modalService: ModalService,
         private localStorageService: LocalStorageService,
         private breadcrumbService: BreadcrumbService,
+        private localizationService: LocalizationService,
     ) {}
 
     ngOnInit() {
+        this.direction$ = this.localizationService.direction$;
+
+        this.uiLanguageAndLocale$ = this.localizationService.uiLanguageAndLocale$;
+
         this.userName$ = this.dataService.client
             .userStatus()
             .single$.pipe(map(data => data.userStatus.username));
-        this.uiLanguageAndLocale$ = this.dataService.client
-            .uiState()
-            .stream$.pipe(map(({ uiState }) => [uiState.language, uiState.locale ?? undefined]));
+
         this.availableLanguages = this.i18nService.availableLanguages;
+
         this.pageTitle$ = this.breadcrumbService.breadcrumbs$.pipe(
             map(breadcrumbs => breadcrumbs[breadcrumbs.length - 1].label),
         );
+
         this.mainNavExpanded$ = this.dataService.client
             .uiState()
             .stream$.pipe(map(({ uiState }) => uiState.mainNavExpanded));
-        this.direction$ = this.uiLanguageAndLocale$.pipe(
-            map(([languageCode]) => (this.i18nService.isRTL(languageCode) ? 'rtl' : 'ltr')),
-        );
     }
 
     selectUiLanguage() {
diff --git a/packages/admin-ui/src/lib/core/src/components/notification/notification.component.html b/packages/admin-ui/src/lib/core/src/components/notification/notification.component.html
index d736ec5eb7..5f36f1b86d 100644
--- a/packages/admin-ui/src/lib/core/src/components/notification/notification.component.html
+++ b/packages/admin-ui/src/lib/core/src/components/notification/notification.component.html
@@ -1,15 +1,10 @@
-<div
-    class="notification-wrapper"
-    #wrapper
-    [style.top.px]="offsetTop"
-    [ngClass]="{
-        visible: isVisible,
-        info: type === 'info',
-        success: type === 'success',
-        error: type === 'error',
-        warning: type === 'warning'
-    }"
->
+<div [dir]="direction$ | async" class="notification-wrapper" #wrapper [style.top.px]="offsetTop" [ngClass]="{
+            visible: isVisible,
+            info: type === 'info',
+            success: type === 'success',
+            error: type === 'error',
+            warning: type === 'warning'
+        }">
     <clr-icon [attr.shape]="getIcon()" size="24"></clr-icon>
     {{ stringifyMessage(message) | translate: translationVars }}
-</div>
+</div>
\ No newline at end of file
diff --git a/packages/admin-ui/src/lib/core/src/components/notification/notification.component.ts b/packages/admin-ui/src/lib/core/src/components/notification/notification.component.ts
index 145ddfb1f0..56bb80cf8f 100644
--- a/packages/admin-ui/src/lib/core/src/components/notification/notification.component.ts
+++ b/packages/admin-ui/src/lib/core/src/components/notification/notification.component.ts
@@ -1,13 +1,20 @@
-import { Component, ElementRef, HostListener, ViewChild } from '@angular/core';
+import { Component, ElementRef, HostListener, OnInit, ViewChild } from '@angular/core';
 
 import { NotificationType } from '../../providers/notification/notification.service';
 
+import {
+    LocalizationDirectionType,
+    LocalizationService,
+} from '../../providers/localization/localization.service';
+
 @Component({
     selector: 'vdr-notification',
     templateUrl: './notification.component.html',
     styleUrls: ['./notification.component.scss'],
 })
-export class NotificationComponent {
+export class NotificationComponent implements OnInit {
+    direction$: LocalizationDirectionType;
+
     @ViewChild('wrapper', { static: true }) wrapper: ElementRef;
     offsetTop = 0;
     message = '';
@@ -18,6 +25,15 @@ export class NotificationComponent {
         /* */
     };
 
+    /**
+     *
+     */
+    constructor(private localizationService: LocalizationService) {}
+
+    ngOnInit(): void {
+        this.direction$ = this.localizationService.direction$;
+    }
+
     registerOnClickFn(fn: () => void): void {
         this.onClickFn = fn;
     }
diff --git a/packages/admin-ui/src/lib/core/src/components/theme-switcher/theme-switcher.component.scss b/packages/admin-ui/src/lib/core/src/components/theme-switcher/theme-switcher.component.scss
index 7cea448e4b..f76dba5bfd 100644
--- a/packages/admin-ui/src/lib/core/src/components/theme-switcher/theme-switcher.component.scss
+++ b/packages/admin-ui/src/lib/core/src/components/theme-switcher/theme-switcher.component.scss
@@ -1,6 +1,6 @@
 :host {
     display: flex;
-    justify-content: start;
+    justify-content: flex-start;
     align-items: center;
 }
 
@@ -27,10 +27,24 @@ button.theme-toggle {
         left: 0px;
         opacity: 1;
     }
+
     &.default.active {
         color: #d6ae3f;
     }
+
     &.dark.active {
         color: #ffdf3a;
     }
 }
+
+:host-context([dir='rtl']) {
+    .theme-icon {
+        left: auto;
+        right: 6px;
+
+        &.active {
+            left: auto;
+            right: 0px;
+        }
+    }
+}
\ No newline at end of file
diff --git a/packages/admin-ui/src/lib/core/src/providers/localization/localization.service.spec.ts b/packages/admin-ui/src/lib/core/src/providers/localization/localization.service.spec.ts
new file mode 100644
index 0000000000..11b0e789b4
--- /dev/null
+++ b/packages/admin-ui/src/lib/core/src/providers/localization/localization.service.spec.ts
@@ -0,0 +1,29 @@
+import { TestBed } from '@angular/core/testing';
+
+import { CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
+import { TestingCommonModule } from '../../../../../testing/testing-common.module';
+import { MockI18nService } from '../i18n/i18n.service.mock';
+import { DataService } from '../../data/providers/data.service';
+import { I18nService } from '../../providers/i18n/i18n.service';
+import { LocalizationService } from './localization.service';
+
+describe('LocalizationService', () => {
+    let service: LocalizationService;
+
+    beforeEach(() => {
+        TestBed.configureTestingModule({
+            imports: [TestingCommonModule],
+            providers: [
+                LocalizationService,
+                { provide: I18nService, useClass: MockI18nService },
+                { provide: DataService, useClass: class {} },
+            ],
+            schemas: [CUSTOM_ELEMENTS_SCHEMA],
+        });
+        service = TestBed.inject(LocalizationService);
+    });
+
+    it('should be created', () => {
+        expect(service).toBeTruthy();
+    });
+});
diff --git a/packages/admin-ui/src/lib/core/src/providers/localization/localization.service.ts b/packages/admin-ui/src/lib/core/src/providers/localization/localization.service.ts
new file mode 100644
index 0000000000..9b40ffc26f
--- /dev/null
+++ b/packages/admin-ui/src/lib/core/src/providers/localization/localization.service.ts
@@ -0,0 +1,34 @@
+import { Injectable } from '@angular/core';
+import { Observable, map } from 'rxjs';
+
+import { DataService } from '../../data/providers/data.service';
+import { I18nService } from '../../providers/i18n/i18n.service';
+import { LanguageCode } from '../../common/generated-types';
+
+export type LocalizationDirectionType = Observable<'ltr' | 'rtl'>;
+export type LocalizationLanguageCodeType = Observable<[LanguageCode, string | undefined]>;
+
+/**
+ * @description
+ * Provides localization helper functionality.
+ *
+ */
+@Injectable({
+    providedIn: 'root',
+})
+export class LocalizationService {
+    uiLanguageAndLocale$: LocalizationLanguageCodeType;
+    direction$: LocalizationDirectionType;
+
+    constructor(private i18nService: I18nService, private dataService: DataService) {
+        this.uiLanguageAndLocale$ = this.dataService.client
+            ?.uiState()
+            ?.stream$?.pipe(map(({ uiState }) => [uiState.language, uiState.locale ?? undefined]));
+
+        this.direction$ = this.uiLanguageAndLocale$?.pipe(
+            map(([languageCode]) => {
+                return this.i18nService.isRTL(languageCode) ? 'rtl' : 'ltr';
+            }),
+        );
+    }
+}
diff --git a/packages/admin-ui/src/lib/core/src/shared/components/dropdown/dropdown-menu.component.ts b/packages/admin-ui/src/lib/core/src/shared/components/dropdown/dropdown-menu.component.ts
index 25b37db1f5..80f190f0be 100644
--- a/packages/admin-ui/src/lib/core/src/shared/components/dropdown/dropdown-menu.component.ts
+++ b/packages/admin-ui/src/lib/core/src/shared/components/dropdown/dropdown-menu.component.ts
@@ -1,18 +1,9 @@
-import {
-    ConnectedPosition,
-    HorizontalConnectionPos,
-    Overlay,
-    OverlayRef,
-    PositionStrategy,
-    VerticalConnectionPos,
-} from '@angular/cdk/overlay';
+import { ConnectedPosition, Overlay, OverlayRef, PositionStrategy } from '@angular/cdk/overlay';
 import { TemplatePortal } from '@angular/cdk/portal';
 import {
     AfterViewInit,
     ChangeDetectionStrategy,
     Component,
-    ContentChild,
-    ElementRef,
     HostListener,
     Input,
     OnDestroy,
@@ -23,7 +14,10 @@ import {
 } from '@angular/core';
 import { Subscription } from 'rxjs';
 
-import { DropdownTriggerDirective } from './dropdown-trigger.directive';
+import {
+    LocalizationDirectionType,
+    LocalizationService,
+} from '../../../providers/localization/localization.service';
 import { DropdownComponent } from './dropdown.component';
 
 export type DropdownPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
@@ -41,14 +35,16 @@ export type DropdownPosition = 'top-left' | 'top-right' | 'bottom-left' | 'botto
     selector: 'vdr-dropdown-menu',
     template: `
         <ng-template #menu>
-            <div class="dropdown open">
-                <div class="dropdown-menu" [ngClass]="customClasses">
-                    <div
-                        class="dropdown-content-wrapper"
-                        [cdkTrapFocus]="true"
-                        [cdkTrapFocusAutoCapture]="true"
-                    >
-                        <ng-content></ng-content>
+            <div [dir]="direction$ | async">
+                <div class="dropdown open">
+                    <div class="dropdown-menu" [ngClass]="customClasses">
+                        <div
+                            class="dropdown-content-wrapper"
+                            [cdkTrapFocus]="true"
+                            [cdkTrapFocusAutoCapture]="true"
+                        >
+                            <ng-content></ng-content>
+                        </div>
                     </div>
                 </div>
             </div>
@@ -58,6 +54,8 @@ export type DropdownPosition = 'top-left' | 'top-right' | 'bottom-left' | 'botto
     changeDetection: ChangeDetectionStrategy.OnPush,
 })
 export class DropdownMenuComponent implements AfterViewInit, OnInit, OnDestroy {
+    direction$: LocalizationDirectionType;
+
     @Input('vdrPosition') private position: DropdownPosition = 'bottom-left';
     @Input() customClasses: string;
     @ViewChild('menu', { static: true }) private menuTemplate: TemplateRef<any>;
@@ -104,9 +102,12 @@ export class DropdownMenuComponent implements AfterViewInit, OnInit, OnDestroy {
         private overlay: Overlay,
         private viewContainerRef: ViewContainerRef,
         private dropdown: DropdownComponent,
+        private localizationService: LocalizationService,
     ) {}
 
     ngOnInit(): void {
+        this.direction$ = this.localizationService.direction$;
+
         this.dropdown.onOpenChange(isOpen => {
             if (isOpen) {
                 this.overlayRef.attach(this.menuPortal);
diff --git a/packages/admin-ui/src/lib/core/src/shared/components/modal-dialog/modal-dialog.component.html b/packages/admin-ui/src/lib/core/src/shared/components/modal-dialog/modal-dialog.component.html
index 585238b266..e51e477ffc 100644
--- a/packages/admin-ui/src/lib/core/src/shared/components/modal-dialog/modal-dialog.component.html
+++ b/packages/admin-ui/src/lib/core/src/shared/components/modal-dialog/modal-dialog.component.html
@@ -1,18 +1,14 @@
-<clr-modal
-    [clrModalOpen]="true"
-    (clrModalOpenChange)="modalOpenChange($event)"
-    [clrModalClosable]="options?.closable"
-    [clrModalSize]="options?.size"
-    [ngClass]="'modal-valign-' + (options?.verticalAlign || 'center')"
->
-    <h3 class="modal-title"><ng-container *ngTemplateOutlet="(titleTemplateRef$ | async)"></ng-container></h3>
-    <div class="modal-body">
-        <vdr-dialog-component-outlet
-            [component]="childComponentType"
-            (create)="onCreate($event)"
-        ></vdr-dialog-component-outlet>
-    </div>
-    <div class="modal-footer">
-        <ng-container *ngTemplateOutlet="(buttonsTemplateRef$ | async)"></ng-container>
-    </div>
-</clr-modal>
+<div [dir]="direction$ | async">
+    <clr-modal [clrModalOpen]="true" (clrModalOpenChange)="modalOpenChange($event)"
+        [clrModalClosable]="options?.closable" [clrModalSize]="options?.size"
+        [ngClass]="'modal-valign-' + (options?.verticalAlign || 'center')">
+        <h3 class="modal-title"><ng-container *ngTemplateOutlet="(titleTemplateRef$ | async)"></ng-container></h3>
+        <div class="modal-body">
+            <vdr-dialog-component-outlet [component]="childComponentType"
+                (create)="onCreate($event)"></vdr-dialog-component-outlet>
+        </div>
+        <div class="modal-footer">
+            <ng-container *ngTemplateOutlet="(buttonsTemplateRef$ | async)"></ng-container>
+        </div>
+    </clr-modal>
+</div>
\ No newline at end of file
diff --git a/packages/admin-ui/src/lib/core/src/shared/components/modal-dialog/modal-dialog.component.ts b/packages/admin-ui/src/lib/core/src/shared/components/modal-dialog/modal-dialog.component.ts
index ebb55bfa43..6f51981b65 100644
--- a/packages/admin-ui/src/lib/core/src/shared/components/modal-dialog/modal-dialog.component.ts
+++ b/packages/admin-ui/src/lib/core/src/shared/components/modal-dialog/modal-dialog.component.ts
@@ -1,15 +1,10 @@
-import {
-    Component,
-    ContentChild,
-    ContentChildren,
-    QueryList,
-    TemplateRef,
-    Type,
-    ViewChild,
-    ViewChildren,
-} from '@angular/core';
-import { Observable, Subject } from 'rxjs';
+import { Component, OnInit, TemplateRef, Type } from '@angular/core';
+import { Subject } from 'rxjs';
 
+import {
+    LocalizationDirectionType,
+    LocalizationService,
+} from '../../../providers/localization/localization.service';
 import { Dialog, ModalOptions } from '../../../providers/modal/modal.types';
 
 import { DialogButtonsDirective } from './dialog-buttons.directive';
@@ -23,13 +18,24 @@ import { DialogButtonsDirective } from './dialog-buttons.directive';
     templateUrl: './modal-dialog.component.html',
     styleUrls: ['./modal-dialog.component.scss'],
 })
-export class ModalDialogComponent<T extends Dialog<any>> {
+export class ModalDialogComponent<T extends Dialog<any>> implements OnInit {
+    direction$: LocalizationDirectionType;
+
     childComponentType: Type<T>;
     closeModal: (result?: any) => void;
     titleTemplateRef$ = new Subject<TemplateRef<any>>();
     buttonsTemplateRef$ = new Subject<TemplateRef<any>>();
     options?: ModalOptions<T>;
 
+    /**
+     *
+     */
+    constructor(private localizationService: LocalizationService) {}
+
+    ngOnInit(): void {
+        this.direction$ = this.localizationService.direction$;
+    }
+
     /**
      * This callback is invoked when the childComponentType is instantiated in the
      * template by the {@link DialogComponentOutletComponent}.

From b0ece212dcb098d1ab17ecbfba50de12fe9cc416 Mon Sep 17 00:00:00 2001
From: Balazs Gallay <carathorys@users.noreply.github.com>
Date: Tue, 17 Oct 2023 14:51:07 +0200
Subject: [PATCH 12/49] fix(payments-plugin): Fix Stripe controller crashing
 server instance (#2454)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Fixes #2450

Co-authored-by: Balázs Gallay <balazs.gallay@zooshgroup.com>
---
 .../e2e/stripe-payment.e2e-spec.ts            | 99 ++++++++++++++++++-
 .../src/stripe/raw-body.middleware.ts         |  1 +
 .../src/stripe/stripe.controller.ts           | 15 ++-
 3 files changed, 110 insertions(+), 5 deletions(-)

diff --git a/packages/payments-plugin/e2e/stripe-payment.e2e-spec.ts b/packages/payments-plugin/e2e/stripe-payment.e2e-spec.ts
index 7bebbfcef7..a4bfe62d5d 100644
--- a/packages/payments-plugin/e2e/stripe-payment.e2e-spec.ts
+++ b/packages/payments-plugin/e2e/stripe-payment.e2e-spec.ts
@@ -10,7 +10,9 @@ import { CREATE_PRODUCT, CREATE_PRODUCT_VARIANTS } from '@vendure/core/e2e/graph
 import { createTestEnvironment, E2E_DEFAULT_CHANNEL_TOKEN } from '@vendure/testing';
 import gql from 'graphql-tag';
 import nock from 'nock';
+import fetch from 'node-fetch';
 import path from 'path';
+import { Stripe } from 'stripe';
 import { afterAll, beforeAll, describe, expect, it } from 'vitest';
 
 import { initialData } from '../../../e2e-common/e2e-initial-data';
@@ -293,6 +295,101 @@ describe('Stripe payments', () => {
         });
     });
 
+    // https://github.com/vendure-ecommerce/vendure/issues/2450
+    it('Should not crash on signature validation failure', async () => {
+        const MOCKED_WEBHOOK_PAYLOAD = {
+            id: 'evt_0',
+            object: 'event',
+            api_version: '2022-11-15',
+            data: {
+                object: {
+                    id: 'pi_0',
+                    currency: 'usd',
+                    status: 'succeeded',
+                },
+            },
+            livemode: false,
+            pending_webhooks: 1,
+            request: {
+                id: 'req_0',
+                idempotency_key: '00000000-0000-0000-0000-000000000000',
+            },
+            type: 'payment_intent.succeeded',
+        };
+
+        const payloadString = JSON.stringify(MOCKED_WEBHOOK_PAYLOAD, null, 2);
+
+        const result = await fetch(`http://localhost:${serverPort}/payments/stripe`, {
+            method: 'post',
+            body: payloadString,
+            headers: { 'Content-Type': 'application/json' },
+        });
+
+        // We didn't provided any signatures, it should result in a 400 - Bad request
+        expect(result.status).toEqual(400);
+    });
+
+    // TODO: Contribution welcome: test webhook handling and order settlement
+    // https://github.com/vendure-ecommerce/vendure/issues/2450
+    it("Should validate the webhook's signature properly", async () => {
+        await shopClient.asUserWithCredentials(customers[0].emailAddress, 'test');
+
+        const { activeOrder } = await shopClient.query<GetActiveOrderQuery>(GET_ACTIVE_ORDER);
+        order = activeOrder!;
+
+        const MOCKED_WEBHOOK_PAYLOAD = {
+            id: 'evt_0',
+            object: 'event',
+            api_version: '2022-11-15',
+            data: {
+                object: {
+                    id: 'pi_0',
+                    currency: 'usd',
+                    metadata: {
+                        orderCode: order.code,
+                        orderId: parseInt(order.id.replace('T_', ''), 10),
+                        channelToken: E2E_DEFAULT_CHANNEL_TOKEN,
+                    },
+                    amount_received: order.totalWithTax,
+                    status: 'succeeded',
+                },
+            },
+            livemode: false,
+            pending_webhooks: 1,
+            request: {
+                id: 'req_0',
+                idempotency_key: '00000000-0000-0000-0000-000000000000',
+            },
+            type: 'payment_intent.succeeded',
+        };
+
+        const payloadString = JSON.stringify(MOCKED_WEBHOOK_PAYLOAD, null, 2);
+        const stripeWebhooks = new Stripe('test-api-secret', { apiVersion: '2023-08-16' }).webhooks;
+        const header = stripeWebhooks.generateTestHeaderString({
+            payload: payloadString,
+            secret: 'test-signing-secret',
+        });
+
+        const event = stripeWebhooks.constructEvent(payloadString, header, 'test-signing-secret');
+        expect(event.id).to.equal(MOCKED_WEBHOOK_PAYLOAD.id);
+        await setShipping(shopClient);
+        // Due to the `this.orderService.transitionToState(...)` fails with the internal lookup by id,
+        // we need to put the order into `ArrangingPayment` state manually before calling the webhook handler.
+        // const transitionResult = await adminClient.query(TRANSITION_TO_ARRANGING_PAYMENT, { id: order.id });
+        // expect(transitionResult.transitionOrderToState.__typename).toBe('Order')
+
+        const result = await fetch(`http://localhost:${serverPort}/payments/stripe`, {
+            method: 'post',
+            body: payloadString,
+            headers: { 'Content-Type': 'application/json', 'Stripe-Signature': header },
+        });
+
+        // I would expect to the status to be 200, but at the moment either the
+        // `orderService.transitionToState()` or the `orderService.addPaymentToOrder()`
+        // throws an error of 'error.entity-with-id-not-found'
+        expect(result.status).toEqual(200);
+    });
+
     // https://github.com/vendure-ecommerce/vendure/issues/1630
     describe('currencies with no fractional units', () => {
         let japanProductId: string;
@@ -401,6 +498,4 @@ describe('Stripe payments', () => {
             expect(createPaymentIntentPayload.currency).toBe('jpy');
         });
     });
-
-    // TODO: Contribution welcome: test webhook handling and order settlement
 });
diff --git a/packages/payments-plugin/src/stripe/raw-body.middleware.ts b/packages/payments-plugin/src/stripe/raw-body.middleware.ts
index 03257b6748..71c21b55ac 100644
--- a/packages/payments-plugin/src/stripe/raw-body.middleware.ts
+++ b/packages/payments-plugin/src/stripe/raw-body.middleware.ts
@@ -8,6 +8,7 @@ import { RequestWithRawBody } from './types';
  * Stripe to properly verify webhook events.
  */
 export const rawBodyMiddleware = raw({
+    type: '*/*',
     verify(req: RequestWithRawBody, res: http.ServerResponse, buf: Buffer, encoding: string) {
         if (Buffer.isBuffer(buf)) {
             req.rawBody = Buffer.from(buf);
diff --git a/packages/payments-plugin/src/stripe/stripe.controller.ts b/packages/payments-plugin/src/stripe/stripe.controller.ts
index 91fd4fde04..0c80a5d512 100644
--- a/packages/payments-plugin/src/stripe/stripe.controller.ts
+++ b/packages/payments-plugin/src/stripe/stripe.controller.ts
@@ -45,7 +45,7 @@ export class StripeController {
             return;
         }
 
-        const event = request.body as Stripe.Event;
+        const event = JSON.parse(request.body.toString()) as Stripe.Event;
         const paymentIntent = event.data.object as Stripe.PaymentIntent;
 
         if (!paymentIntent) {
@@ -120,11 +120,20 @@ export class StripeController {
                     `Error adding payment to order ${orderCode}: ${addPaymentToOrderResult.message}`,
                     loggerCtx,
                 );
+                return;
             }
+
+            // The payment intent ID is added to the order only if we can reach this point.
+            Logger.info(
+                `Stripe payment intent id ${paymentIntent.id} added to order ${orderCode}`,
+                loggerCtx,
+            );
         });
 
-        Logger.info(`Stripe payment intent id ${paymentIntent.id} added to order ${orderCode}`, loggerCtx);
-        response.status(HttpStatus.OK).send('Ok');
+        // Send the response status only if we didn't sent anything yet.
+        if (!response.headersSent) {
+            response.status(HttpStatus.OK).send('Ok');
+        }
     }
 
     private async createContext(channelToken: string, req: RequestWithRawBody): Promise<RequestContext> {

From b7f34528bf02668da4b3b67aa2684ab323672787 Mon Sep 17 00:00:00 2001
From: Gautier Darchen <gautier.darchen@swile.co>
Date: Tue, 17 Oct 2023 15:51:00 +0200
Subject: [PATCH 13/49] feat(admin-ui): Add product slug in product multi
 selector dialog component (#2461)

---
 .../product-multi-selector-dialog.component.html            | 6 ++++++
 .../product-multi-selector-dialog.component.scss            | 1 +
 2 files changed, 7 insertions(+)

diff --git a/packages/admin-ui/src/lib/core/src/shared/components/product-multi-selector-dialog/product-multi-selector-dialog.component.html b/packages/admin-ui/src/lib/core/src/shared/components/product-multi-selector-dialog/product-multi-selector-dialog.component.html
index 0a0f9737cd..538c96f4e6 100644
--- a/packages/admin-ui/src/lib/core/src/shared/components/product-multi-selector-dialog/product-multi-selector-dialog.component.html
+++ b/packages/admin-ui/src/lib/core/src/shared/components/product-multi-selector-dialog/product-multi-selector-dialog.component.html
@@ -37,6 +37,12 @@
                 <span [title]="mode === 'product' ? item.productName : item.productVariantName">{{
                     mode === 'product' ? item.productName : item.productVariantName
                 }}</span>
+                <div *ngIf="mode === 'product'">
+                    <small>
+                        <span class="mr-1">{{ 'common.slug' | translate }}:</span>
+                        <code>{{ item.slug }}</code>
+                    </small>
+                </div>
                 <div *ngIf="mode === 'variant'"><small>{{ item.sku }}</small></div>
             </div>
         </div>
diff --git a/packages/admin-ui/src/lib/core/src/shared/components/product-multi-selector-dialog/product-multi-selector-dialog.component.scss b/packages/admin-ui/src/lib/core/src/shared/components/product-multi-selector-dialog/product-multi-selector-dialog.component.scss
index 86d39a37a0..def20113c7 100644
--- a/packages/admin-ui/src/lib/core/src/shared/components/product-multi-selector-dialog/product-multi-selector-dialog.component.scss
+++ b/packages/admin-ui/src/lib/core/src/shared/components/product-multi-selector-dialog/product-multi-selector-dialog.component.scss
@@ -74,3 +74,4 @@ vdr-select-toggle {
     align-items: center;
     justify-content: space-between;
 }
+

From 2f7a8d5f586fe22d67d414cc46c4048b019da60e Mon Sep 17 00:00:00 2001
From: Martijn <martijnvdbrug@users.noreply.github.com>
Date: Tue, 17 Oct 2023 16:22:33 +0200
Subject: [PATCH 14/49] fix(payments-plugin): Idempotent 'paid' Mollie webhooks
 (#2462)

---
 .../src/mollie/mollie.helpers.ts               | 18 ++++++++++--------
 .../src/mollie/mollie.service.ts               | 14 +++++++-------
 2 files changed, 17 insertions(+), 15 deletions(-)

diff --git a/packages/payments-plugin/src/mollie/mollie.helpers.ts b/packages/payments-plugin/src/mollie/mollie.helpers.ts
index 0c732fae10..6b8612cc77 100644
--- a/packages/payments-plugin/src/mollie/mollie.helpers.ts
+++ b/packages/payments-plugin/src/mollie/mollie.helpers.ts
@@ -61,14 +61,16 @@ export function toMollieOrderLines(order: Order, alreadyPaid: number): CreatePar
         vatAmount: toAmount(surcharge.priceWithTax - surcharge.price, order.currencyCode),
     })));
     // Deduct amount already paid
-    lines.push({
-        name: 'Already paid',
-        quantity: 1,
-        unitPrice: toAmount(-alreadyPaid, order.currencyCode),
-        totalAmount: toAmount(-alreadyPaid, order.currencyCode),
-        vatRate: String(0),
-        vatAmount: toAmount(0, order.currencyCode),
-    });
+    if (alreadyPaid) {
+        lines.push({
+            name: 'Already paid',
+            quantity: 1,
+            unitPrice: toAmount(-alreadyPaid, order.currencyCode),
+            totalAmount: toAmount(-alreadyPaid, order.currencyCode),
+            vatRate: String(0),
+            vatAmount: toAmount(0, order.currencyCode),
+        });
+    }
     return lines;
 }
 
diff --git a/packages/payments-plugin/src/mollie/mollie.service.ts b/packages/payments-plugin/src/mollie/mollie.service.ts
index 27e1f90498..2c9aadb43f 100644
--- a/packages/payments-plugin/src/mollie/mollie.service.ts
+++ b/packages/payments-plugin/src/mollie/mollie.service.ts
@@ -227,6 +227,13 @@ export class MollieService {
                 `Unable to find order ${mollieOrder.orderNumber}, unable to process Mollie order ${mollieOrder.id}`,
             );
         }
+        if (order.state === 'PaymentSettled') {
+            Logger.info(
+                `Order ${order.code} is already 'PaymentSettled', no need for handling Mollie status '${mollieOrder.status}'`,
+                loggerCtx,
+            );
+            return;
+        }
         if (mollieOrder.status === OrderStatus.expired) {
             // Expired is fine, a customer can retry the payment later
             return;
@@ -248,13 +255,6 @@ export class MollieService {
         if (order.state === 'PaymentAuthorized' && mollieOrder.status === OrderStatus.completed) {
             return this.settleExistingPayment(ctx, order, mollieOrder.id);
         }
-        if (order.state === 'PaymentAuthorized' || order.state === 'PaymentSettled') {
-            Logger.info(
-                `Order ${order.code} is '${order.state}', no need for handling Mollie status '${mollieOrder.status}'`,
-                loggerCtx,
-            );
-            return;
-        }
         // Any other combination of Mollie status and Vendure status indicates something is wrong.
         throw Error(
             `Unhandled incoming Mollie status '${mollieOrder.status}' for order ${order.code} with status '${order.state}'`,

From 08ad982c6ef31fd53c5d95937c83ae8e313b9f32 Mon Sep 17 00:00:00 2001
From: Jonas Osburg <jonas.osburg@medicalvalues.de>
Date: Tue, 17 Oct 2023 16:27:18 +0200
Subject: [PATCH 15/49] fix(admin-ui): Do not load pending search index updates
 if permissions are insufficient (#2460)

Fixes #2456
---
 .../admin-ui/src/lib/core/src/core.module.ts  |  2 +
 .../src/providers/alerts/alerts.service.ts    | 39 ++++++++++++++++---
 2 files changed, 36 insertions(+), 5 deletions(-)

diff --git a/packages/admin-ui/src/lib/core/src/core.module.ts b/packages/admin-ui/src/lib/core/src/core.module.ts
index 5c23645a6b..8324271b69 100644
--- a/packages/admin-ui/src/lib/core/src/core.module.ts
+++ b/packages/admin-ui/src/lib/core/src/core.module.ts
@@ -30,6 +30,7 @@ import { LocalStorageService } from './providers/local-storage/local-storage.ser
 import { NotificationService } from './providers/notification/notification.service';
 import { registerDefaultFormInputs } from './shared/dynamic-form-inputs/default-form-inputs';
 import { SharedModule } from './shared/shared.module';
+import { Permission } from './public_api';
 
 @NgModule({
     imports: [
@@ -107,6 +108,7 @@ export class CoreModule {
     private initAlerts() {
         this.alertsService.configureAlert({
             id: 'pending-search-index-updates',
+            requiredPermissions: [Permission.ReadCatalog, Permission.ReadProduct],
             check: () =>
                 this.dataService.product
                     .getPendingSearchIndexUpdates()
diff --git a/packages/admin-ui/src/lib/core/src/providers/alerts/alerts.service.ts b/packages/admin-ui/src/lib/core/src/providers/alerts/alerts.service.ts
index 69abd9ecb3..25e41d66c7 100644
--- a/packages/admin-ui/src/lib/core/src/providers/alerts/alerts.service.ts
+++ b/packages/admin-ui/src/lib/core/src/providers/alerts/alerts.service.ts
@@ -1,7 +1,17 @@
 import { Injectable } from '@angular/core';
 import { notNullOrUndefined } from '@vendure/common/lib/shared-utils';
-import { BehaviorSubject, combineLatest, interval, isObservable, Observable, Subject, switchMap } from 'rxjs';
-import { map, mapTo, startWith, take } from 'rxjs/operators';
+import {
+    BehaviorSubject,
+    combineLatest,
+    interval,
+    isObservable,
+    Observable,
+    of,
+    Subject,
+    switchMap,
+} from 'rxjs';
+import { filter, first, map, mapTo, startWith, take } from 'rxjs/operators';
+import { DataService, Permission } from '../../public_api';
 
 export interface AlertConfig<T = any> {
     id: string;
@@ -10,6 +20,7 @@ export interface AlertConfig<T = any> {
     isAlert: (value: T) => boolean;
     action: (data: T) => void;
     label: (data: T) => { text: string; translationVars?: { [key: string]: string | number } };
+    requiredPermissions?: Permission[];
 }
 
 export interface ActiveAlert {
@@ -74,7 +85,7 @@ export class AlertsService {
     private alertsMap = new Map<string, Alert<any>>();
     private configUpdated = new Subject<void>();
 
-    constructor() {
+    constructor(private dataService: DataService) {
         const alerts$ = this.configUpdated.pipe(
             mapTo([...this.alertsMap.values()]),
             startWith([...this.alertsMap.values()]),
@@ -91,8 +102,26 @@ export class AlertsService {
     }
 
     configureAlert<T>(config: AlertConfig<T>) {
-        this.alertsMap.set(config.id, new Alert(config));
-        this.configUpdated.next();
+        this.hasSufficientPermissions(config.requiredPermissions)
+            .pipe(first())
+            .subscribe(hasSufficientPermissions => {
+                if (hasSufficientPermissions) {
+                    this.alertsMap.set(config.id, new Alert(config));
+                    this.configUpdated.next();
+                }
+            });
+    }
+
+    hasSufficientPermissions(permissions?: Permission[]) {
+        if (!permissions || permissions.length === 0) {
+            return of(true);
+        }
+        return this.dataService.client.userStatus().stream$.pipe(
+            filter(({ userStatus }) => userStatus.isLoggedIn),
+            map(({ userStatus }) =>
+                permissions.some(permission => userStatus.permissions.includes(permission)),
+            ),
+        );
     }
 
     refresh(id?: string) {

From ce2b2519fb02fe0c2e6946252e365e60f3400d29 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Tue, 17 Oct 2023 14:48:17 +0200
Subject: [PATCH 16/49] fix(admin-ui): Add unique location id for prod detail
 variants table

---
 .../components/product-detail/product-detail.component.html    | 1 +
 .../product-variant-list/product-variant-list.component.html   | 2 +-
 .../product-variant-list/product-variant-list.component.ts     | 3 ++-
 .../data-table-2/data-table-custom-component.service.ts        | 1 +
 4 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/packages/admin-ui/src/lib/catalog/src/components/product-detail/product-detail.component.html b/packages/admin-ui/src/lib/catalog/src/components/product-detail/product-detail.component.html
index a9ecbb895b..189e242e1b 100644
--- a/packages/admin-ui/src/lib/catalog/src/components/product-detail/product-detail.component.html
+++ b/packages/admin-ui/src/lib/catalog/src/components/product-detail/product-detail.component.html
@@ -198,6 +198,7 @@
                 <ng-template #variantList>
                     <vdr-product-variant-list
                         [productId]="this.id"
+                        dataTableId="product-detail-variants-list"
                         [hideLanguageSelect]="true"
                     ></vdr-product-variant-list>
                 </ng-template>
diff --git a/packages/admin-ui/src/lib/catalog/src/components/product-variant-list/product-variant-list.component.html b/packages/admin-ui/src/lib/catalog/src/components/product-variant-list/product-variant-list.component.html
index 1b11b1eb38..62466347e3 100644
--- a/packages/admin-ui/src/lib/catalog/src/components/product-variant-list/product-variant-list.component.html
+++ b/packages/admin-ui/src/lib/catalog/src/components/product-variant-list/product-variant-list.component.html
@@ -7,7 +7,7 @@
 </vdr-page-block>
 <vdr-data-table-2
     class="mt-2"
-    id="product-variant-list"
+    [id]="dataTableId || 'product-variant-list'"
     [items]="items$ | async"
     [itemsPerPage]="itemsPerPage$ | async"
     [totalItems]="totalItems$ | async"
diff --git a/packages/admin-ui/src/lib/catalog/src/components/product-variant-list/product-variant-list.component.ts b/packages/admin-ui/src/lib/catalog/src/components/product-variant-list/product-variant-list.component.ts
index 395a10dd06..2e9dc191ff 100644
--- a/packages/admin-ui/src/lib/catalog/src/components/product-variant-list/product-variant-list.component.ts
+++ b/packages/admin-ui/src/lib/catalog/src/components/product-variant-list/product-variant-list.component.ts
@@ -1,7 +1,7 @@
 import { Component, Input, OnInit } from '@angular/core';
 import { marker as _ } from '@biesbjerg/ngx-translate-extract-marker';
 import {
-    LogicalOperator,
+    DataTableLocationId,
     ProductVariantListQueryDocument,
     TypedBaseListComponent,
 } from '@vendure/admin-ui/core';
@@ -17,6 +17,7 @@ export class ProductVariantListComponent
 {
     @Input() productId?: string;
     @Input() hideLanguageSelect = false;
+    @Input() dataTableId: DataTableLocationId | undefined;
     readonly customFields = this.getCustomFieldConfig('ProductVariant');
     readonly filters = this.createFilterCollection()
         .addIdFilter()
diff --git a/packages/admin-ui/src/lib/core/src/shared/components/data-table-2/data-table-custom-component.service.ts b/packages/admin-ui/src/lib/core/src/shared/components/data-table-2/data-table-custom-component.service.ts
index c58014e449..719efca353 100644
--- a/packages/admin-ui/src/lib/core/src/shared/components/data-table-2/data-table-custom-component.service.ts
+++ b/packages/admin-ui/src/lib/core/src/shared/components/data-table-2/data-table-custom-component.service.ts
@@ -9,6 +9,7 @@ export type DataTableLocationId =
     | 'edit-options-list'
     | 'manage-product-variant-list'
     | 'customer-order-list'
+    | 'product-detail-variants-list'
     | string;
 
 export type DataTableColumnId =

From 74c6634608ea9c266e9d8db97efa7416d6eaa68f Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Tue, 17 Oct 2023 15:18:19 +0200
Subject: [PATCH 17/49] fix(admin-ui): Make utility margin/padding classes
 RTL-compatible

---
 .../src/lib/static/styles/global/_utilities.scss     | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/admin-ui/src/lib/static/styles/global/_utilities.scss b/packages/admin-ui/src/lib/static/styles/global/_utilities.scss
index eb7330fdee..8c072b2530 100644
--- a/packages/admin-ui/src/lib/static/styles/global/_utilities.scss
+++ b/packages/admin-ui/src/lib/static/styles/global/_utilities.scss
@@ -52,17 +52,17 @@ $spacings: (1, 2, 3, 4, 5, auto);
 $sides: (
     't': 'top',
     'b': 'bottom',
-    'l': 'left',
-    'r': 'right',
+    'l': 'inline-start',
+    'r': 'inline-end',
     '': (
         'top',
-        'left',
+        'inline-start',
         'bottom',
-        'right',
+        'inline-end',
     ),
     'x': (
-        'left',
-        'right',
+        'inline-start',
+        'inline-end',
     ),
     'y': (
         'top',

From 005a1a4c6f691633b5aeb11d9b048cc1ae7b8664 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Tue, 17 Oct 2023 16:15:52 +0200
Subject: [PATCH 18/49] chore(admin-ui): Tidy up unused code

---
 .../src/lib/catalog/src/catalog.module.ts     | 34 ++-----------------
 1 file changed, 3 insertions(+), 31 deletions(-)

diff --git a/packages/admin-ui/src/lib/catalog/src/catalog.module.ts b/packages/admin-ui/src/lib/catalog/src/catalog.module.ts
index eb39d6ef01..bb92ca351f 100644
--- a/packages/admin-ui/src/lib/catalog/src/catalog.module.ts
+++ b/packages/admin-ui/src/lib/catalog/src/catalog.module.ts
@@ -9,7 +9,6 @@ import {
     GetFacetDetailDocument,
     GetProductDetailDocument,
     GetProductVariantDetailDocument,
-    GetStockLocationDetailDocument,
     PageService,
     SharedModule,
 } from '@vendure/admin-ui/core';
@@ -57,12 +56,12 @@ import {
 import { ProductListComponent } from './components/product-list/product-list.component';
 import { ProductOptionsEditorComponent } from './components/product-options-editor/product-options-editor.component';
 import { ProductVariantDetailComponent } from './components/product-variant-detail/product-variant-detail.component';
-import { ProductVariantListComponent } from './components/product-variant-list/product-variant-list.component';
 import {
     assignProductVariantsToChannelBulkAction,
-    removeProductVariantsFromChannelBulkAction,
     deleteProductVariantsBulkAction,
+    removeProductVariantsFromChannelBulkAction,
 } from './components/product-variant-list/product-variant-list-bulk-actions';
+import { ProductVariantListComponent } from './components/product-variant-list/product-variant-list.component';
 import { ProductVariantQuickJumpComponent } from './components/product-variant-quick-jump/product-variant-quick-jump.component';
 import { ProductVariantsEditorComponent } from './components/product-variants-editor/product-variants-editor.component';
 import { ProductVariantsTableComponent } from './components/product-variants-table/product-variants-table.component';
@@ -118,10 +117,7 @@ const CATALOG_COMPONENTS = [
     ],
 })
 export class CatalogModule {
-    constructor(
-        private bulkActionRegistryService: BulkActionRegistryService,
-        private pageService: PageService,
-    ) {
+    constructor(bulkActionRegistryService: BulkActionRegistryService, pageService: PageService) {
         bulkActionRegistryService.registerBulkAction(assignFacetValuesToProductsBulkAction);
         bulkActionRegistryService.registerBulkAction(assignProductsToChannelBulkAction);
         bulkActionRegistryService.registerBulkAction(assignProductVariantsToChannelBulkAction);
@@ -170,30 +166,6 @@ export class CatalogModule {
             route: 'variants',
             component: ProductVariantListComponent,
         });
-        // pageService.registerPageTab({
-        //     priority: 0,
-        //     location: 'stock-location-detail',
-        //     tab: _('catalog.stock-location'),
-        //     route: '',
-        //     component: detailComponentWithResolver({
-        //         component: StockLocationDetailComponent,
-        //         query: GetStockLocationDetailDocument,
-        //         entityKey: 'stockLocation',
-        //         getBreadcrumbs: entity => [
-        //             {
-        //                 label: entity ? entity.name : _('catalog.create-new-stock-location'),
-        //                 link: [entity?.id],
-        //             },
-        //         ],
-        //     }),
-        // });
-        // pageService.registerPageTab({
-        //     priority: 0,
-        //     location: 'product-list',
-        //     tab: _('catalog.stock-locations'),
-        //     route: 'stock-locations',
-        //     component: StockLocationListComponent,
-        // });
         pageService.registerPageTab({
             priority: 0,
             location: 'product-variant-detail',

From d8989fc0ceb62a689557f0bd633d2968a88021d3 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Tue, 17 Oct 2023 16:37:29 +0200
Subject: [PATCH 19/49] test(core): Fix failing e2e test

---
 .../e2e/custom-field-relations.e2e-spec.ts    | 34 ++++++-------------
 1 file changed, 10 insertions(+), 24 deletions(-)

diff --git a/packages/core/e2e/custom-field-relations.e2e-spec.ts b/packages/core/e2e/custom-field-relations.e2e-spec.ts
index 8057315516..7263ddaec5 100644
--- a/packages/core/e2e/custom-field-relations.e2e-spec.ts
+++ b/packages/core/e2e/custom-field-relations.e2e-spec.ts
@@ -292,6 +292,7 @@ describe('Custom field relations', () => {
             const { collections } = await adminClient.query(gql`
                 query {
                     collections(options: { sort: { name: DESC } }) {
+                        totalItems
                         items {
                             id
                             name
@@ -306,32 +307,17 @@ describe('Custom field relations', () => {
                 }
             `);
 
-            expect(collections.items).toEqual([
-                {
-                    customFields: {
-                        campaign: null,
-                    },
-                    id: 'T_2',
-                    name: 'parent collection',
-                },
-                {
-                    customFields: {
-                        campaign: {
-                            languageCode: 'en',
-                            name: 'Clearance Up to 70% Off frames',
-                        },
+            expect(collections.totalItems).toBe(3);
+            expect(collections.items.find((c: any) => c.id === 'T_3')).toEqual({
+                customFields: {
+                    campaign: {
+                        languageCode: 'en',
+                        name: 'Clearance Up to 70% Off frames',
                     },
-                    id: 'T_3',
-                    name: 'children collection',
                 },
-                {
-                    customFields: {
-                        campaign: null,
-                    },
-                    id: 'T_4',
-                    name: 'Plants',
-                },
-            ]);
+                id: 'T_3',
+                name: 'children collection',
+            });
         });
 
         it('ProductVariant prices get resolved', async () => {

From 02fe6ae88d2bef2cf69f62b8eeb7ee9095e82640 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Tue, 17 Oct 2023 16:57:51 +0200
Subject: [PATCH 20/49] fix(admin-ui): Fix customer group select input

Fixes #2441
---
 .../customer-group-form-input.component.ts          | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/packages/admin-ui/src/lib/core/src/shared/dynamic-form-inputs/customer-group-form-input/customer-group-form-input.component.ts b/packages/admin-ui/src/lib/core/src/shared/dynamic-form-inputs/customer-group-form-input/customer-group-form-input.component.ts
index df8ab3fa39..f30afa2939 100644
--- a/packages/admin-ui/src/lib/core/src/shared/dynamic-form-inputs/customer-group-form-input/customer-group-form-input.component.ts
+++ b/packages/admin-ui/src/lib/core/src/shared/dynamic-form-inputs/customer-group-form-input/customer-group-form-input.component.ts
@@ -1,5 +1,5 @@
 import { ChangeDetectionStrategy, Component, Input, OnInit } from '@angular/core';
-import { FormControl, UntypedFormControl } from '@angular/forms';
+import { FormControl } from '@angular/forms';
 import { DefaultFormComponentConfig, DefaultFormComponentId } from '@vendure/common/lib/shared-types';
 import { Observable } from 'rxjs';
 import { startWith } from 'rxjs/operators';
@@ -42,13 +42,12 @@ export class CustomerGroupFormInputComponent implements FormInputComponent, OnIn
     }
 
     selectGroup(group: ItemOf<GetCustomerGroupsQuery, 'customerGroups'>) {
-        this.formControl.setValue(group ?? undefined);
+        this.formControl.setValue(group?.id ?? undefined);
     }
 
-    compareWith(
-        o1: ItemOf<GetCustomerGroupsQuery, 'customerGroups'>,
-        o2: ItemOf<GetCustomerGroupsQuery, 'customerGroups'>,
-    ) {
-        return o1.id === o2.id;
+    compareWith<T extends ItemOf<GetCustomerGroupsQuery, 'customerGroups'> | string>(o1: T, o2: T) {
+        const id1 = typeof o1 === 'string' ? o1 : o1.id;
+        const id2 = typeof o2 === 'string' ? o2 : o2.id;
+        return id1 === id2;
     }
 }

From 957d0ad665592ddffb01ae377fb16717794a0d84 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Tue, 17 Oct 2023 17:10:26 +0200
Subject: [PATCH 21/49] fix(core): Normalize email address on updating Customer

Fixes #2449
---
 packages/core/e2e/customer.e2e-spec.ts        | 37 +++++++++++++++++++
 packages/core/e2e/shop-auth.e2e-spec.ts       | 23 ++++++++++++
 .../src/service/services/customer.service.ts  | 16 +++++---
 3 files changed, 70 insertions(+), 6 deletions(-)

diff --git a/packages/core/e2e/customer.e2e-spec.ts b/packages/core/e2e/customer.e2e-spec.ts
index df78313bde..e1ff171ce9 100644
--- a/packages/core/e2e/customer.e2e-spec.ts
+++ b/packages/core/e2e/customer.e2e-spec.ts
@@ -525,6 +525,22 @@ describe('Customer resolver', () => {
             expect(createCustomer.message).toBe('The email address is not available.');
             expect(createCustomer.errorCode).toBe(ErrorCode.EMAIL_ADDRESS_CONFLICT_ERROR);
         });
+
+        it('normalizes email address on creation', async () => {
+            const { createCustomer } = await adminClient.query<
+                Codegen.CreateCustomerMutation,
+                Codegen.CreateCustomerMutationVariables
+            >(CREATE_CUSTOMER, {
+                input: {
+                    emailAddress: ' JoeSmith@test.com ',
+                    firstName: 'Joe',
+                    lastName: 'Smith',
+                },
+                password: 'test',
+            });
+            customerErrorGuard.assertSuccess(createCustomer);
+            expect(createCustomer.emailAddress).toBe('joesmith@test.com');
+        });
     });
 
     describe('update', () => {
@@ -566,6 +582,27 @@ describe('Customer resolver', () => {
 
             expect(me?.identifier).toBe('unique-email@test.com');
         });
+
+        // https://github.com/vendure-ecommerce/vendure/issues/2449
+        it('normalizes email address on update', async () => {
+            const { updateCustomer } = await adminClient.query<
+                Codegen.UpdateCustomerMutation,
+                Codegen.UpdateCustomerMutationVariables
+            >(UPDATE_CUSTOMER, {
+                input: {
+                    id: thirdCustomer.id,
+                    emailAddress: ' Another-Address@test.com ',
+                },
+            });
+            customerErrorGuard.assertSuccess(updateCustomer);
+
+            expect(updateCustomer.emailAddress).toBe('another-address@test.com');
+
+            await shopClient.asUserWithCredentials('another-address@test.com', 'test');
+            const { me } = await shopClient.query<Codegen.MeQuery>(ME);
+
+            expect(me?.identifier).toBe('another-address@test.com');
+        });
     });
 
     describe('deletion', () => {
diff --git a/packages/core/e2e/shop-auth.e2e-spec.ts b/packages/core/e2e/shop-auth.e2e-spec.ts
index 098f469656..c845e46cca 100644
--- a/packages/core/e2e/shop-auth.e2e-spec.ts
+++ b/packages/core/e2e/shop-auth.e2e-spec.ts
@@ -1263,6 +1263,29 @@ describe('Updating email address without email verification', () => {
         );
         expect(activeCustomer!.emailAddress).toBe(NEW_EMAIL_ADDRESS);
     });
+
+    it('normalizes updated email address', async () => {
+        await shopClient.asUserWithCredentials(NEW_EMAIL_ADDRESS, 'test');
+        const { requestUpdateCustomerEmailAddress } = await shopClient.query<
+            CodegenShop.RequestUpdateEmailAddressMutation,
+            CodegenShop.RequestUpdateEmailAddressMutationVariables
+        >(REQUEST_UPDATE_EMAIL_ADDRESS, {
+            password: 'test',
+            newEmailAddress: ' Not.Normal@test.com ',
+        });
+        successErrorGuard.assertSuccess(requestUpdateCustomerEmailAddress);
+        // Attempting to fix flakiness possibly caused by race condition on the event
+        // subscriber
+        await new Promise(resolve => setTimeout(resolve, 100));
+        expect(requestUpdateCustomerEmailAddress.success).toBe(true);
+        expect(sendEmailFn).toHaveBeenCalledTimes(1);
+        expect(sendEmailFn.mock.calls[0][0] instanceof IdentifierChangeEvent).toBe(true);
+
+        const { activeCustomer } = await shopClient.query<CodegenShop.GetActiveCustomerQuery>(
+            GET_ACTIVE_CUSTOMER,
+        );
+        expect(activeCustomer!.emailAddress).toBe('not.normal@test.com');
+    });
 });
 
 function getVerificationTokenPromise(): Promise<string> {
diff --git a/packages/core/src/service/services/customer.service.ts b/packages/core/src/service/services/customer.service.ts
index 2bffe9dec9..039166ef6f 100644
--- a/packages/core/src/service/services/customer.service.ts
+++ b/packages/core/src/service/services/customer.service.ts
@@ -308,13 +308,16 @@ export class CustomerService {
         });
 
         if (hasEmailAddress(input)) {
+            input.emailAddress = normalizeEmailAddress(input.emailAddress);
             if (input.emailAddress !== customer.emailAddress) {
                 const existingCustomerInChannel = await this.connection
                     .getRepository(ctx, Customer)
                     .createQueryBuilder('customer')
                     .leftJoin('customer.channels', 'channel')
                     .where('channel.id = :channelId', { channelId: ctx.channelId })
-                    .andWhere('customer.emailAddress = :emailAddress', { emailAddress: input.emailAddress })
+                    .andWhere('customer.emailAddress = :emailAddress', {
+                        emailAddress: input.emailAddress,
+                    })
                     .andWhere('customer.id != :customerId', { customerId: input.id })
                     .andWhere('customer.deletedAt is null')
                     .getOne();
@@ -566,6 +569,7 @@ export class CustomerService {
         userId: ID,
         newEmailAddress: string,
     ): Promise<boolean | EmailAddressConflictError> {
+        const normalizedEmailAddress = normalizeEmailAddress(newEmailAddress);
         const userWithConflictingIdentifier = await this.userService.getUserByEmailAddress(
             ctx,
             newEmailAddress,
@@ -588,18 +592,18 @@ export class CustomerService {
             type: HistoryEntryType.CUSTOMER_EMAIL_UPDATE_REQUESTED,
             data: {
                 oldEmailAddress,
-                newEmailAddress,
+                newEmailAddress: normalizedEmailAddress,
             },
         });
         if (this.configService.authOptions.requireVerification) {
-            user.getNativeAuthenticationMethod().pendingIdentifier = newEmailAddress;
+            user.getNativeAuthenticationMethod().pendingIdentifier = normalizedEmailAddress;
             await this.userService.setIdentifierChangeToken(ctx, user);
             this.eventBus.publish(new IdentifierChangeRequestEvent(ctx, user));
             return true;
         } else {
             const oldIdentifier = user.identifier;
-            user.identifier = newEmailAddress;
-            customer.emailAddress = newEmailAddress;
+            user.identifier = normalizedEmailAddress;
+            customer.emailAddress = normalizedEmailAddress;
             await this.connection.getRepository(ctx, User).save(user, { reload: false });
             await this.connection.getRepository(ctx, Customer).save(customer, { reload: false });
             this.eventBus.publish(new IdentifierChangeEvent(ctx, user, oldIdentifier));
@@ -609,7 +613,7 @@ export class CustomerService {
                 type: HistoryEntryType.CUSTOMER_EMAIL_UPDATE_VERIFIED,
                 data: {
                     oldEmailAddress,
-                    newEmailAddress,
+                    newEmailAddress: normalizedEmailAddress,
                 },
             });
             return true;

From 4035fdaf2abf0f987f1d8b551e0003505d3371b2 Mon Sep 17 00:00:00 2001
From: Beep Love <biplabkarki04@gmail.com>
Date: Wed, 18 Oct 2023 12:21:02 +0545
Subject: [PATCH 22/49] fix(admin-ui): Improvements to Nepali translation
 (#2463)

---
 packages/admin-ui/i18n-coverage.json          |  10 +-
 .../src/lib/static/i18n-messages/ne.json      | 200 +++++++++---------
 2 files changed, 108 insertions(+), 102 deletions(-)

diff --git a/packages/admin-ui/i18n-coverage.json b/packages/admin-ui/i18n-coverage.json
index e67e57c87e..b3884e559e 100644
--- a/packages/admin-ui/i18n-coverage.json
+++ b/packages/admin-ui/i18n-coverage.json
@@ -1,6 +1,7 @@
 {
-  "generatedOn": "2023-10-02T08:18:19.015Z",
-  "lastCommit": "e92e8207cb0296964e779bc81f731a035ec76768",
+  "generatedOn": "2023-10-17T19:32:07.745Z",
+  "lastCommit": "97bc099006adda7449a7b63e72191c2bb7e7b4ed",
+
   "translationStatus": {
     "ar": {
       "tokenCount": 761,
@@ -47,6 +48,11 @@
       "translatedCount": 760,
       "percentage": 100
     },
+    "ne": {
+      "tokenCount": 761,
+      "translatedCount": 725,
+      "percentage": 95
+    },
     "pl": {
       "tokenCount": 761,
       "translatedCount": 400,
diff --git a/packages/admin-ui/src/lib/static/i18n-messages/ne.json b/packages/admin-ui/src/lib/static/i18n-messages/ne.json
index 0824fb6d85..c9ef969d9f 100644
--- a/packages/admin-ui/src/lib/static/i18n-messages/ne.json
+++ b/packages/admin-ui/src/lib/static/i18n-messages/ne.json
@@ -28,26 +28,26 @@
     "administrators": "प्रशासकहरू",
     "assets": "फाइलहरू",
     "channels": "च्यानलहरू",
-    "collections": "संग्रहहरू",
+    "collections": "",
     "countries": "देशहरू",
     "customer-groups": "ग्राहक समूहहरू",
     "customers": "ग्राहकहरू",
     "dashboard": "ड्यासबोर्ड",
-    "facets": "पहिचानहरू",
+    "facets": "गुणस्तरहरू",
     "global-settings": "वैश्विक सेटिङहरू",
     "job-queue": "काम कत्ति",
     "manage-variants": "विविध विकल्पहरू प्रबन्ध गर्नुहोस्",
     "modifying": "परिमार्जन",
-    "orders": "आदेशहरू",
+    "orders": "ओर्दरहरु",
     "payment-methods": "भुक्तानी विधिहरू",
     "product-options": "समान विकल्पहरू",
     "products": "उत्पादनहरू",
     "profile": "प्रोफाइल",
     "promotions": "प्रमोशनहरू",
     "roles": "भूमिकाहरू",
-    "seller-orders": "बेच्ने आदेशहरू",
-    "sellers": "बेच्ने गर्ने व्यक्तिहरू",
-    "shipping-methods": "माल गर्ने तरिकाहरू",
+    "seller-orders": "विक्रेता ओर्दरहरु",
+    "sellers": "विक्रेता व्यक्तिहरू",
+    "shipping-methods": "ढुवानी गर्ने तरिकाहरू",
     "stock-locations": "स्टक स्थानहरू",
     "system-status": "प्रणालीको स्थिति",
     "tax-categories": "कर श्रेणिहरू",
@@ -64,37 +64,37 @@
     "asset": "संपत्ति",
     "asset-preview-links": "संपत्ति पूर्वावलोकन लिङ्कहरू",
     "assets": "फाइलहरू",
-    "assign-product-to-channel-success": "{count, plural, one {1 उत्पाद} other {{count} उत्पादहरू}} लाई { channel } मा सफलतापूर्वक लगाइएको",
-    "assign-products-to-channel": "उत्पादहरूलाई च्यानलमा लगाउनुहोस्",
+    "assign-product-to-channel-success": "{count, plural, one {1 समान} other {{count} समानहरू}} लाई { channel } मा सफलतापूर्वक लगाइएको",
+    "assign-products-to-channel": "समानहरूलाई च्यानलमा लगाउनुहोस्",
     "assign-to-channel": "च्यानलमा लगाउनुहोस्",
     "assign-to-named-channel": "{ channelCode } मा लगाउनुहोस्",
-    "assign-variant-to-channel-success": "{count, plural, one {1 उत्पाद विविधता} other {{count} उत्पाद विविधताहरू}} लाई { channel } मा सफलतापूर्वक लगाइएको",
-    "assign-variants-to-channel": "उत्पाद विविधताहरूलाई च्यानलमा लगाउनुहोस्",
+    "assign-variant-to-channel-success": "{count, plural, one {1 समान विविधता} other {{count} समान विविधताहरू}} लाई { channel } मा सफलतापूर्वक लगाइएको",
+    "assign-variants-to-channel": "समान विविधताहरूलाई च्यानलमा लगाउनुहोस्",
     "auto-update-option-variant-name": "विकल्प परिविकल्पको नाम आफ्नो आपदेट गर्नका लागि स्वचालित गर्नुहोस्",
-    "auto-update-product-variant-name": "उत्पाद विविधताका नाम आफ्नो आपदेट गर्नका लागि स्वचालित गर्नुहोस्",
-    "cannot-create-variants-without-options": "कम्ति दुई उत्पाद विकल्पसम्म विकल्प संग समावेश गरिएको पर्याप्त छेनपछि उत्पाद विविधता सिर्जना गर्न सकिदैन",
+    "auto-update-product-variant-name": "समान विविधताका नाम आफ्नो आपदेट गर्नका लागि स्वचालित गर्नुहोस्",
+    "cannot-create-variants-without-options": "कम्ति दुई समान विकल्पसम्म विकल्प संग समावेश गरिएको पर्याप्त छेनपछि समान विविधता सिर्जना गर्न सकिदैन",
     "channel-price-preview": "च्यानल मूल्य पूर्वावलोकन",
-    "collection": "संग्रह",
-    "collection-contents": "संग्रह सामग्रीहरू",
-    "collections": "संग्रहहरू",
-    "confirm-bulk-delete-products": "{count} उत्पादहरू मेटाउनुहोस्?",
+    "collection": "",
+    "collection-contents": "",
+    "collections": "",
+    "confirm-bulk-delete-products": "{count} समानहरू मेटाउनुहोस्?",
     "confirm-cancel": "रद्द गर्नुहोस्?",
     "confirm-delete-assets": "{count} {count, plural, one {संपत्ति} other {संपत्तिहरू}} मेटाउनुहोस्?",
-    "confirm-delete-facet-value": "मूल्य मेटाउनुहोस्?",
-    "confirm-delete-product": "उत्पाद मेटाउनुहोस्?",
-    "confirm-delete-product-option": "उत्पाद विकल्प \"{name}\" मेटाउनुहोस्?",
-    "confirm-delete-product-option-group": "उत्पाद विकल्प समूह \"{name}\" मेटाउनुहोस्?",
+    "confirm-delete-facet-value": "गुणस्तर मूल्य मेटाउनुहोस्?",
+    "confirm-delete-product": "समान मेटाउनुहोस्?",
+    "confirm-delete-product-option": "समान विकल्प \"{name}\" मेटाउनुहोस्?",
+    "confirm-delete-product-option-group": "समान विकल्प समूह \"{name}\" मेटाउनुहोस्?",
     "confirm-delete-product-option-group-body": "यस विकल्प समूहलाई {count} {count, plural, one {विविधता} other {विविधताहरू}} द्वारा प्रयोग गरिएको छ। के तपाईं यसलाई मेटाउन चाहनुहुन्छ?",
-    "confirm-delete-product-variant": "उत्पाद विविधता \"{name}\" मेटाउनुहोस्?",
-    "confirm-deletion-of-unused-variants-body": "नयाँ विकल्पहरू थप्दा पुरानो उत्पाद विविधताहरूमा प्रयुक्त भएको कारण पुरानो उत्पाद विविधताहरू मेटाइनेछन्।",
-    "confirm-deletion-of-unused-variants-title": "अपयोगित उत्पाद विविधताहरू मेटाउनुहोस्?",
-    "create-draft-order": "मस्यौदा आदेश सिर्जना गर्नुहोस्",
-    "create-new-collection": "नयाँ संग्रह सिर्जना गर्नुहोस्",
+    "confirm-delete-product-variant": "समान विविधता \"{name}\" मेटाउनुहोस्?",
+    "confirm-deletion-of-unused-variants-body": "नयाँ विकल्पहरू थप्दा पुरानो समान विविधताहरूमा प्रयुक्त भएको कारण पुरानो समान विविधताहरू मेटाइनेछन्।",
+    "confirm-deletion-of-unused-variants-title": "अपयोगित समान विविधताहरू मेटाउनुहोस्?",
+    "create-draft-order": "मस्यौदा ओर्दर सिर्जना गर्नुहोस्",
+    "create-new-collection": "",
     "create-new-facet": "नयाँ मूल्य सिर्जना गर्नुहोस्",
-    "create-new-product": "नयाँ उत्पाद",
+    "create-new-product": "नयाँ समान",
     "create-new-stock-location": "नयाँ स्टक स्थान सिर्जना गर्नुहोस्",
-    "create-product-option-group": "उत्पाद विकल्प समूह सिर्जना गर्नुहोस्",
-    "create-product-variant": "उत्पाद विविधता सिर्जना गर्नुहोस्",
+    "create-product-option-group": "समान विकल्प समूह सिर्जना गर्नुहोस्",
+    "create-product-variant": "समान विविधता सिर्जना गर्नुहोस्",
     "default-currency": "पूर्वनिर्धारित मुद्रा",
     "do-not-inherit-filters": "फिल्टरहरू समावेश गर्न नगर्नुहोस्",
     "drop-files-to-upload": "अपलोड गर्नका लागि फाइलहरू टाँच्नुहोस्",
@@ -111,9 +111,9 @@
     "inherit-filters-from-parent": "उत्तराधिकारीबाट फिल्टरहरू समावेश गर्नुहोस्",
     "live-preview-contents": "सामग्री लाइभ पूर्वावलोकन",
     "manage-variants": "विविधताहरू प्रबन्धन गर्नुहोस्",
-    "move-collection-to": "{ name } मा सार्नुहोस्",
-    "move-collections": "संग्रहहरू सार्नुहोस्",
-    "move-collections-success": "{count, plural, one {1 संग्रह} other {{count} संग्रहहरू}} सारियो",
+    "move-collection-to": "",
+    "move-collections": "",
+    "move-collections-success": "",
     "move-down": "तल सार्नुहोस्",
     "move-to": "यहाँ सार्नुहोस्",
     "move-up": "माथि सार्नुहोस्",
@@ -143,7 +143,7 @@
     "price-with-tax-in-default-zone": "संलग्न गर्दछ {rate}% कर: {price}",
     "private": "गोप्य",
     "product": "समान",
-    "product-name": "समान नाम",
+    "product-name": "समानको नाम",
     "product-options": "समान विकल्पहरू",
     "product-variant-exists": "यस विकल्पसहितको समान वेरिएन्ट पहिले नै छ",
     "product-variants": "समान वेरिएन्टहरू",
@@ -158,16 +158,16 @@
     "remove-option": "विकल्प हटाउनुहोस्",
     "remove-product-from-channel": "च्यानलबाट समान हटाउनुहोस्",
     "remove-product-variant-from-channel": "च्यानलबाट समान वेरिएन्ट हटाउनुहोस्",
-    "reorder-collection": "संग्रह पुनः क्रममा ल्याउनुहोस्",
-    "root-collection": "मूल संग्रह",
+    "reorder-collection": "",
+    "root-collection": "",
     "run-pending-search-index-updates": "खोज सूची: चलाउँदै छ {count, plural, one {1 पेन्डिङ अपडेट} other {{count} पेन्डिङ अपडेटहरू}}",
     "running-search-index-updates": "चलाउँदै छ {count, plural, one {1 अपडेट} other {{count} अपडेटहरू}} खोज सूचीमा",
     "search-asset-name-or-tag": "संपत्ति नाम वा ट्यागका लागि खोज्नुहोस्",
     "search-for-term": "मात्रकको लागि खोज्नुहोस्",
-    "search-product-name-or-code": "समान नाम वा कोडका लागि खोज्नुहोस्",
+    "search-product-name-or-code": "समानको नाम वा कोडका लागि खोज्नुहोस्",
     "select-product": "समान छनोट गर्नुहोस्",
     "select-product-variant": "समान वेरिएन्ट छनोट गर्नुहोस्",
-    "sku": "एसक्यू",
+    "sku": "SKU",
     "slug": "स्लग",
     "slug-pattern-error": "स्लग अमान्य छ",
     "stock-allocated": "स्टक प्रियापित",
@@ -191,7 +191,7 @@
     "visibility": "दृश्यता"
   },
   "common": {
-    "ID": "पहिचान",
+    "ID": "गुणस्तर",
     "add-filter": "फिल्टर थप्नुहोस्",
     "add-item-to-list": "सूचीमा वस्त्र थप्नुहोस्",
     "add-note": "नोट थप्नुहोस्",
@@ -215,8 +215,8 @@
     "collapse-entries": "प्रवेशहरू ढिलो गर्नुहोस्",
     "confirm": "पुष्टि गर्नुहोस्",
     "confirm-bulk-assign-to-channel": "केहि चयन च्यानलमा खस्यौँ गर्ने?",
-    "confirm-bulk-delete": "चयन गरिएका वस्तुहरूलाई हटाउने?",
-    "confirm-bulk-remove-from-channel": "चयन गरिएका वस्तुहरूलाई वर्तमान च्यानलबाट हटाउने?",
+    "confirm-bulk-delete": "चयन गरिएका समानहरूलाई हटाउने?",
+    "confirm-bulk-remove-from-channel": "चयन गरिएका समानहरूलाई वर्तमान च्यानलबाट हटाउने?",
     "confirm-delete-note": "नोट हटाउने?",
     "confirm-navigation": "नेभिगेसन पुष्टि गर्नुहोस्",
     "contents": "सामग्री",
@@ -247,14 +247,14 @@
     "force-remove": "बल पुर्वप्रक्षिप्त गर्नुहोस्",
     "general": "सामान्य",
     "guest": "अतिथि",
-    "id": "पहिचान",
+    "id": "गुणस्तर",
     "image": "प्रतिमा",
     "items-per-page-option": "{ पृष्ठमा गर्ने } प्रति पृष्ठ",
-    "items-selected-count": "{ परिमाण } {count, plural, one {वस्तु} other {वस्तुहरू}} चयन गरिएको",
+    "items-selected-count": "{ परिमाण } {count, plural, one {समान} other {समानहरू}} चयन गरिएको",
     "keep-editing": "सम्पादन जारी राख्नुहोस्",
     "language": "भाषा",
     "launch-extension": "एक्सटेन्सन प्रारम्भ गर्नुहोस्",
-    "list-items-and-n-more": "{ वस्तुहरू } र {nMore} थप",
+    "list-items-and-n-more": "{ समानहरू } र {nMore} थप",
     "live-update": "लाइभ अपडेट",
     "locale": "स्थान",
     "log-out": "बाहिर जानुहोस्",
@@ -271,14 +271,14 @@
     "no-results": "कुनै परिणाम छैन",
     "not-applicable": "लागू छैन",
     "not-set": "सेट गरिएको छैन",
-    "notify-assign-to-channel-success-with-count": "{ गणना } {count, plural, one {वस्तु} other {वस्तुहरू}} { channelCode } मा सफलतापूर्वक कुनै पनि दिएको छ",
+    "notify-assign-to-channel-success-with-count": "{ गणना } {count, plural, one {समान} other {समानहरू}} { channelCode } मा सफलतापूर्वक कुनै पनि दिएको छ",
     "notify-bulk-update-success": "सफलतापूर्वक { count } { entity } परिमाण",
     "notify-create-error": "त्रुटि देखा पर्‍यो, { entity } सिर्जना गर्न असमर्थ",
     "notify-create-success": "{ entity } नयाँ सिर्जना गरियो",
     "notify-delete-error": "त्रुटि देखा पर्‍यो, { entity } मेटाउन असमर्थ",
-    "notify-delete-error-with-count": "{count, plural, one {1 वस्तु} other {{count} वस्तुहरू}} मेटाउन असमर्थ",
+    "notify-delete-error-with-count": "{count, plural, one {1 समान} other {{count} समानहरू}} मेटाउन असमर्थ",
     "notify-delete-success": "{ entity } मेटाइयो",
-    "notify-delete-success-with-count": "{count, plural, one {1 वस्तु} other {{count} वस्तुहरू}} सफलतापूर्वक मेटाइयो",
+    "notify-delete-success-with-count": "{count, plural, one {1 समान} other {{count} समानहरू}} सफलतापूर्वक मेटाइयो",
     "notify-remove-from-channel-success-with-count": "{ count } च्यानलबाट सफलतापूर्वक हटाइयो",
     "notify-save-changes-error": "त्रुटि देखा पर्‍यो, परिवर्तनहरू संरक्षण गर्न असमर्थ",
     "notify-saved-changes": "परिवर्तनहरू संरक्षित गरियो",
@@ -313,8 +313,8 @@
     "search-by-name": "नाम द्वारा खोज्नुहोस्",
     "select": "चयन गर्नुहोस्...",
     "select-display-language": "प्रदर्शन भाषा चयन गर्नुहोस्",
-    "select-items-with-count": "{ count } {count, plural, one {वस्तु} other {वस्तुहरू}} चयन गर्नुहोस्",
-    "select-products": "उत्पादन चयन गर्नुहोस्",
+    "select-items-with-count": "{ count } {count, plural, one {समान} other {समानहरू}} चयन गर्नुहोस्",
+    "select-products": "समानन चयन गर्नुहोस्",
     "select-relation-id": "सम्बन्ध आइडी चयन गर्नुहोस्",
     "select-table-columns": "तालिका स्तंभ चयन गर्नुहोस्",
     "select-today": "आज चयन गर्नुहोस्",
@@ -504,7 +504,7 @@
     "assets": "फाइलहरू",
     "catalog": "क्याटलग",
     "channels": "च्यानलहरू",
-    "collections": "संग्रहहरू",
+    "collections": "",
     "countries": "देशहरू",
     "customer-groups": "ग्राहक समूहहरू",
     "customers": "ग्राहकहरू",
@@ -512,7 +512,7 @@
     "global-settings": "वैश्विक सेटिङ्ग्स",
     "job-queue": "काम कतार",
     "marketing": "मार्केटिङ्ग",
-    "orders": "आदेशहरू",
+    "orders": "ओर्दरहरु",
     "payment-methods": "भुक्तानी गर्ने तरिकाहरू",
     "products": "उत्पादनहरू",
     "promotions": "प्रमोशनहरू",
@@ -520,7 +520,7 @@
     "sales": "बिक्री",
     "sellers": "बेच्नेहरू",
     "settings": "सेटिङ्ग्स",
-    "shipping-methods": "पारिश्रमिक तरिकाहरू",
+    "shipping-methods": "ढुवानी तरिकाहरू",
     "stock-locations": "स्टक स्थानहरू",
     "system": "प्रणाली",
     "system-status": "प्रणाली स्थिति",
@@ -529,28 +529,28 @@
     "zones": "क्षेत्रहरू"
   },
   "order": {
-    "add-item-to-order": "आदेशमा वस्तु थप्नुहोस्",
+    "add-item-to-order": "ओर्दरमा समान थप्नुहोस्",
     "add-note": "टिप्पणी थप्नुहोस्",
     "add-payment": "भुक्तानी थप्नुहोस्",
-    "add-payment-to-order": "आदेशमा भुक्तानी थप्नुहोस्",
-    "add-payment-to-order-success": "आदेशमा भुक्तानी सफलतापूर्वक थपियो",
+    "add-payment-to-order": "ओर्दरमा भुक्तानी थप्नुहोस्",
+    "add-payment-to-order-success": "ओर्दरमा भुक्तानी सफलतापूर्वक थपियो",
     "add-surcharge": "सर्चार्ज थप्नुहोस्",
-    "added-items": "थपिएका वस्तुहरू",
+    "added-items": "थपिएका समानहरू",
     "amount": "रकम",
     "arrange-additional-payment": "अतिरिक्त भुक्तानी गर्नुहोस्",
     "billing-address": "बिलिङ ठेगाना",
     "cancel": "रद्द गर्नुहोस्",
-    "cancel-entire-order": "पूरा आदेश रद्द गर्नुहोस्",
+    "cancel-entire-order": "पूरा ओर्दर रद्द गर्नुहोस्",
     "cancel-fulfillment": "पूर्णाउण रद्द गर्नुहोस्",
     "cancel-modification": "संशोधन रद्द गर्नुहोस्",
-    "cancel-order": "आदेश वा वस्तुहरू रद्द गर्नुहोस्",
+    "cancel-order": "ओर्दर वा समानहरू रद्द गर्नुहोस्",
     "cancel-payment": "भुक्तानी रद्द गर्नुहोस्",
     "cancel-reason-customer-request": "ग्राहकको अनुरोध",
     "cancel-reason-not-available": "उपलब्ध छैन",
-    "cancel-selected-items": "चयन गरिएका वस्तुहरू रद्द गर्नुहोस्",
-    "cancel-specified-items": "निर्दिष्ट वस्तुहरू रद्द गर्नुहोस्",
+    "cancel-selected-items": "चयन गरिएका समानहरू रद्द गर्नुहोस्",
+    "cancel-specified-items": "निर्दिष्ट समानहरू रद्द गर्नुहोस्",
     "cancellation-reason": "रद्द गर्ने कारण",
-    "cancelled-order-success": "आदेश सफलतापूर्वक रद्द गरियो",
+    "cancelled-order-success": "ओर्दर सफलतापूर्वक रद्द गरियो",
     "complete-draft-order": "पूरा प्रारूप",
     "confirm-modifications": "संशोधनहरू पुष्टि गर्नुहोस्",
     "contents": "अनुकूलन",
@@ -558,7 +558,7 @@
     "create-fulfillment-success": "पूर्णाउण सफलतापूर्वक सिर्जना गरियो",
     "customer": "ग्राहक",
     "delete-draft-order": "प्रारूप रद्द गर्नुहोस्",
-    "draft-order": "प्रारूप आदेश",
+    "draft-order": "प्रारूप ओर्दर",
     "edit-billing-address": "बिलिङ ठेगाना सम्पादन गर्नुहोस्",
     "edit-shipping-address": "पारिश्रमिक ठेगाना सम्पादन गर्नुहोस्",
     "error-message": "त्रुटि संदेश",
@@ -566,7 +566,7 @@
     "existing-customer": "मौजूदा ग्राहक",
     "filter-is-active": "सक्रिय छ",
     "fulfill": "पूर्णाउनुहोस्",
-    "fulfill-order": "पूर्णाउण आदेश",
+    "fulfill-order": "पूर्णाउण ओर्दर",
     "fulfillment": "पूर्णाउण",
     "fulfillment-method": "पूर्णाउण तरिका",
     "history-coupon-code-applied": "कुपन कोड लागू गरियो",
@@ -575,22 +575,22 @@
     "history-fulfillment-delivered": "पूर्णाउण पुर्याइयो",
     "history-fulfillment-shipped": "पूर्णाउण पठाइयो",
     "history-fulfillment-transition": "पूर्णाउण यात्रा गर्दा {from} बाट {to} मा",
-    "history-items-cancelled": "{count} {count, plural, one {वस्तु} other {वस्तुहरू}} रद्द गरियो",
-    "history-order-cancelled": "आदेश रद्द गरियो",
-    "history-order-created": "आदेश सिर्जना गरियो",
-    "history-order-fulfilled": "आदेश पूर्ण भयो",
-    "history-order-modified": "आदेश संशोधन गरियो",
-    "history-order-transition": "आदेशको यात्रा गर्दा {from} बाट {to} मा",
+    "history-items-cancelled": "{count} {count, plural, one {समान} other {समानहरू}} रद्द गरियो",
+    "history-order-cancelled": "ओर्दर रद्द गरियो",
+    "history-order-created": "ओर्दर सिर्जना गरियो",
+    "history-order-fulfilled": "ओर्दर पूर्ण भयो",
+    "history-order-modified": "ओर्दर संशोधन गरियो",
+    "history-order-transition": "ओर्दरको यात्रा गर्दा {from} बाट {to} मा",
     "history-payment-settled": "भुक्तानी लिएको",
     "history-payment-transition": "भुक्तानी #{id} लाई {from} बाट {to} मा यात्रा गरियो",
     "history-refund-transition": "वापसी #{id} लाई {from} बाट {to} मा यात्रा गरियो",
-    "item-count": "{count} {count, plural, one {वस्तु} other {वस्तुहरू}}",
+    "item-count": "{count} {count, plural, one {समान} other {समानहरू}}",
     "line-fulfillment-all": "सबै लाएन पूर्ण भएको छ",
     "line-fulfillment-none": "कुनै पनि लाएन पूर्ण भएको छैन",
     "line-fulfillment-partial": "{count} मध्ये {total} लाएन पूर्ण भएको छ",
     "manually-transition-to-state": "हातमा यात्रा गर्नुहोस्...",
-    "manually-transition-to-state-message": "आदेश अझै अर्को स्थितिमा हातमा यात्रा गर्नुहोस्। कृपया ध्यान दिनुहोस् कि आदेश स्थितिहरूले केहि यात्रा रोक्ने नियमहरू अनुसरण गर्दछ जसले केहि यात्राहरूलाई रोक्दै गर्दछ।",
-    "modification-adding-items": "{count} {count, plural, one {वस्तु} other {वस्तुहरू}} थपिएको छ",
+    "manually-transition-to-state-message": "ओर्दर अझै अर्को स्थितिमा हातमा यात्रा गर्नुहोस्। कृपया ध्यान दिनुहोस् कि ओर्दर स्थितिहरूले केहि यात्रा रोक्ने नियमहरू अनुसरण गर्दछ जसले केहि यात्राहरूलाई रोक्दै गर्दछ।",
+    "modification-adding-items": "{count} {count, plural, one {समान} other {समानहरू}} थपिएको छ",
     "modification-adding-surcharges": "{count} {count, plural, one {सर्चार्ज} other {सर्चार्जहरू}} थपिएको छ",
     "modification-adjusting-lines": "{count} {count, plural, one {लाइन} other {लाइनहरू}} सम्पादन गरिएको छ",
     "modification-not-settled": "लिएको छैन",
@@ -600,22 +600,22 @@
     "modification-updating-billing-address": "बिलिङ ठेगाना अपडेट गरिएको छ",
     "modification-updating-shipping-address": "पारिश्रमिक ठेगाना अपडेट गरिएको छ",
     "modifications": "संशोधनहरू",
-    "modify-order": "आदेश संशोधन गर्नुहोस्",
+    "modify-order": "ओर्दर संशोधन गर्नुहोस्",
     "modify-order-price-difference": "मूल्य अन्तर",
     "net-price": "नेट मूल्य",
     "note": "टिप्पणी",
     "note-is-private": "टिप्पणी प्राइभेट छ",
     "note-only-visible-to-administrators": "मात्र प्रशासकहरूले मात्र हेर्न सक्छन्",
     "note-visible-to-customer": "प्रशासकहरू र ग्राहकहरूले हेर्न सक्छन्",
-    "order": "आदेश",
-    "order-history": "आदेश इतिहास",
-    "order-is-empty": "आदेश खाली छ",
-    "order-state-diagram": "आदेश स्थिति डायग्राम",
-    "order-type": "आदेश प्रकार",
+    "order": "ओर्दर",
+    "order-history": "ओर्दर इतिहास",
+    "order-is-empty": "ओर्दर खाली छ",
+    "order-state-diagram": "ओर्दर स्थिति डायग्राम",
+    "order-type": "ओर्दर प्रकार",
     "order-type-aggregate": "संचयन",
     "order-type-regular": "साधारण",
     "order-type-seller": "विक्रेता",
-    "orders": "आदेशहरू",
+    "orders": "ओर्दरहरु",
     "original-quantity-at-checkout": "चेकआउटमा मूल संख्या",
     "payment": "भुक्तानी",
     "payment-amount": "भुक्तानी रकम",
@@ -627,18 +627,18 @@
     "placed-at": "मा राखिएको",
     "preview-changes": "पूर्वावलोकन परिवर्तनहरू",
     "product-name": "समानको नाम",
-    "product-sku": "समानको एसक्यू",
+    "product-sku": "SKU",
     "promotions-applied": "प्रचारहरू लागू गरिएको",
     "prorated-unit-price": "प्राप्त मूल्य यूनिट मूल्य",
     "quantity": "मात्रा",
     "refund": "वापसी",
     "refund-adjustment": "सम्यक गर्दैछ",
-    "refund-and-cancel-order": "वापसी गर्दै र आदेश रद्द गर्दै",
+    "refund-and-cancel-order": "वापसी गर्दै र ओर्दर रद्द गर्दै",
     "refund-cancellation-reason": "वापसी/रद्द गर्दै कारण",
     "refund-cancellation-reason-required": "वापसी/रद्द गर्दै कारण आवश्यक छ",
     "refund-metadata": "वापसी मेटाडाटा",
-    "refund-order-failed": "आदेश वापसी गर्दा असफल भयो",
-    "refund-order-success": "आदेश सफलतापूर्वक वापसी गरियो",
+    "refund-order-failed": "ओर्दर वापसी गर्दा असफल भयो",
+    "refund-order-success": "ओर्दर सफलतापूर्वक वापसी गरियो",
     "refund-reason": "वापसी कारण",
     "refund-reason-customer-request": "ग्राहकको अनुरोध",
     "refund-reason-not-available": "उपलब्ध छैन",
@@ -647,19 +647,19 @@
     "refund-total-error": "कुल वापसी {min} र {max} को बीचमा हुनुपर्छ",
     "refund-total-warning": "कुल वापसी चयन गरिएको भुक्तानी रकमलाई माथि पुर्याइएको छैन। अरू भुक्तानीहरूबाट बाँकी वापसी रकम वापसी गरिनेछ।",
     "refund-with-amount": "{amount} वापसी गर्नुहोस्",
-    "refunded-count": "{count} {count, plural, one {वस्तु} other {वस्तुहरू}} वापसी गरियो",
-    "removed-items": "हटाइएका वस्तुहरू",
+    "refunded-count": "{count} {count, plural, one {समान} other {समानहरू}} वापसी गरियो",
+    "removed-items": "हटाइएका समानहरू",
     "search-by-order-filters": "नाम / कोड / लेखा निम्ति खोज्नुहोस्",
     "select-address": "ठेगाना चयन गर्नुहोस्",
-    "select-shipping-method": "पारिश्रमिक तरिका चयन गर्नुहोस्",
+    "select-shipping-method": "ढुवानी तरिका चयन गर्नुहोस्",
     "select-state": "स्थिति चयन गर्नुहोस्",
-    "seller-orders": "विक्रेता आदेशहरू",
+    "seller-orders": "विक्रेता ओर्दरहरु",
     "set-billing-address": "बिलिङ ठेगाना सेट गर्नुहोस्",
     "set-coupon-codes": "कुपन कोड सेट गर्नुहोस्",
     "set-customer-for-order": "ग्राहक सेट गर्नुहोस्",
     "set-fulfillment-state": "{state} मा चिन्ह गर्नुहोस्",
-    "set-shipping-address": "पारिश्रमिक ठेगाना सेट गर्नुहोस्",
-    "set-shipping-method": "पारिश्रमिक तरिका सेट गर्नुहोस्",
+    "set-shipping-address": "ढुवानी ठेगाना सेट गर्नुहोस्",
+    "set-shipping-method": "ढुवानी तरिका सेट गर्नुहोस्",
     "settle-payment": "भुक्तानी गर्नुहोस्",
     "settle-payment-error": "भुक्तानी सफल गर्न सकिएन",
     "settle-payment-success": "भुक्तानी सफलतापूर्वक सेटल गरियो",
@@ -667,9 +667,9 @@
     "settle-refund-manual-instructions": "तपाईंको भुक्तान प्रदान गर्दा मान्य भएको छ, तलका मा अर्को भुक्तान कोडहरू छन् ({method}), यहाँ व्यक्त गर्नुहोस्।",
     "settle-refund-success": "वापसी सफलतापूर्वक सेटल गरियो",
     "shipping": "पारिश्रमिक",
-    "shipping-address": "पारिश्रमिक ठेगाना",
-    "shipping-cancelled": "पारिश्रमिक रद्द गरियो",
-    "shipping-method": "पारिश्रमिक तरिका",
+    "shipping-address": "ढुवानी ठेगाना",
+    "shipping-cancelled": "ढुवानी रद्द गरियो",
+    "shipping-method": "ढुवानी तरिका",
     "state": "स्थिति",
     "sub-total": "उपकुल",
     "successfully-updated-fulfillment": "पूर्णाउण सफलतापूर्वक अपडेट गरियो",
@@ -685,14 +685,14 @@
     "transition-to-state": "{ state } स्थिति मा यात्रा गर्नुहोस्",
     "transitioned-payment-to-state-success": "{ state } मा भुक्तानी सफलतापूर्वक यात्रा गरियो",
     "transitioned-to-state-success": "{ state } मा सफलतापूर्वक यात्रा गरियो",
-    "unable-to-transition-to-state-try-another": "आदेशलाई फर्का \"{state}\" स्थितिमा यात्रा गर्न सकिएन। कृपया अन्य एक विकल्प चयन गर्नुहोस्।",
+    "unable-to-transition-to-state-try-another": "ओर्दरलाई फर्का \"{state}\" स्थितिमा यात्रा गर्न सकिएन। कृपया अन्य एक विकल्प चयन गर्नुहोस्।",
     "unfulfilled": "पूर्ण नहुने",
     "unit-price": "यूनिट मूल्य"
   },
   "settings": {
     "add-countries-to-zone": "देशहरू थप्नुहोस् { zoneName } मा",
     "add-countries-to-zone-success": "थपिएको छ { countryCount } {countryCount, plural, one {देश} other {देशहरू}} मा \"{ zoneName }\" जोनमा",
-    "add-products-to-test-order": "परीक्षण आदेशमा समानन थप्नुहोस्",
+    "add-products-to-test-order": "परीक्षण ओर्दरमा समानन थप्नुहोस्",
     "administrator": "प्रशासक",
     "channel": "स्रोत",
     "channel-token": "स्रोत टोकन",
@@ -702,7 +702,7 @@
     "create-new-payment-method": "नयाँ भुक्तानी तरिका बनाउनुहोस्",
     "create-new-role": "नयाँ भूमिका बनाउनुहोस्",
     "create-new-seller": "नयाँ विक्रेता बनाउनुहोस्",
-    "create-new-shipping-method": "नयाँ पारिश्रमिक तरिका बनाउनुहोस्",
+    "create-new-shipping-method": "नयाँ ढुवानी तरिका बनाउनुहोस्",
     "create-new-tax-category": "कर श्रेणी बनाउनुहोस्",
     "create-new-tax-rate": "नयाँ कर दर बनाउनुहोस्",
     "create-new-zone": "नयाँ जोन बनाउनुहोस्",
@@ -713,14 +713,14 @@
     "defaults": "पूर्वनिर्धारित",
     "eligible": "योग्य",
     "email-address": "ईमेल ठेगाना",
-    "email-address-or-identifier": "ईमेल ठेगाना वा पहिचानकर्ता",
+    "email-address-or-identifier": "ईमेल ठेगाना वा गुणस्तरकर्ता",
     "first-name": "पहिलो नाम",
     "fulfillment-handler": "पूर्णाउण प्राप्त गर्ने व्यक्ति",
     "global-available-languages-tooltip": "सबै स्रोतका लागि उपलब्ध गराइएको भाषाहरू सेट गर्दछ। व्यक्तिगत स्रोतहरू तपाईंको विशिष्ट भाषा समर्थन गर्दछन्।",
     "global-out-of-stock-threshold": "वैशिष्ट्यिक अप्राप्य गरिएको स्टक स्तर",
     "global-out-of-stock-threshold-tooltip": "यसले यस एक वैशिष्ट्यिक भरिएको स्टक स्तरमा रहेको छ जसले यस विशेष भरिएको छलैन्छ। नकारात्मक मूल्य प्रतिक्षिप्त बनाउँदछ। समान विशेष द्वारा अद्यायित गर्न सकिन्छ।",
     "last-name": "थर",
-    "no-eligible-shipping-methods": "कुनै पनि योग्य पारिश्रमिक तरिका छैन",
+    "no-eligible-shipping-methods": "कुनै पनि योग्य ढुवानी तरिका छैन",
     "password": "पासवर्ड",
     "payment-eligibility-checker": "भुक्तानी योग्यता चेकर",
     "payment-handler": "भुक्तानी ह्यान्डलर",
@@ -733,23 +733,23 @@
     "remove-from-zone": "जोनबाट हटाउनुहोस्",
     "role": "भूमिका",
     "roles": "भूमिकाहरू",
-    "search-by-product-name-or-sku": "समानको नाम वा एसक्यू द्वारा खोज्नुहोस्",
+    "search-by-product-name-or-sku": "समानको नाम वा SKU द्वारा खोज्नुहोस्",
     "seller": "विक्रेता",
     "shipping-calculator": "पारिश्रमिक क्याल्कुलेटर",
     "shipping-eligibility-checker": "पारिश्रमिक योग्यता चेकर",
-    "shipping-method": "पारिश्रमिक तरिका",
+    "shipping-method": "ढुवानी तरिका",
     "tax-category": "कर श्रेणी",
     "tax-rate": "कर दर",
     "test-address": "परीक्षण ठेगाना",
     "test-result": "परीक्षण परिणाम",
-    "test-shipping-method": "परीक्षण पारिश्रमिक तरिका",
-    "test-shipping-methods": "परीक्षण पारिश्रमिक तरिकाहरू",
+    "test-shipping-method": "परीक्षण ढुवानी तरिका",
+    "test-shipping-methods": "परीक्षण ढुवानी तरिकाहरू",
     "track-inventory-default": "पूर्वनिर्धारित रूपमा स्टक परिवर्तन गर्नुहोस्",
     "view-zone-members": "सदस्यहरू हेर्नुहोस्",
     "zone": "जोन"
   },
   "state": {
-    "adding-items": "वस्तुहरू थप्दै छ",
+    "adding-items": "समानहरू थप्दै छ",
     "arranging-additional-payment": "अतिरिक्त भुक्तान योजना गर्दै",
     "arranging-payment": "भुक्तान योजना गर्दै",
     "authorized": "स्वीकृत",

From 75f79f48901a8f766f79a9857e30c55a49676540 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 18 Oct 2023 08:44:19 +0200
Subject: [PATCH 23/49] chore(admin-ui): Enable th HR translation

---
 packages/admin-ui-plugin/src/constants.ts               | 1 +
 packages/admin-ui/src/lib/static/vendure-ui-config.json | 3 ++-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/admin-ui-plugin/src/constants.ts b/packages/admin-ui-plugin/src/constants.ts
index 85de601824..ae226c25a2 100644
--- a/packages/admin-ui-plugin/src/constants.ts
+++ b/packages/admin-ui-plugin/src/constants.ts
@@ -24,4 +24,5 @@ export const defaultAvailableLanguages = [
     LanguageCode.it,
     LanguageCode.fa,
     LanguageCode.ne,
+    LanguageCode.hr,
 ];
diff --git a/packages/admin-ui/src/lib/static/vendure-ui-config.json b/packages/admin-ui/src/lib/static/vendure-ui-config.json
index 2829682fc7..10617b5192 100644
--- a/packages/admin-ui/src/lib/static/vendure-ui-config.json
+++ b/packages/admin-ui/src/lib/static/vendure-ui-config.json
@@ -23,7 +23,8 @@
         "uk",
         "it",
         "fa",
-        "ne"
+        "ne",
+        "hr"
     ],
     "brand": "",
     "hideVendureBranding": false,

From 9d88db2e7cfe4fbbde0559bcd24f60b9d044c086 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 18 Oct 2023 09:48:57 +0200
Subject: [PATCH 24/49] fix(admin-ui): Fix setting facet values on new product

Fixes #2355
---
 .../product-detail.component.ts               | 29 +++++++------------
 1 file changed, 10 insertions(+), 19 deletions(-)

diff --git a/packages/admin-ui/src/lib/catalog/src/components/product-detail/product-detail.component.ts b/packages/admin-ui/src/lib/catalog/src/components/product-detail/product-detail.component.ts
index 07d030d4e1..87e8daa4c0 100644
--- a/packages/admin-ui/src/lib/catalog/src/components/product-detail/product-detail.component.ts
+++ b/packages/admin-ui/src/lib/catalog/src/components/product-detail/product-detail.component.ts
@@ -1,6 +1,5 @@
 import { ChangeDetectionStrategy, ChangeDetectorRef, Component, OnDestroy, OnInit } from '@angular/core';
 import { FormBuilder, UntypedFormGroup, Validators } from '@angular/forms';
-import { ActivatedRoute, Router } from '@angular/router';
 import { marker as _ } from '@biesbjerg/ngx-translate-extract-marker';
 import {
     Asset,
@@ -20,7 +19,6 @@ import {
     PRODUCT_DETAIL_FRAGMENT,
     ProductDetailFragment,
     ProductVariantFragment,
-    ServerConfigService,
     TypedBaseDetailComponent,
     unicodePatternValidator,
     UpdateProductInput,
@@ -33,17 +31,8 @@ import { normalizeString } from '@vendure/common/lib/normalize-string';
 import { DEFAULT_CHANNEL_CODE } from '@vendure/common/lib/shared-constants';
 import { unique } from '@vendure/common/lib/unique';
 import { gql } from 'apollo-angular';
-import { combineLatest, concat, EMPTY, from, Observable } from 'rxjs';
-import {
-    distinctUntilChanged,
-    map,
-    mergeMap,
-    shareReplay,
-    skip,
-    switchMap,
-    switchMapTo,
-    take,
-} from 'rxjs/operators';
+import { combineLatest, concat, EMPTY, from, Observable, of } from 'rxjs';
+import { distinctUntilChanged, map, mergeMap, shareReplay, switchMap, take } from 'rxjs/operators';
 
 import { ProductDetailService } from '../../providers/product-detail/product-detail.service';
 import { ApplyFacetDialogComponent } from '../apply-facet-dialog/apply-facet-dialog.component';
@@ -91,9 +80,6 @@ export class ProductDetailComponent
     public readonly updatePermissions = [Permission.UpdateCatalog, Permission.UpdateProduct];
 
     constructor(
-        route: ActivatedRoute,
-        router: Router,
-        serverConfigService: ServerConfigService,
         private productDetailService: ProductDetailService,
         private formBuilder: FormBuilder,
         private modalService: ModalService,
@@ -106,11 +92,15 @@ export class ProductDetailComponent
 
     ngOnInit() {
         this.init();
-        const productFacetValues$ = this.entity$.pipe(map(product => product.facetValues));
+
+        const productFacetValues$ = this.isNew$.pipe(
+            switchMap(isNew => {
+                return isNew ? of([]) : this.entity$.pipe(map(product => product.facetValues));
+            }),
+        );
         const productGroup = this.detailForm;
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
         const formFacetValueIdChanges$ = productGroup.get('facetValueIds')!.valueChanges.pipe(
-            skip(1),
             distinctUntilChanged(),
             switchMap(ids =>
                 this.dataService.facet
@@ -121,7 +111,7 @@ export class ProductDetailComponent
         );
         this.facetValues$ = concat(
             productFacetValues$.pipe(take(1)),
-            productFacetValues$.pipe(switchMapTo(formFacetValueIdChanges$)),
+            productFacetValues$.pipe(switchMap(() => formFacetValueIdChanges$)),
         );
         this.productChannels$ = this.entity$.pipe(map(p => p.channels));
     }
@@ -261,6 +251,7 @@ export class ProductDetailComponent
                     facetValueIds: unique([...currentFacetValueIds, ...facetValueIds]),
                 });
                 productGroup.markAsDirty();
+                this.changeDetector.markForCheck();
             }
         });
     }

From e265a30eecc91def8a467141e0334f29a643e43e Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 18 Oct 2023 10:45:39 +0200
Subject: [PATCH 25/49] docs: Improve docs on custom order process

Closes #2247
---
 .../docs/guides/core-concepts/orders/index.md | 89 +++++++++++++++++++
 1 file changed, 89 insertions(+)

diff --git a/docs/docs/guides/core-concepts/orders/index.md b/docs/docs/guides/core-concepts/orders/index.md
index b999b47b5a..68d9222a18 100644
--- a/docs/docs/guides/core-concepts/orders/index.md
+++ b/docs/docs/guides/core-concepts/orders/index.md
@@ -117,6 +117,20 @@ const myCustomOrderProcess = configureDefaultOrderProcess({
   // Orders to have a shipping method assigned
   // before payment.
   arrangingPaymentRequiresShipping: false,
+    
+  // Other constraints which can be disabled. See the
+  // DefaultOrderProcessOptions interface docs for full
+  // explanations.
+  //  
+  // checkModificationPayments: false,
+  // checkAdditionalPaymentsAmount: false,
+  // checkAllVariantsExist: false,
+  // arrangingPaymentRequiresContents: false,
+  // arrangingPaymentRequiresCustomer: false,
+  // arrangingPaymentRequiresStock: false,
+  // checkPaymentsCoverTotal: false,
+  // checkAllItemsBeforeCancel: false,
+  // checkFulfillmentStates: false,
 });
 
 export const config: VendureConfig = {
@@ -241,6 +255,81 @@ const customerValidationProcess: OrderProcess<'ValidatingCustomer'> = {
 For an explanation of the `init()` method and `injector` argument, see the guide on [injecting dependencies in configurable operations](/guides/developer-guide/strategies-configurable-operations/#injecting-dependencies).
 :::
 
+### Responding to a state transition
+
+Once an order has successfully transitioned to a new state, the [`onTransitionEnd` state transition hook](/reference/typescript-api/state-machine/state-machine-config#ontransitionend) is called. This can be used to perform some action
+upon successful state transition.
+
+In this example, we have a referral service which creates a new referral for a customer when they complete an order. We want to create the referral only if the customer has a referral code associated with their account.
+
+```ts
+import { OrderProcess, OrderState } from '@vendure/core';
+
+import { ReferralService } from '../service/referral.service';
+
+let referralService: ReferralService;
+
+export const referralOrderProcess: OrderProcess<OrderState> = {
+    init: (injector) => {
+        referralService = injector.get(ReferralService);
+    },
+    onTransitionEnd: async (fromState, toState, data) => {
+        const { order, ctx } = data;
+        if (toState === 'PaymentSettled') {
+            if (order.customFields.referralCode) {
+                await referralService.createReferralForOrder(ctx, order);
+            }
+        }
+    },
+};
+```
+
+:::caution
+Use caution when modifying an order inside the `onTransitionEnd` function. The `order` object that gets passed in to this function
+will later be persisted to the database. Therefore any changes must be made to that `order` object, otherwise the changes might be lost.
+
+As an example, let's say we want to add a Surcharge to the order. The following code **will not work as expected**:
+
+```ts
+export const myOrderProcess: OrderProcess<OrderState> = {
+    async onTransitionEnd(fromState, toState, data) {
+        if (fromState === 'AddingItems' && toState === 'ArrangingPayment') {
+            // highlight-start
+            // WARNING: This will not work!  
+            await orderService.addSurchargeToOrder(ctx, order.id, {
+                description: 'Test',
+                listPrice: 42,
+                listPriceIncludesTax: false,
+            });
+            // highlight-end
+        }
+    }
+};
+```
+
+Instead, you need to ensure you **mutate the `order` object**:
+
+```ts
+export const myOrderProcess: OrderProcess<OrderState> = {
+    async onTransitionEnd(fromState, toState, data) {
+        if (fromState === 'AddingItems' && toState === 'ArrangingPayment') {
+            // highlight-start
+            const {surcharges} = await orderService.addSurchargeToOrder(ctx, order.id, {
+                description: 'Test',
+                listPrice: 42,
+                listPriceIncludesTax: false,
+            });
+            // Important: mutate the order object
+            order.surcharges = surcharges;
+            // highlight-end
+        }
+    },
+}
+```
+
+
+:::
+
 ## TypeScript Typings
 
 To make your custom states compatible with standard services you should declare your new states in the following way:

From de8e3c054c12c413925bfc48e552f137d35315a3 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 18 Oct 2023 11:36:04 +0200
Subject: [PATCH 26/49] docs: Improve docs working with DB relations

Relates to #2299
---
 .../the-service-layer/index.mdx               | 80 +++++++++++++++++++
 .../custom-input-components/default-inputs.md |  4 +-
 .../custom-column-component.md                |  2 +-
 .../data-table-component-config.md            |  2 +-
 .../data-access/entity-hydrator.md            | 34 ++++++--
 .../services/customer-service.md              | 50 ++++++------
 .../shipping/shipping-calculator.md           |  8 +-
 .../entity-hydrator.service.ts                | 32 ++++++--
 8 files changed, 168 insertions(+), 44 deletions(-)

diff --git a/docs/docs/guides/developer-guide/the-service-layer/index.mdx b/docs/docs/guides/developer-guide/the-service-layer/index.mdx
index 5c96bd3809..2166d16bbe 100644
--- a/docs/docs/guides/developer-guide/the-service-layer/index.mdx
+++ b/docs/docs/guides/developer-guide/the-service-layer/index.mdx
@@ -229,3 +229,83 @@ export class ItemService {
 Further examples can be found in the [TypeORM QueryBuilder documentation](https://typeorm.io/select-query-builder).
 
 :::
+
+### Working with relations
+
+One limitation of TypeORM's typings is that we have no way of knowing at build-time whether a particular relation will be
+joined at runtime. For instance, the following code will build without issues, but will result in a runtime error:
+
+```ts
+const product = await this.connection.getRepository(ctx, Product).findOne({
+    where: { id: productId },
+});
+if (product) {
+    // highlight-start
+    console.log(product.featuredAsset.preview);
+    // ^ Error: Cannot read property 'preview' of undefined
+    // highlight-end
+}
+```
+
+This is because the `featuredAsset` relation is not joined by default. The simple fix for the above example is to use
+the `relations` option:
+
+```ts
+const product = await this.connection.getRepository(ctx, Product).findOne({
+    where: { id: productId },
+    // highlight-next-line
+    relations: { featuredAsset: true },
+});
+```
+or in the case of the QueryBuilder API, we can use the `leftJoinAndSelect()` method:
+
+```ts
+const product = await this.connection.getRepository(ctx, Product).createQueryBuilder('product')
+    // highlight-next-line
+    .leftJoinAndSelect('product.featuredAsset', 'featuredAsset')
+    .where('product.id = :id', { id: productId })
+    .getOne();
+```
+
+### Using the EntityHydrator
+
+But what about when we do not control the code which fetches the entity from the database? For instance, we might be implementing
+a function which gets an entity passed to it by Vendure. In this case, we can use the [`EntityHydrator`](/reference/typescript-api/data-access/entity-hydrator/)
+to ensure that a given relation is "hydrated" (i.e. joined) before we use it:
+
+```ts
+import { EntityHydrator, ShippingCalculator } from '@vendure/core';
+
+let entityHydrator: EntityHydrator;
+
+const myShippingCalculator = new ShippingCalculator({
+    // ... rest of config omitted for brevity
+    init(injector) {
+        entityHydrator = injector.get(EntityHydrator);
+    },
+    calculate: (ctx, order, args) => {
+      // highlight-start
+      // ensure that the customer and customer.groups relations are joined
+      await entityHydrator.hydrate(ctx, order, { relations: ['customer.groups' ]});
+      // highlight-end
+
+      if (order.customer?.groups?.some(g => g.name === 'VIP')) {
+        // ... do something special for VIP customers
+      } else {
+        // ... do something else
+      }
+    },
+});
+```
+
+### Joining relations in built-in service methods
+
+Many of the core services allow an optional `relations` argument in their `findOne()` and `findMany()` and related methods.
+This allows you to specify which relations should be joined when the query is executed. For instance, in the [`ProductService`](/reference/typescript-api/services/product-service)
+there is a `findOne()` method which allows you to specify which relations should be joined:
+
+```ts
+const productWithAssets = await this.productService
+    .findOne(ctx, productId, ['featuredAsset', 'assets']);
+```
+
diff --git a/docs/docs/reference/admin-ui-api/custom-input-components/default-inputs.md b/docs/docs/reference/admin-ui-api/custom-input-components/default-inputs.md
index 3f06ec5014..43d825ee45 100644
--- a/docs/docs/reference/admin-ui-api/custom-input-components/default-inputs.md
+++ b/docs/docs/reference/admin-ui-api/custom-input-components/default-inputs.md
@@ -289,7 +289,7 @@ class CustomerGroupFormInputComponent implements FormInputComponent, OnInit {
     constructor(dataService: DataService)
     ngOnInit() => ;
     selectGroup(group: ItemOf<GetCustomerGroupsQuery, 'customerGroups'>) => ;
-    compareWith(o1: ItemOf<GetCustomerGroupsQuery, 'customerGroups'>, o2: ItemOf<GetCustomerGroupsQuery, 'customerGroups'>) => ;
+    compareWith(o1: T, o2: T) => ;
 }
 ```
 * Implements: <code><a href='/reference/admin-ui-api/custom-input-components/form-input-component#forminputcomponent'>FormInputComponent</a></code>, <code>OnInit</code>
@@ -340,7 +340,7 @@ class CustomerGroupFormInputComponent implements FormInputComponent, OnInit {
 
 ### compareWith
 
-<MemberInfo kind="method" type={`(o1: ItemOf&#60;GetCustomerGroupsQuery, 'customerGroups'&#62;, o2: ItemOf&#60;GetCustomerGroupsQuery, 'customerGroups'&#62;) => `}   />
+<MemberInfo kind="method" type={`(o1: T, o2: T) => `}   />
 
 
 
diff --git a/docs/docs/reference/admin-ui-api/custom-table-components/custom-column-component.md b/docs/docs/reference/admin-ui-api/custom-table-components/custom-column-component.md
index 99aa70b88f..13af4351cb 100644
--- a/docs/docs/reference/admin-ui-api/custom-table-components/custom-column-component.md
+++ b/docs/docs/reference/admin-ui-api/custom-table-components/custom-column-component.md
@@ -11,7 +11,7 @@ import MemberDescription from '@site/src/components/MemberDescription';
 
 ## CustomColumnComponent
 
-<GenerationInfo sourceFile="packages/admin-ui/src/lib/core/src/shared/components/data-table-2/data-table-custom-component.service.ts" sourceLine="43" packageName="@vendure/admin-ui" />
+<GenerationInfo sourceFile="packages/admin-ui/src/lib/core/src/shared/components/data-table-2/data-table-custom-component.service.ts" sourceLine="44" packageName="@vendure/admin-ui" />
 
 Components which are to be used to render custom cells in a data table should implement this interface.
 
diff --git a/docs/docs/reference/admin-ui-api/custom-table-components/data-table-component-config.md b/docs/docs/reference/admin-ui-api/custom-table-components/data-table-component-config.md
index 10ad7b2fc9..2409146735 100644
--- a/docs/docs/reference/admin-ui-api/custom-table-components/data-table-component-config.md
+++ b/docs/docs/reference/admin-ui-api/custom-table-components/data-table-component-config.md
@@ -11,7 +11,7 @@ import MemberDescription from '@site/src/components/MemberDescription';
 
 ## DataTableComponentConfig
 
-<GenerationInfo sourceFile="packages/admin-ui/src/lib/core/src/shared/components/data-table-2/data-table-custom-component.service.ts" sourceLine="53" packageName="@vendure/admin-ui" />
+<GenerationInfo sourceFile="packages/admin-ui/src/lib/core/src/shared/components/data-table-2/data-table-custom-component.service.ts" sourceLine="54" packageName="@vendure/admin-ui" />
 
 Configures a <a href='/reference/admin-ui-api/custom-detail-components/custom-detail-component#customdetailcomponent'>CustomDetailComponent</a> to be placed in the given location.
 
diff --git a/docs/docs/reference/typescript-api/data-access/entity-hydrator.md b/docs/docs/reference/typescript-api/data-access/entity-hydrator.md
index 9ac4442c09..317736d30d 100644
--- a/docs/docs/reference/typescript-api/data-access/entity-hydrator.md
+++ b/docs/docs/reference/typescript-api/data-access/entity-hydrator.md
@@ -11,20 +11,42 @@ import MemberDescription from '@site/src/components/MemberDescription';
 
 ## EntityHydrator
 
-<GenerationInfo sourceFile="packages/core/src/service/helpers/entity-hydrator/entity-hydrator.service.ts" sourceLine="53" packageName="@vendure/core" since="1.3.0" />
+<GenerationInfo sourceFile="packages/core/src/service/helpers/entity-hydrator/entity-hydrator.service.ts" sourceLine="75" packageName="@vendure/core" since="1.3.0" />
 
 This is a helper class which is used to "hydrate" entity instances, which means to populate them
-with the specified relations. This is useful when writing plugin code which receives an entity
+with the specified relations. This is useful when writing plugin code which receives an entity,
 and you need to ensure that one or more relations are present.
 
 *Example*
 
 ```ts
-const product = await this.productVariantService
-  .getProductForVariant(ctx, variantId);
+import { Injectable } from '@nestjs/common';
+import { ID, RequestContext, EntityHydrator, ProductVariantService } from '@vendure/core';
 
-await this.entityHydrator
-  .hydrate(ctx, product, { relations: ['facetValues.facet' ]});
+@Injectable()
+export class MyService {
+
+  constructor(
+     // highlight-next-line
+     private entityHydrator: EntityHydrator,
+     private productVariantService: ProductVariantService,
+  ) {}
+
+  myMethod(ctx: RequestContext, variantId: ID) {
+    const product = await this.productVariantService
+      .getProductForVariant(ctx, variantId);
+
+    // at this stage, we don't know which of the Product relations
+    // will be joined at runtime.
+
+    // highlight-start
+    await this.entityHydrator
+      .hydrate(ctx, product, { relations: ['facetValues.facet' ]});
+
+    // You can be sure now that the `facetValues` & `facetValues.facet` relations are populated
+    // highlight-end
+  }
+}
 ```
 
 In this above example, the `product` instance will now have the `facetValues` relation
diff --git a/docs/docs/reference/typescript-api/services/customer-service.md b/docs/docs/reference/typescript-api/services/customer-service.md
index 9de458b184..2e91471aa6 100644
--- a/docs/docs/reference/typescript-api/services/customer-service.md
+++ b/docs/docs/reference/typescript-api/services/customer-service.md
@@ -31,8 +31,8 @@ class CustomerService {
     refreshVerificationToken(ctx: RequestContext, emailAddress: string) => Promise<void>;
     verifyCustomerEmailAddress(ctx: RequestContext, verificationToken: string, password?: string) => Promise<ErrorResultUnion<VerifyCustomerAccountResult, Customer>>;
     requestPasswordReset(ctx: RequestContext, emailAddress: string) => Promise<void>;
-    resetPassword(ctx: RequestContext, passwordResetToken: string, password: string) => Promise<
-        User | PasswordResetTokenExpiredError | PasswordResetTokenInvalidError | PasswordValidationError
+    resetPassword(ctx: RequestContext, passwordResetToken: string, password: string) => Promise<
+        User | PasswordResetTokenExpiredError | PasswordResetTokenInvalidError | PasswordValidationError
     >;
     requestUpdateEmailAddress(ctx: RequestContext, userId: ID, newEmailAddress: string) => Promise<boolean | EmailAddressConflictError>;
     updateEmailAddress(ctx: RequestContext, token: string) => Promise<boolean | IdentifierChangeTokenInvalidError | IdentifierChangeTokenExpiredError>;
@@ -69,8 +69,8 @@ class CustomerService {
 
 <MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, userId: <a href='/reference/typescript-api/common/id#id'>ID</a>, filterOnChannel:  = true) => Promise&#60;<a href='/reference/typescript-api/entities/customer#customer'>Customer</a> | undefined&#62;`}   />
 
-Returns the Customer entity associated with the given userId, if one exists.
-Setting `filterOnChannel` to `true` will limit the results to Customers which are assigned
+Returns the Customer entity associated with the given userId, if one exists.
+Setting `filterOnChannel` to `true` will limit the results to Customers which are assigned
 to the current active Channel only.
 ### findAddressesByCustomerId
 
@@ -86,13 +86,13 @@ Returns a list of all <a href='/reference/typescript-api/entities/customer-group
 
 <MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, input: CreateCustomerInput, password?: string) => Promise&#60;ErrorResultUnion&#60;CreateCustomerResult, <a href='/reference/typescript-api/entities/customer#customer'>Customer</a>&#62;&#62;`}   />
 
-Creates a new Customer, including creation of a new User with the special `customer` Role.
-
-If the `password` argument is specified, the Customer will be immediately verified. If not,
-then an <a href='/reference/typescript-api/events/event-types#accountregistrationevent'>AccountRegistrationEvent</a> is published, so that the customer can have their
-email address verified and set their password in a later step using the `verifyCustomerEmailAddress()`
-method.
-
+Creates a new Customer, including creation of a new User with the special `customer` Role.
+
+If the `password` argument is specified, the Customer will be immediately verified. If not,
+then an <a href='/reference/typescript-api/events/event-types#accountregistrationevent'>AccountRegistrationEvent</a> is published, so that the customer can have their
+email address verified and set their password in a later step using the `verifyCustomerEmailAddress()`
+method.
+
 This method is intended to be used in admin-created Customer flows.
 ### update
 
@@ -113,47 +113,47 @@ This method is intended to be used in admin-created Customer flows.
 
 <MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, input: RegisterCustomerInput) => Promise&#60;RegisterCustomerAccountResult | EmailAddressConflictError | PasswordValidationError&#62;`}   />
 
-Registers a new Customer account with the <a href='/reference/typescript-api/auth/native-authentication-strategy#nativeauthenticationstrategy'>NativeAuthenticationStrategy</a> and starts
-the email verification flow (unless <a href='/reference/typescript-api/auth/auth-options#authoptions'>AuthOptions</a> `requireVerification` is set to `false`)
-by publishing an <a href='/reference/typescript-api/events/event-types#accountregistrationevent'>AccountRegistrationEvent</a>.
-
+Registers a new Customer account with the <a href='/reference/typescript-api/auth/native-authentication-strategy#nativeauthenticationstrategy'>NativeAuthenticationStrategy</a> and starts
+the email verification flow (unless <a href='/reference/typescript-api/auth/auth-options#authoptions'>AuthOptions</a> `requireVerification` is set to `false`)
+by publishing an <a href='/reference/typescript-api/events/event-types#accountregistrationevent'>AccountRegistrationEvent</a>.
+
 This method is intended to be used in storefront Customer-creation flows.
 ### refreshVerificationToken
 
 <MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, emailAddress: string) => Promise&#60;void&#62;`}   />
 
-Refreshes a stale email address verification token by generating a new one and
+Refreshes a stale email address verification token by generating a new one and
 publishing a <a href='/reference/typescript-api/events/event-types#accountregistrationevent'>AccountRegistrationEvent</a>.
 ### verifyCustomerEmailAddress
 
 <MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, verificationToken: string, password?: string) => Promise&#60;ErrorResultUnion&#60;VerifyCustomerAccountResult, <a href='/reference/typescript-api/entities/customer#customer'>Customer</a>&#62;&#62;`}   />
 
-Given a valid verification token which has been published in an <a href='/reference/typescript-api/events/event-types#accountregistrationevent'>AccountRegistrationEvent</a>, this
+Given a valid verification token which has been published in an <a href='/reference/typescript-api/events/event-types#accountregistrationevent'>AccountRegistrationEvent</a>, this
 method is used to set the Customer as `verified` as part of the account registration flow.
 ### requestPasswordReset
 
 <MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, emailAddress: string) => Promise&#60;void&#62;`}   />
 
-Publishes a new <a href='/reference/typescript-api/events/event-types#passwordresetevent'>PasswordResetEvent</a> for the given email address. This event creates
+Publishes a new <a href='/reference/typescript-api/events/event-types#passwordresetevent'>PasswordResetEvent</a> for the given email address. This event creates
 a token which can be used in the `resetPassword()` method.
 ### resetPassword
 
-<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, passwordResetToken: string, password: string) => Promise&#60;
         <a href='/reference/typescript-api/entities/user#user'>User</a> | PasswordResetTokenExpiredError | PasswordResetTokenInvalidError | PasswordValidationError
     &#62;`}   />
+<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, passwordResetToken: string, password: string) => Promise&#60;         <a href='/reference/typescript-api/entities/user#user'>User</a> | PasswordResetTokenExpiredError | PasswordResetTokenInvalidError | PasswordValidationError     &#62;`}   />
 
-Given a valid password reset token created by a call to the `requestPasswordReset()` method,
+Given a valid password reset token created by a call to the `requestPasswordReset()` method,
 this method will change the Customer's password to that given as the `password` argument.
 ### requestUpdateEmailAddress
 
 <MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, userId: <a href='/reference/typescript-api/common/id#id'>ID</a>, newEmailAddress: string) => Promise&#60;boolean | EmailAddressConflictError&#62;`}   />
 
-Publishes a <a href='/reference/typescript-api/events/event-types#identifierchangerequestevent'>IdentifierChangeRequestEvent</a> for the given User. This event contains a token
-which is then used in the `updateEmailAddress()` method to change the email address of the User &
+Publishes a <a href='/reference/typescript-api/events/event-types#identifierchangerequestevent'>IdentifierChangeRequestEvent</a> for the given User. This event contains a token
+which is then used in the `updateEmailAddress()` method to change the email address of the User &
 Customer.
 ### updateEmailAddress
 
 <MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, token: string) => Promise&#60;boolean | IdentifierChangeTokenInvalidError | IdentifierChangeTokenExpiredError&#62;`}   />
 
-Given a valid email update token published in a <a href='/reference/typescript-api/events/event-types#identifierchangerequestevent'>IdentifierChangeRequestEvent</a>, this method
+Given a valid email update token published in a <a href='/reference/typescript-api/events/event-types#identifierchangerequestevent'>IdentifierChangeRequestEvent</a>, this method
 will update the Customer & User email address.
 ### createOrUpdate
 
@@ -184,8 +184,8 @@ Creates a new <a href='/reference/typescript-api/entities/address#address'>Addre
 
 <MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, order: <a href='/reference/typescript-api/entities/order#order'>Order</a>) => `}   />
 
-If the Customer associated with the given Order does not yet have any Addresses,
-this method will create new Address(es) based on the Order's shipping & billing
+If the Customer associated with the given Order does not yet have any Addresses,
+this method will create new Address(es) based on the Order's shipping & billing
 addresses.
 ### addNoteToCustomer
 
diff --git a/docs/docs/reference/typescript-api/shipping/shipping-calculator.md b/docs/docs/reference/typescript-api/shipping/shipping-calculator.md
index 0e20f9bc3e..bc37d2af30 100644
--- a/docs/docs/reference/typescript-api/shipping/shipping-calculator.md
+++ b/docs/docs/reference/typescript-api/shipping/shipping-calculator.md
@@ -31,7 +31,7 @@ const flatRateCalculator = new ShippingCalculator({
       ui: { component: 'number-form-input', suffix: '%' },
     },
   },
-  calculate: (order, args) => {
+  calculate: (ctx, order, args) => {
     return {
       price: args.rate,
       taxRate: args.taxRate,
@@ -64,7 +64,7 @@ class ShippingCalculator<T extends ConfigArgs = ConfigArgs> extends Configurable
 
 ## ShippingCalculationResult
 
-<GenerationInfo sourceFile="packages/core/src/config/shipping-method/shipping-calculator.ts" sourceLine="74" packageName="@vendure/core" />
+<GenerationInfo sourceFile="packages/core/src/config/shipping-method/shipping-calculator.ts" sourceLine="79" packageName="@vendure/core" />
 
 The return value of the <a href='/reference/typescript-api/shipping/shipping-calculator#calculateshippingfn'>CalculateShippingFn</a>.
 
@@ -108,7 +108,7 @@ needed in the storefront application when listing eligible shipping methods.
 
 ## CalculateShippingFn
 
-<GenerationInfo sourceFile="packages/core/src/config/shipping-method/shipping-calculator.ts" sourceLine="114" packageName="@vendure/core" />
+<GenerationInfo sourceFile="packages/core/src/config/shipping-method/shipping-calculator.ts" sourceLine="119" packageName="@vendure/core" />
 
 A function which implements the specific shipping calculation logic. It takes an <a href='/reference/typescript-api/entities/order#order'>Order</a> and
 an arguments object and should return the shipping price as an integer in cents.
@@ -120,6 +120,6 @@ type CalculateShippingFn<T extends ConfigArgs> = (
     ctx: RequestContext,
     order: Order,
     args: ConfigArgValues<T>,
-    method: ShippingMethod
+    method: ShippingMethod,
 ) => CalculateShippingFnResult
 ```
diff --git a/packages/core/src/service/helpers/entity-hydrator/entity-hydrator.service.ts b/packages/core/src/service/helpers/entity-hydrator/entity-hydrator.service.ts
index 3e5313e50a..6316b64aba 100644
--- a/packages/core/src/service/helpers/entity-hydrator/entity-hydrator.service.ts
+++ b/packages/core/src/service/helpers/entity-hydrator/entity-hydrator.service.ts
@@ -16,16 +16,38 @@ import { HydrateOptions } from './entity-hydrator-types';
 /**
  * @description
  * This is a helper class which is used to "hydrate" entity instances, which means to populate them
- * with the specified relations. This is useful when writing plugin code which receives an entity
+ * with the specified relations. This is useful when writing plugin code which receives an entity,
  * and you need to ensure that one or more relations are present.
  *
  * @example
  * ```ts
- * const product = await this.productVariantService
- *   .getProductForVariant(ctx, variantId);
+ * import { Injectable } from '\@nestjs/common';
+ * import { ID, RequestContext, EntityHydrator, ProductVariantService } from '\@vendure/core';
  *
- * await this.entityHydrator
- *   .hydrate(ctx, product, { relations: ['facetValues.facet' ]});
+ * \@Injectable()
+ * export class MyService {
+ *
+ *   constructor(
+ *      // highlight-next-line
+ *      private entityHydrator: EntityHydrator,
+ *      private productVariantService: ProductVariantService,
+ *   ) {}
+ *
+ *   myMethod(ctx: RequestContext, variantId: ID) {
+ *     const product = await this.productVariantService
+ *       .getProductForVariant(ctx, variantId);
+ *
+ *     // at this stage, we don't know which of the Product relations
+ *     // will be joined at runtime.
+ *
+ *     // highlight-start
+ *     await this.entityHydrator
+ *       .hydrate(ctx, product, { relations: ['facetValues.facet' ]});
+ *
+ *     // You can be sure now that the `facetValues` & `facetValues.facet` relations are populated
+ *     // highlight-end
+ *   }
+ * }
  *```
  *
  * In this above example, the `product` instance will now have the `facetValues` relation

From 2df160cdb2bfceffd02123cb0f668c5a0ac7bfed Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 18 Oct 2023 11:36:28 +0200
Subject: [PATCH 27/49] docs: Fix shipping calculator example

---
 .../src/config/shipping-method/shipping-calculator.ts | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/packages/core/src/config/shipping-method/shipping-calculator.ts b/packages/core/src/config/shipping-method/shipping-calculator.ts
index 2b20ae62e3..8390b536f6 100644
--- a/packages/core/src/config/shipping-method/shipping-calculator.ts
+++ b/packages/core/src/config/shipping-method/shipping-calculator.ts
@@ -32,7 +32,7 @@ export interface ShippingCalculatorConfig<T extends ConfigArgs> extends Configur
          ui: { component: 'number-form-input', suffix: '%' },
        },
  *   },
- *   calculate: (order, args) => {
+ *   calculate: (ctx, order, args) => {
  *     return {
  *       price: args.rate,
  *       taxRate: args.taxRate,
@@ -59,7 +59,12 @@ export class ShippingCalculator<T extends ConfigArgs = ConfigArgs> extends Confi
      *
      * @internal
      */
-    calculate(ctx: RequestContext, order: Order, args: ConfigArg[], method: ShippingMethod): CalculateShippingFnResult {
+    calculate(
+        ctx: RequestContext,
+        order: Order,
+        args: ConfigArg[],
+        method: ShippingMethod,
+    ): CalculateShippingFnResult {
         return this.calculateFn(ctx, order, this.argsArrayToHash(args), method);
     }
 }
@@ -115,5 +120,5 @@ export type CalculateShippingFn<T extends ConfigArgs> = (
     ctx: RequestContext,
     order: Order,
     args: ConfigArgValues<T>,
-    method: ShippingMethod
+    method: ShippingMethod,
 ) => CalculateShippingFnResult;

From 466839122bc1e9b7c598fe4c4bf4dc0d5fcf8234 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 18 Oct 2023 12:05:12 +0200
Subject: [PATCH 28/49] docs: Improve property display in custom fields guide

---
 .../developer-guide/custom-fields/index.md    | 110 +++++-------------
 .../components/CustomFieldProperty/index.tsx  |  26 +++++
 .../CustomFieldProperty/styles.module.css     |   7 ++
 3 files changed, 62 insertions(+), 81 deletions(-)
 create mode 100644 docs/src/components/CustomFieldProperty/index.tsx
 create mode 100644 docs/src/components/CustomFieldProperty/styles.module.css

diff --git a/docs/docs/guides/developer-guide/custom-fields/index.md b/docs/docs/guides/developer-guide/custom-fields/index.md
index 9241b16f69..e240afde57 100644
--- a/docs/docs/guides/developer-guide/custom-fields/index.md
+++ b/docs/docs/guides/developer-guide/custom-fields/index.md
@@ -5,6 +5,7 @@ sidebar_position: 3
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
+import CustomFieldProperty from '@site/src/components/CustomFieldProperty';
 
 Custom fields allow you to add your own custom data properties almost every Vendure entity. The entities which may have custom fields defined are listed in the [CustomFields interface documentation](/reference/typescript-api/custom-fields/).
 
@@ -200,9 +201,7 @@ All custom fields share some common properties:
 
 #### name
 
-<span class="badge badge--primary">Required</span>
-
-`string`
+<CustomFieldProperty required={true} type="string"/>
 
 The name of the field. This is used as the column name in the database, and as the GraphQL field name. The name should not contain spaces and by convention should be camelCased.
 
@@ -223,17 +222,13 @@ const config = {
 
 #### type
 
-<span class="badge badge--primary">Required</span>
-
-[`CustomFieldType`](/reference/typescript-api/custom-fields/custom-field-type)
+<CustomFieldProperty required={true} type="CustomFieldType" typeLink="/reference/typescript-api/custom-fields/custom-field-type"/>
 
 The type of data that will be stored in the field.
 
 #### list
 
-<span class="badge badge--secondary">Optional</span>
-
-`boolean`
+<CustomFieldProperty required={false} type="boolean" />
 
 If set to `true`, then the field will be an array of the specified type. Defaults to `false`.
 
@@ -261,9 +256,7 @@ Setting a custom field to be a list has the following effects:
 
 #### label
 
-<span class="badge badge--secondary">Optional</span>
-
-[`LocalizedStringArray`](/reference/typescript-api/configurable-operation-def/localized-string-array)
+<CustomFieldProperty required={false} type="LocalizedStringArray" typeLink="/reference/typescript-api/configurable-operation-def/localized-string-array"/>
 
 An array of localized labels for the field. These are used in the Admin UI to label the field.
 
@@ -292,9 +285,7 @@ const config = {
 
 #### description
 
-<span class="badge badge--secondary">Optional</span>
-
-[`LocalizedStringArray`](/reference/typescript-api/configurable-operation-def/localized-string-array)
+<CustomFieldProperty required={false} type="LocalizedStringArray" typeLink="/reference/typescript-api/configurable-operation-def/localized-string-array"/>
 
 An array of localized descriptions for the field. These are used in the Admin UI to describe the field.
 
@@ -323,9 +314,7 @@ const config = {
 
 #### public
 
-<span class="badge badge--secondary">Optional</span>
-
-`boolean`
+<CustomFieldProperty required={false} type="boolean" />
 
 Whether the custom field is available via the Shop API. Defaults to `true`.
 
@@ -347,9 +336,7 @@ const config = {
 
 #### readonly
 
-<span class="badge badge--secondary">Optional</span>
-
-`boolean`
+<CustomFieldProperty required={false} type="boolean" />
 
 Whether the custom field can be updated via the GraphQL APIs. Defaults to `false`. If set to `true`, then the field
 can only be updated via direct manipulation via TypeScript code in a plugin.
@@ -372,9 +359,7 @@ const config = {
 
 #### internal
 
-<span class="badge badge--secondary">Optional</span>
-
-`boolean`
+<CustomFieldProperty required={false} type="boolean" />
 
 Whether the custom field is exposed at all via the GraphQL APIs. Defaults to `false`. If set to `true`, then the field will not be available
 via the GraphQL API, but can still be used in TypeScript code in a plugin. Internal fields are useful for storing data which is not intended
@@ -398,9 +383,7 @@ const config = {
 
 #### defaultValue
 
-<span class="badge badge--secondary">Optional</span>
-
-`any`
+<CustomFieldProperty required={false} type="any" />
 
 The default value when an Entity is created with this field. If not provided, then the default value will be `null`. Note that if you set `nullable: false`, then
 you should also provide a `defaultValue` to avoid database errors when creating new entities.
@@ -423,9 +406,7 @@ const config = {
 
 #### nullable
 
-<span class="badge badge--secondary">Optional</span>
-
-`boolean`
+<CustomFieldProperty required={false} type="boolean" />
 
 Whether the field is nullable in the database. If set to `false`, then a `defaultValue` should be provided.
 
@@ -449,9 +430,7 @@ const config = {
 
 #### unique
 
-<span class="badge badge--secondary">Optional</span>
-
-`boolean`
+<CustomFieldProperty required={false} type="boolean" />
 
 Whether the value of the field should be unique. When set to `true`, a UNIQUE constraint is added to the column. Defaults
 to `false`.
@@ -474,9 +453,7 @@ const config = {
 
 #### validate
 
-<span class="badge badge--secondary">Optional</span>
-
-`(value: any) => string | LocalizedString[] | void`
+<CustomFieldProperty required={false} type="(value: any) => string | LocalizedString[] | void" />
 
 A custom validation function. If the value is valid, then the function should not return a value. If a string or LocalizedString array is returned, this is interpreted as an error message.
 
@@ -544,9 +521,7 @@ In addition to the common properties, the `string` custom fields have some type-
 
 #### pattern
 
-<span class="badge badge--secondary">Optional</span>
-
-`string`
+<CustomFieldProperty required={false} type="string" />
 
 A regex pattern which the field value must match. If the value does not match the pattern, then the validation will fail.
 
@@ -568,9 +543,7 @@ const config = {
 
 #### options
 
-<span class="badge badge--secondary">Optional</span>
-
-`{ value: string; label?: LocalizedString[]; }[]`
+<CustomFieldProperty required={false} type="{ value: string; label?: LocalizedString[]; }[]" />
 
 An array of pre-defined options for the field. This is useful for fields which should only have a limited set of values. The `value` property is the value which will be stored in the database, and the `label` property is an optional array of localized strings which will be displayed in the admin UI.
 
@@ -600,9 +573,7 @@ Attempting to set the value of the field to a value which is not in the `options
 
 #### length
 
-<span class="badge badge--secondary">Optional</span>
-
-`number`
+<CustomFieldProperty required={false} type="number" />
 
 The max length of the varchar created in the database. Defaults to 255. Maximum is 65,535.
 
@@ -628,17 +599,13 @@ In addition to the common properties, the `localeString` custom fields have some
 
 #### pattern
 
-<span class="badge badge--secondary">Optional</span>
-
-`string`
+<CustomFieldProperty required={false} type="string" />
 
 Same as the `pattern` property for `string` fields.
 
 #### length
 
-<span class="badge badge--secondary">Optional</span>
-
-`number`
+<CustomFieldProperty required={false} type="number" />
 
 Same as the `length` property for `string` fields.
 
@@ -648,9 +615,7 @@ In addition to the common properties, the `int` & `float` custom fields have som
 
 #### min
 
-<span class="badge badge--secondary">Optional</span>
-
-`number`
+<CustomFieldProperty required={false} type="number" />
 
 The minimum permitted value. If the value is less than this, then the validation will fail.
 
@@ -672,9 +637,7 @@ const config = {
 
 #### max
 
-<span class="badge badge--secondary">Optional</span>
-
-`number`
+<CustomFieldProperty required={false} type="number" />
 
 The maximum permitted value. If the value is greater than this, then the validation will fail.
 
@@ -696,9 +659,7 @@ const config = {
 
 #### step
 
-<span class="badge badge--secondary">Optional</span>
-
-`number`
+<CustomFieldProperty required={false} type="number" />
 
 The step value. This is used in the Admin UI to determine the increment/decrement value of the input field.
 
@@ -726,9 +687,7 @@ The min, max & step properties for datetime fields are intended to be used as de
 
 #### min
 
-<span class="badge badge--secondary">Optional</span>
-
-`string`
+<CustomFieldProperty required={false} type="string" />
 
 The earliest permitted date. If the value is earlier than this, then the validation will fail.
 
@@ -750,9 +709,7 @@ const config = {
 
 #### max
 
-<span class="badge badge--secondary">Optional</span>
-
-`string`
+<CustomFieldProperty required={false} type="string" />
 
 The latest permitted date. If the value is later than this, then the validation will fail.
 
@@ -774,9 +731,7 @@ const config = {
 
 #### step
 
-<span class="badge badge--secondary">Optional</span>
-
-`string`
+<CustomFieldProperty required={false} type="string" />
 
 The step value. See [the MDN datetime-local docs](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/datetime-local#step) to understand how this is used.
 
@@ -786,9 +741,8 @@ In addition to the common properties, the `relation` custom fields have some typ
 
 #### entity
 
-<span class="badge badge--primary">Required</span>
+<CustomFieldProperty required={true} type="VendureEntity" typeLink="/reference/typescript-api/entities/vendure-entity" />
 
-`VendureEntity`
 
 The entity which this custom field is referencing. This can be one of the built-in entities, or a custom entity. If the entity is a custom entity, it must extend the `VendureEntity` class.
 
@@ -814,9 +768,7 @@ const config = {
 
 #### eager
 
-<span class="badge badge--secondary">Optional</span>
-
-`boolean`
+<CustomFieldProperty required={false} type="boolean" />
 
 Whether to [eagerly load](https://typeorm.io/#/eager-and-lazy-relations) the relation. Defaults to false. Note that eager loading has performance implications, so should only be used when necessary.
 
@@ -842,9 +794,7 @@ const config = {
 
 #### graphQLType
 
-<span class="badge badge--secondary">Optional</span>
-
-`string`
+<CustomFieldProperty required={false} type="string" />
 
 The name of the GraphQL type that corresponds to the entity. Can be omitted if the GraphQL type name is the same as the entity name, which is the case for all of the built-in entities.
 
@@ -870,11 +820,9 @@ const config = {
 
 In the above example, the `CmsArticle` entity is being used as a related entity. However, the GraphQL type name is `BlogPost`, so we must specify this in the `graphQLType` property, otherwise Vendure will try to extend the GraphQL schema with reference to a non-existent "CmsArticle" type.
 
-### `inverseSide`
-
-<span class="badge badge--secondary">Optional</span>
+#### inverseSide
 
-`string | ((object: VendureEntity) => any);`
+<CustomFieldProperty required={false} type="string | ((object: VendureEntity) => any)" />
 
 Allows you to specify the [inverse side of the relation](https://typeorm.io/#inverse-side-of-the-relationship). Let's say you are adding a relation from `Product`
 to a custom entity which refers back to the product. You can specify this inverse relation like so:
diff --git a/docs/src/components/CustomFieldProperty/index.tsx b/docs/src/components/CustomFieldProperty/index.tsx
new file mode 100644
index 0000000000..6d7eaa6292
--- /dev/null
+++ b/docs/src/components/CustomFieldProperty/index.tsx
@@ -0,0 +1,26 @@
+import React from 'react';
+
+import styles from './styles.module.css';
+
+export default function CustomFieldProperty(props: { required: boolean; type: string; typeLink?: string }) {
+    return (
+        <div className={styles.wrapper}>
+            <div>
+                {props.required ? (
+                    <span className="badge badge--primary">Required</span>
+                ) : (
+                    <span className="badge badge--secondary">Optional</span>
+                )}
+            </div>
+            <div>
+                {props.typeLink ? (
+                    <a href={props.typeLink}>
+                        <code>{props.type}</code>
+                    </a>
+                ) : (
+                    <code>{props.type}</code>
+                )}
+            </div>
+        </div>
+    );
+}
diff --git a/docs/src/components/CustomFieldProperty/styles.module.css b/docs/src/components/CustomFieldProperty/styles.module.css
new file mode 100644
index 0000000000..c39cb0d49f
--- /dev/null
+++ b/docs/src/components/CustomFieldProperty/styles.module.css
@@ -0,0 +1,7 @@
+.wrapper {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 4px 12px;
+    margin-top: -12px;
+    margin-bottom: 22px;
+}

From 9dda349c0d71fddc718341897cbc26c5c51e4113 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 18 Oct 2023 12:14:54 +0200
Subject: [PATCH 29/49] fix(admin-ui): Fix initial render of code editor input
 marking dirty

---
 .../base-code-editor-form-input.component.ts                 | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/admin-ui/src/lib/core/src/shared/dynamic-form-inputs/code-editor-form-input/base-code-editor-form-input.component.ts b/packages/admin-ui/src/lib/core/src/shared/dynamic-form-inputs/code-editor-form-input/base-code-editor-form-input.component.ts
index 0a3749abd9..b02f28a14a 100644
--- a/packages/admin-ui/src/lib/core/src/shared/dynamic-form-inputs/code-editor-form-input/base-code-editor-form-input.component.ts
+++ b/packages/admin-ui/src/lib/core/src/shared/dynamic-form-inputs/code-editor-form-input/base-code-editor-form-input.component.ts
@@ -48,7 +48,12 @@ export abstract class BaseCodeEditorFormInputComponent implements FormInputCompo
             editor.innerHTML = this.highlight(code, this.getErrorPos(this.errorMessage));
         };
         this.jar = CodeJar(this.editorElementRef.nativeElement, highlight);
+        let isFirstUpdate = true;
         this.jar.onUpdate(value => {
+            if (isFirstUpdate) {
+                isFirstUpdate = false;
+                return;
+            }
             this.formControl.setValue(value);
             this.formControl.markAsDirty();
             this.isValid = this.formControl.valid;

From f6120ffa1e0dc71977668cada4be36215cff743f Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 18 Oct 2023 12:55:27 +0200
Subject: [PATCH 30/49] docs: Add docs on accessing custom fields via TS

Relates to #2299
---
 .../developer-guide/custom-fields/index.md    | 62 +++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/docs/docs/guides/developer-guide/custom-fields/index.md b/docs/docs/guides/developer-guide/custom-fields/index.md
index e240afde57..8d69678353 100644
--- a/docs/docs/guides/developer-guide/custom-fields/index.md
+++ b/docs/docs/guides/developer-guide/custom-fields/index.md
@@ -193,6 +193,68 @@ mutation {
 }
 ```
 
+## Accessing custom fields in TypeScript
+
+As well as exposing custom fields via the GraphQL APIs, you can also access them directly in your TypeScript code. This is useful for plugins which need to access custom field data.
+
+Given the following custom field configuration:
+
+```ts title="src/vendure-config.ts"
+import { VendureConfig } from '@vendure/core';
+
+const config: VendureConfig = {
+    // ...
+    customFields: {
+        Customer: [
+            { name: 'externalId', type: 'string' },
+            { name: 'avatar', type: 'relation', entity: Asset },
+        ],
+    },
+};
+```
+
+the `externalId` will be available whenever you access a `Customer` entity:
+
+```ts
+const customer = await this.connection.getRepository(ctx, Customer).findOne({
+    where: { id: 1 },
+});
+console.log(customer.externalId);
+```
+
+The `avatar` relation will require an explicit join to be performed in order to access the data, since it is not
+eagerly loaded by default:
+
+```ts
+const customer = await this.connection.getRepository(ctx, Customer).findOne({
+    where: { id: 1 },
+    relations: {
+        customFields: {
+            avatar: true,
+        }
+    }
+});
+console.log(customer.avatar);
+```
+
+or if using the QueryBuilder API:
+
+```ts
+const customer = await this.connection.getRepository(ctx, Customer).createQueryBuilder('customer')
+    .leftJoinAndSelect('customer.customFields.avatar', 'avatar')
+    .where('customer.id = :id', { id: 1 })
+    .getOne();
+console.log(customer.avatar);
+```
+
+or using the EntityHydrator:
+
+```ts
+const customer = await this.customerService.findOne(ctx, 1);
+await this.entityHydrator.hydrate(ctx, customer, { relations: ['customFields.avatar'] });
+console.log(customer.avatar);
+```
+
 ## Custom field config properties
 
 ### Common properties

From eb79c3dd32232296495de419916cf2138297c8ff Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 18 Oct 2023 13:05:53 +0200
Subject: [PATCH 31/49] docs: Add docs on removing nav menu items from admin ui

Relates to #2299
---
 .../extending-the-admin-ui/nav-menu/index.md  |  25 +++++++++++++++++-
 .../nav-menu/nav-menu-id.webp                 | Bin 0 -> 42976 bytes
 2 files changed, 24 insertions(+), 1 deletion(-)
 create mode 100644 docs/docs/guides/extending-the-admin-ui/nav-menu/nav-menu-id.webp

diff --git a/docs/docs/guides/extending-the-admin-ui/nav-menu/index.md b/docs/docs/guides/extending-the-admin-ui/nav-menu/index.md
index afd11c9331..2d76e8ee78 100644
--- a/docs/docs/guides/extending-the-admin-ui/nav-menu/index.md
+++ b/docs/docs/guides/extending-the-admin-ui/nav-menu/index.md
@@ -71,4 +71,27 @@ Running the server will compile our new shared module into the app, and the resu
 
 It is also possible to override one of the default (built-in) nav menu sections or items. This can be useful for example if you wish to provide a completely different implementation of the product list view.
 
-This is done by setting the `id` property to that of an existing nav menu section or item.
+This is done by setting the `id` property to that of an existing nav menu section or item. The `id` can be found by inspecting the link element in your browser's dev tools for the `data-item-id` attribute:
+
+![Navbar menu id](./nav-menu-id.webp)
+
+## Removing existing nav items
+
+If you would like to remove an existing nav item, you can do so by overriding it and setting the `requiresPermission` property to an invalid value:
+
+```ts title="src/plugins/greeter/ui/providers.ts"
+import { SharedModule, addNavMenuItem} from '@vendure/admin-ui/core';
+
+export default [
+    addNavMenuItem({
+        id: 'collections',  // <-- we will override the "collections" menu item
+        label: 'Collections',
+        routerLink: ['/catalog', 'collections'],
+        // highlight-start
+        // we use an invalid permission which ensures it is hidden from all users
+        requiresPermission: '__disable__'
+        // highlight-end
+    },
+    'catalog'),
+];
+```
diff --git a/docs/docs/guides/extending-the-admin-ui/nav-menu/nav-menu-id.webp b/docs/docs/guides/extending-the-admin-ui/nav-menu/nav-menu-id.webp
new file mode 100644
index 0000000000000000000000000000000000000000..5dafda2a2fb6ee697fc2b09bda1e9ba2d7795de5
GIT binary patch
literal 42976
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

literal 0
HcmV?d00001


From 4e7b1d7c1d0cd2c4c2108138f9678f267994e36f Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 18 Oct 2023 13:11:52 +0200
Subject: [PATCH 32/49] docs: Add docs on accessing services from e2e tests

---
 .../guides/developer-guide/testing/index.md   | 35 +++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/docs/docs/guides/developer-guide/testing/index.md b/docs/docs/guides/developer-guide/testing/index.md
index 40c7d3b994..a07aef1b1e 100644
--- a/docs/docs/guides/developer-guide/testing/index.md
+++ b/docs/docs/guides/developer-guide/testing/index.md
@@ -210,3 +210,38 @@ describe('my plugin', () => {
 });
 ```
 :::
+
+## Accessing internal services
+
+It is possible to access any internal service of the Vendure server via the `server.app` object, which is an instance of the NestJS `INestApplication`.
+
+For example, to access the `ProductService`:
+
+```ts title="src/plugins/my-plugin/e2e/my-plugin.e2e-spec.ts"
+import { createTestEnvironment, testConfig } from '@vendure/testing';
+import { describe, beforeAll } from 'vitest';
+import { MyPlugin } from '../my-plugin.ts';
+
+describe('my plugin', () => {
+    
+    const { server, adminClient, shopClient } = createTestEnvironment({
+        ...testConfig,
+        plugins: [MyPlugin],
+    });
+    
+    // highlight-next-line
+    let productService: ProductService;
+    
+    beforeAll(async () => {
+        await server.init({
+            productsCsvPath: path.join(__dirname, 'fixtures/e2e-products.csv'),
+            initialData: myInitialData,
+            customerCount: 2,
+        });
+        await adminClient.asSuperAdmin();
+        // highlight-next-line
+        productService = server.app.get(ProductService);
+    }, 60000);
+
+});
+```

From 3322a5633ea3215064a084d2c63993c22183812e Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 18 Oct 2023 13:26:01 +0200
Subject: [PATCH 33/49] docs: Fix scraper config

---
 docs/scraper/config.json | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/scraper/config.json b/docs/scraper/config.json
index e37898d586..7ba0afdccb 100644
--- a/docs/scraper/config.json
+++ b/docs/scraper/config.json
@@ -1,12 +1,12 @@
 {
   "index_name": "vendure-docs",
   "start_urls": [
-    "https://vendure-docs-beta.netlify.app/"
+    "https://docs.vendure.io/"
   ],
   "sitemap_urls": [
-    "https://vendure-docs-beta.netlify.app/sitemap.xml"
+    "https://docs.vendure.io/sitemap.xml"
   ],
-  "allowed_domains":["vendure-docs-beta.netlify.app"],
+  "allowed_domains":["docs.vendure.io"],
   "sitemap_alternate_links": true,
   "stop_urls": [],
   "selectors": {

From f1753432c42c8616cd51add8629f65cc107899d6 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 18 Oct 2023 13:40:16 +0200
Subject: [PATCH 34/49] chore(test): Reinstate skipped e2e tests

---
 packages/core/e2e/order-promotion.e2e-spec.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/core/e2e/order-promotion.e2e-spec.ts b/packages/core/e2e/order-promotion.e2e-spec.ts
index 669e5301fb..359aab889b 100644
--- a/packages/core/e2e/order-promotion.e2e-spec.ts
+++ b/packages/core/e2e/order-promotion.e2e-spec.ts
@@ -1663,7 +1663,7 @@ describe('Promotions applied to Orders', () => {
         });
     });
 
-    describe.only('usage limit', () => {
+    describe('usage limit', () => {
         const TEST_COUPON_CODE = 'TESTCOUPON';
         const orderGuard: ErrorResultGuard<CodegenShop.TestOrderWithPaymentsFragment> =
             createErrorResultGuard(input => !!input.lines);

From b99d238ad35a0d2c843fb84d7f1b6441cd11d923 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 18 Oct 2023 13:40:46 +0200
Subject: [PATCH 35/49] chore(core): tidy up unused imports

---
 packages/core/src/service/services/product.service.ts | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/packages/core/src/service/services/product.service.ts b/packages/core/src/service/services/product.service.ts
index 39ec1c63c3..eedbde2b17 100644
--- a/packages/core/src/service/services/product.service.ts
+++ b/packages/core/src/service/services/product.service.ts
@@ -2,7 +2,6 @@ import { Injectable } from '@nestjs/common';
 import {
     AssignProductsToChannelInput,
     CreateProductInput,
-    CustomerListOptions,
     DeletionResponse,
     DeletionResult,
     ProductListOptions,
@@ -41,12 +40,9 @@ import { TranslatorService } from '../helpers/translator/translator.service';
 
 import { AssetService } from './asset.service';
 import { ChannelService } from './channel.service';
-import { CollectionService } from './collection.service';
 import { FacetValueService } from './facet-value.service';
 import { ProductOptionGroupService } from './product-option-group.service';
 import { ProductVariantService } from './product-variant.service';
-import { RoleService } from './role.service';
-import { TaxRateService } from './tax-rate.service';
 
 /**
  * @description
@@ -61,12 +57,9 @@ export class ProductService {
     constructor(
         private connection: TransactionalConnection,
         private channelService: ChannelService,
-        private roleService: RoleService,
         private assetService: AssetService,
         private productVariantService: ProductVariantService,
         private facetValueService: FacetValueService,
-        private taxRateService: TaxRateService,
-        private collectionService: CollectionService,
         private listQueryBuilder: ListQueryBuilder,
         private translatableSaver: TranslatableSaver,
         private eventBus: EventBus,

From d3d4bb2f226a866f3c941f49f08a81458707e402 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 18 Oct 2023 14:02:20 +0200
Subject: [PATCH 36/49] chore(admin-ui): Fix circular import

---
 .../src/lib/core/src/providers/alerts/alerts.service.ts        | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/admin-ui/src/lib/core/src/providers/alerts/alerts.service.ts b/packages/admin-ui/src/lib/core/src/providers/alerts/alerts.service.ts
index 25e41d66c7..bd555a9985 100644
--- a/packages/admin-ui/src/lib/core/src/providers/alerts/alerts.service.ts
+++ b/packages/admin-ui/src/lib/core/src/providers/alerts/alerts.service.ts
@@ -11,7 +11,8 @@ import {
     switchMap,
 } from 'rxjs';
 import { filter, first, map, mapTo, startWith, take } from 'rxjs/operators';
-import { DataService, Permission } from '../../public_api';
+import { Permission } from '../../common/generated-types';
+import { DataService } from '../../data/providers/data.service';
 
 export interface AlertConfig<T = any> {
     id: string;

From 716d967f10b81df735400a55ca01598d8a2ccb8b Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Wed, 18 Oct 2023 14:05:36 +0200
Subject: [PATCH 37/49] chore: Publish v2.1.1

---
 CHANGELOG.md                                  | 28 +++++++++++++++++++
 lerna.json                                    |  2 +-
 packages/admin-ui-plugin/package.json         |  6 ++--
 packages/admin-ui/package-lock.json           |  2 +-
 packages/admin-ui/package.json                |  4 +--
 .../src/lib/core/src/common/version.ts        |  2 +-
 packages/asset-server-plugin/package.json     |  6 ++--
 packages/cli/package.json                     |  4 +--
 packages/common/package.json                  |  2 +-
 packages/core/package.json                    |  4 +--
 packages/create/package.json                  |  6 ++--
 packages/dev-server/package.json              | 18 ++++++------
 packages/elasticsearch-plugin/package.json    |  6 ++--
 packages/email-plugin/package.json            |  6 ++--
 packages/harden-plugin/package.json           |  6 ++--
 packages/job-queue-plugin/package.json        |  6 ++--
 packages/payments-plugin/package.json         |  8 +++---
 packages/testing/package.json                 |  6 ++--
 packages/ui-devkit/package.json               |  8 +++---
 19 files changed, 79 insertions(+), 51 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 91acedbcf5..ec9b40caf8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,31 @@
+## <small>2.1.1 (2023-10-18)</small>
+
+
+#### Fixes
+
+* **admin-ui** Add missing RTL compatibility to some admin-ui components (#2451) ([ec61b58](https://github.com/vendure-ecommerce/vendure/commit/ec61b58)), closes [#2451](https://github.com/vendure-ecommerce/vendure/issues/2451)
+* **admin-ui** Add unique location id for prod detail variants table ([ce2b251](https://github.com/vendure-ecommerce/vendure/commit/ce2b251))
+* **admin-ui** Do not load pending search index updates if permissions are insufficient (#2460) ([08ad982](https://github.com/vendure-ecommerce/vendure/commit/08ad982)), closes [#2460](https://github.com/vendure-ecommerce/vendure/issues/2460) [#2456](https://github.com/vendure-ecommerce/vendure/issues/2456)
+* **admin-ui** Fix customer group select input ([02fe6ae](https://github.com/vendure-ecommerce/vendure/commit/02fe6ae)), closes [#2441](https://github.com/vendure-ecommerce/vendure/issues/2441)
+* **admin-ui** Fix initial render of code editor input marking dirty ([9dda349](https://github.com/vendure-ecommerce/vendure/commit/9dda349))
+* **admin-ui** Fix setting facet values on new product ([9d88db2](https://github.com/vendure-ecommerce/vendure/commit/9d88db2)), closes [#2355](https://github.com/vendure-ecommerce/vendure/issues/2355)
+* **admin-ui** Improve Italian translations (#2445) ([3fd93c7](https://github.com/vendure-ecommerce/vendure/commit/3fd93c7)), closes [#2445](https://github.com/vendure-ecommerce/vendure/issues/2445)
+* **admin-ui** Improvements to Nepali translation (#2463) ([4035fda](https://github.com/vendure-ecommerce/vendure/commit/4035fda)), closes [#2463](https://github.com/vendure-ecommerce/vendure/issues/2463)
+* **admin-ui** Make ExtensionHostComponent work with new extension APIs ([b917e62](https://github.com/vendure-ecommerce/vendure/commit/b917e62))
+* **admin-ui** Make utility margin/padding classes RTL-compatible ([74c6634](https://github.com/vendure-ecommerce/vendure/commit/74c6634))
+* **common** Remove trademark symbols from normalized strings (#2447) ([9aac191](https://github.com/vendure-ecommerce/vendure/commit/9aac191)), closes [#2447](https://github.com/vendure-ecommerce/vendure/issues/2447)
+* **core** Fix custom field resolver for eager translatable relation (#2457) ([09dd7df](https://github.com/vendure-ecommerce/vendure/commit/09dd7df)), closes [#2453](https://github.com/vendure-ecommerce/vendure/issues/2453)
+* **core** Fix regression in ProductService.findOne not using relations ([92cad43](https://github.com/vendure-ecommerce/vendure/commit/92cad43)), closes [#2443](https://github.com/vendure-ecommerce/vendure/issues/2443)
+* **core** Normalize email address on updating Customer ([957d0ad](https://github.com/vendure-ecommerce/vendure/commit/957d0ad)), closes [#2449](https://github.com/vendure-ecommerce/vendure/issues/2449)
+* **payments-plugin** Fix Mollie klarna AutoCapture (#2446) ([8db459a](https://github.com/vendure-ecommerce/vendure/commit/8db459a)), closes [#2446](https://github.com/vendure-ecommerce/vendure/issues/2446)
+* **payments-plugin** Fix Stripe controller crashing server instance (#2454) ([b0ece21](https://github.com/vendure-ecommerce/vendure/commit/b0ece21)), closes [#2454](https://github.com/vendure-ecommerce/vendure/issues/2454) [#2450](https://github.com/vendure-ecommerce/vendure/issues/2450)
+* **payments-plugin** Idempotent 'paid' Mollie webhooks (#2462) ([2f7a8d5](https://github.com/vendure-ecommerce/vendure/commit/2f7a8d5)), closes [#2462](https://github.com/vendure-ecommerce/vendure/issues/2462)
+
+#### Features
+
+* **admin-ui** Add Croatian translation (#2442) ([b594c55](https://github.com/vendure-ecommerce/vendure/commit/b594c55)), closes [#2442](https://github.com/vendure-ecommerce/vendure/issues/2442)
+* **admin-ui** Add product slug in product multi selector dialog component (#2461) ([b7f3452](https://github.com/vendure-ecommerce/vendure/commit/b7f3452)), closes [#2461](https://github.com/vendure-ecommerce/vendure/issues/2461)
+
 ## 2.1.0 (2023-10-11)
 
 
diff --git a/lerna.json b/lerna.json
index 9bd1a14a2b..5724fa51b1 100644
--- a/lerna.json
+++ b/lerna.json
@@ -1,6 +1,6 @@
 {
     "packages": ["packages/*"],
-    "version": "2.1.0",
+    "version": "2.1.1",
     "npmClient": "yarn",
     "command": {
         "version": {
diff --git a/packages/admin-ui-plugin/package.json b/packages/admin-ui-plugin/package.json
index 5ba4b10852..a3c4abf95f 100644
--- a/packages/admin-ui-plugin/package.json
+++ b/packages/admin-ui-plugin/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@vendure/admin-ui-plugin",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "main": "lib/index.js",
     "types": "lib/index.d.ts",
     "files": [
@@ -21,8 +21,8 @@
     "devDependencies": {
         "@types/express": "^4.17.8",
         "@types/fs-extra": "^9.0.1",
-        "@vendure/common": "^2.1.0",
-        "@vendure/core": "^2.1.0",
+        "@vendure/common": "^2.1.1",
+        "@vendure/core": "^2.1.1",
         "express": "^4.17.1",
         "rimraf": "^3.0.2",
         "typescript": "4.9.5"
diff --git a/packages/admin-ui/package-lock.json b/packages/admin-ui/package-lock.json
index c4e21caa31..28c7689beb 100644
--- a/packages/admin-ui/package-lock.json
+++ b/packages/admin-ui/package-lock.json
@@ -1,6 +1,6 @@
 {
     "name": "@vendure/admin-ui",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "lockfileVersion": 1,
     "requires": true,
     "dependencies": {
diff --git a/packages/admin-ui/package.json b/packages/admin-ui/package.json
index ff463be840..ea8074581c 100644
--- a/packages/admin-ui/package.json
+++ b/packages/admin-ui/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@vendure/admin-ui",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "license": "MIT",
     "scripts": {
         "ng": "ng",
@@ -49,7 +49,7 @@
         "@ng-select/ng-select": "^11.1.1",
         "@ngx-translate/core": "^15.0.0",
         "@ngx-translate/http-loader": "^8.0.0",
-        "@vendure/common": "^2.1.0",
+        "@vendure/common": "^2.1.1",
         "@webcomponents/custom-elements": "^1.6.0",
         "apollo-angular": "^5.0.0",
         "apollo-upload-client": "^17.0.0",
diff --git a/packages/admin-ui/src/lib/core/src/common/version.ts b/packages/admin-ui/src/lib/core/src/common/version.ts
index 21801009be..88bd71ebae 100644
--- a/packages/admin-ui/src/lib/core/src/common/version.ts
+++ b/packages/admin-ui/src/lib/core/src/common/version.ts
@@ -1,2 +1,2 @@
 // Auto-generated by the set-version.js script.
-export const ADMIN_UI_VERSION = '2.1.0';
+export const ADMIN_UI_VERSION = '2.1.1';
diff --git a/packages/asset-server-plugin/package.json b/packages/asset-server-plugin/package.json
index 6b27108c83..318d6ad8e3 100644
--- a/packages/asset-server-plugin/package.json
+++ b/packages/asset-server-plugin/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@vendure/asset-server-plugin",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "main": "lib/index.js",
     "types": "lib/index.d.ts",
     "files": [
@@ -27,8 +27,8 @@
         "@types/fs-extra": "^11.0.1",
         "@types/node-fetch": "^2.5.8",
         "@types/sharp": "^0.30.4",
-        "@vendure/common": "^2.1.0",
-        "@vendure/core": "^2.1.0",
+        "@vendure/common": "^2.1.1",
+        "@vendure/core": "^2.1.1",
         "express": "^4.17.1",
         "node-fetch": "^2.6.7",
         "rimraf": "^3.0.2",
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 409608ff51..197fb88c0b 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@vendure/cli",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "description": "A modern, headless ecommerce framework",
     "repository": {
         "type": "git",
@@ -34,7 +34,7 @@
     ],
     "dependencies": {
         "@clack/prompts": "^0.7.0",
-        "@vendure/common": "^2.1.0",
+        "@vendure/common": "^2.1.1",
         "change-case": "^4.1.2",
         "commander": "^11.0.0",
         "fs-extra": "^11.1.1",
diff --git a/packages/common/package.json b/packages/common/package.json
index 9dd9f71ca0..79c2599900 100644
--- a/packages/common/package.json
+++ b/packages/common/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@vendure/common",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "main": "index.js",
     "license": "MIT",
     "scripts": {
diff --git a/packages/core/package.json b/packages/core/package.json
index 1c4898183f..7483451985 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@vendure/core",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "description": "A modern, headless ecommerce framework",
     "repository": {
         "type": "git",
@@ -50,7 +50,7 @@
         "@nestjs/testing": "10.2.1",
         "@nestjs/typeorm": "10.0.0",
         "@types/fs-extra": "^9.0.1",
-        "@vendure/common": "^2.1.0",
+        "@vendure/common": "^2.1.1",
         "bcrypt": "^5.1.1",
         "body-parser": "^1.20.2",
         "chalk": "^4.1.2",
diff --git a/packages/create/package.json b/packages/create/package.json
index 2f8d9a596d..bf8aa2a55b 100644
--- a/packages/create/package.json
+++ b/packages/create/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@vendure/create",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "license": "MIT",
     "bin": {
         "create": "./index.js"
@@ -28,14 +28,14 @@
         "@types/fs-extra": "^9.0.1",
         "@types/handlebars": "^4.1.0",
         "@types/semver": "^6.2.2",
-        "@vendure/core": "^2.1.0",
+        "@vendure/core": "^2.1.1",
         "rimraf": "^3.0.2",
         "ts-node": "^10.9.1",
         "typescript": "4.9.5"
     },
     "dependencies": {
         "@clack/prompts": "^0.7.0",
-        "@vendure/common": "^2.1.0",
+        "@vendure/common": "^2.1.1",
         "commander": "^11.0.0",
         "cross-spawn": "^7.0.3",
         "detect-port": "^1.5.1",
diff --git a/packages/dev-server/package.json b/packages/dev-server/package.json
index 1aa2769554..caea610c79 100644
--- a/packages/dev-server/package.json
+++ b/packages/dev-server/package.json
@@ -1,6 +1,6 @@
 {
     "name": "dev-server",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "main": "index.js",
     "license": "MIT",
     "private": true,
@@ -15,18 +15,18 @@
     },
     "dependencies": {
         "@nestjs/axios": "^3.0.0",
-        "@vendure/admin-ui-plugin": "^2.1.0",
-        "@vendure/asset-server-plugin": "^2.1.0",
-        "@vendure/common": "^2.1.0",
-        "@vendure/core": "^2.1.0",
-        "@vendure/elasticsearch-plugin": "^2.1.0",
-        "@vendure/email-plugin": "^2.1.0",
+        "@vendure/admin-ui-plugin": "^2.1.1",
+        "@vendure/asset-server-plugin": "^2.1.1",
+        "@vendure/common": "^2.1.1",
+        "@vendure/core": "^2.1.1",
+        "@vendure/elasticsearch-plugin": "^2.1.1",
+        "@vendure/email-plugin": "^2.1.1",
         "typescript": "4.9.5"
     },
     "devDependencies": {
         "@types/csv-stringify": "^3.1.0",
-        "@vendure/testing": "^2.1.0",
-        "@vendure/ui-devkit": "^2.1.0",
+        "@vendure/testing": "^2.1.1",
+        "@vendure/ui-devkit": "^2.1.1",
         "commander": "^7.1.0",
         "concurrently": "^8.2.1",
         "csv-stringify": "^5.3.3",
diff --git a/packages/elasticsearch-plugin/package.json b/packages/elasticsearch-plugin/package.json
index 94da42c572..53f615cff4 100644
--- a/packages/elasticsearch-plugin/package.json
+++ b/packages/elasticsearch-plugin/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@vendure/elasticsearch-plugin",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "license": "MIT",
     "main": "lib/index.js",
     "types": "lib/index.d.ts",
@@ -26,8 +26,8 @@
         "fast-deep-equal": "^3.1.3"
     },
     "devDependencies": {
-        "@vendure/common": "^2.1.0",
-        "@vendure/core": "^2.1.0",
+        "@vendure/common": "^2.1.1",
+        "@vendure/core": "^2.1.1",
         "rimraf": "^3.0.2",
         "typescript": "4.9.5"
     }
diff --git a/packages/email-plugin/package.json b/packages/email-plugin/package.json
index d7483ee81f..d23d7ce15e 100644
--- a/packages/email-plugin/package.json
+++ b/packages/email-plugin/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@vendure/email-plugin",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "license": "MIT",
     "main": "lib/index.js",
     "types": "lib/index.d.ts",
@@ -35,8 +35,8 @@
         "@types/fs-extra": "^9.0.1",
         "@types/handlebars": "^4.1.0",
         "@types/mjml": "^4.0.4",
-        "@vendure/common": "^2.1.0",
-        "@vendure/core": "^2.1.0",
+        "@vendure/common": "^2.1.1",
+        "@vendure/core": "^2.1.1",
         "rimraf": "^3.0.2",
         "typescript": "4.9.5"
     }
diff --git a/packages/harden-plugin/package.json b/packages/harden-plugin/package.json
index 5b2f3231f9..0965c47fa9 100644
--- a/packages/harden-plugin/package.json
+++ b/packages/harden-plugin/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@vendure/harden-plugin",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "license": "MIT",
     "main": "lib/index.js",
     "types": "lib/index.d.ts",
@@ -21,7 +21,7 @@
         "graphql-query-complexity": "^0.12.0"
     },
     "devDependencies": {
-        "@vendure/common": "^2.1.0",
-        "@vendure/core": "^2.1.0"
+        "@vendure/common": "^2.1.1",
+        "@vendure/core": "^2.1.1"
     }
 }
diff --git a/packages/job-queue-plugin/package.json b/packages/job-queue-plugin/package.json
index ddb2369f02..4e9b005405 100644
--- a/packages/job-queue-plugin/package.json
+++ b/packages/job-queue-plugin/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@vendure/job-queue-plugin",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "license": "MIT",
     "main": "package/index.js",
     "types": "package/index.d.ts",
@@ -23,8 +23,8 @@
     },
     "devDependencies": {
         "@google-cloud/pubsub": "^2.8.0",
-        "@vendure/common": "^2.1.0",
-        "@vendure/core": "^2.1.0",
+        "@vendure/common": "^2.1.1",
+        "@vendure/core": "^2.1.1",
         "bullmq": "^3.15.5",
         "ioredis": "^5.3.0",
         "rimraf": "^3.0.2",
diff --git a/packages/payments-plugin/package.json b/packages/payments-plugin/package.json
index 5fdb5aa68e..16c28c91dc 100644
--- a/packages/payments-plugin/package.json
+++ b/packages/payments-plugin/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@vendure/payments-plugin",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "license": "MIT",
     "main": "package/index.js",
     "types": "package/index.d.ts",
@@ -46,9 +46,9 @@
         "@mollie/api-client": "^3.7.0",
         "@types/braintree": "^2.22.15",
         "@types/localtunnel": "2.0.1",
-        "@vendure/common": "^2.1.0",
-        "@vendure/core": "^2.1.0",
-        "@vendure/testing": "^2.1.0",
+        "@vendure/common": "^2.1.1",
+        "@vendure/core": "^2.1.1",
+        "@vendure/testing": "^2.1.1",
         "braintree": "^3.16.0",
         "localtunnel": "2.0.2",
         "nock": "^13.1.4",
diff --git a/packages/testing/package.json b/packages/testing/package.json
index ad56b6c0de..14482bedf3 100644
--- a/packages/testing/package.json
+++ b/packages/testing/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@vendure/testing",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "description": "End-to-end testing tools for Vendure projects",
     "keywords": [
         "vendure",
@@ -38,7 +38,7 @@
     "dependencies": {
         "@graphql-typed-document-node/core": "^3.2.0",
         "@types/node-fetch": "^2.6.4",
-        "@vendure/common": "^2.1.0",
+        "@vendure/common": "^2.1.1",
         "faker": "^4.1.0",
         "form-data": "^4.0.0",
         "graphql": "16.8.0",
@@ -49,7 +49,7 @@
     "devDependencies": {
         "@types/mysql": "^2.15.15",
         "@types/pg": "^7.14.5",
-        "@vendure/core": "^2.1.0",
+        "@vendure/core": "^2.1.1",
         "mysql": "^2.18.1",
         "pg": "^8.4.0",
         "rimraf": "^3.0.0",
diff --git a/packages/ui-devkit/package.json b/packages/ui-devkit/package.json
index 98b5fc6e78..7b68262844 100644
--- a/packages/ui-devkit/package.json
+++ b/packages/ui-devkit/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@vendure/ui-devkit",
-    "version": "2.1.0",
+    "version": "2.1.1",
     "description": "A library for authoring Vendure Admin UI extensions",
     "keywords": [
         "vendure",
@@ -40,8 +40,8 @@
         "@angular/cli": "^16.2.0",
         "@angular/compiler": "^16.2.2",
         "@angular/compiler-cli": "^16.2.2",
-        "@vendure/admin-ui": "^2.1.0",
-        "@vendure/common": "^2.1.0",
+        "@vendure/admin-ui": "^2.1.1",
+        "@vendure/common": "^2.1.1",
         "chalk": "^4.1.0",
         "chokidar": "^3.5.3",
         "fs-extra": "^11.1.1",
@@ -51,7 +51,7 @@
     "devDependencies": {
         "@rollup/plugin-node-resolve": "^15.2.1",
         "@types/fs-extra": "^11.0.1",
-        "@vendure/core": "^2.1.0",
+        "@vendure/core": "^2.1.1",
         "react": "^18.2.0",
         "react-dom": "^18.2.0",
         "rimraf": "^3.0.2",

From 5821abb318705dbca5cf76a73597b61bf5eb9638 Mon Sep 17 00:00:00 2001
From: Lacey Pevey <7490308+pevey@users.noreply.github.com>
Date: Sat, 21 Oct 2023 13:38:53 -0600
Subject: [PATCH 38/49] docs: Add Missing Closing Parentheses on
 TransitionToState Example Mutation (#2475)

---
 docs/docs/guides/storefront/checkout-flow/index.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/docs/guides/storefront/checkout-flow/index.mdx b/docs/docs/guides/storefront/checkout-flow/index.mdx
index 0005193f04..26c8a5c554 100644
--- a/docs/docs/guides/storefront/checkout-flow/index.mdx
+++ b/docs/docs/guides/storefront/checkout-flow/index.mdx
@@ -308,7 +308,7 @@ while the payment is being arranged. The [`transitionOrderToState`](/reference/g
 <TabItem value="Query" label="Query" default>
 
 ```graphql
-mutation TransitionToState($state: String!)
+mutation TransitionToState($state: String!) {
   transitionOrderToState(state: $state) {
     ...ActiveOrder
     ...on OrderStateTransitionError {

From ffe0039f97e20e89b3eb199ab60014d352274edb Mon Sep 17 00:00:00 2001
From: Lacey Pevey <7490308+pevey@users.noreply.github.com>
Date: Sat, 21 Oct 2023 13:40:06 -0600
Subject: [PATCH 39/49] docs: Add missing words (benefits from) in tech stack
 description (#2476)

---
 docs/docs/guides/developer-guide/overview/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/docs/guides/developer-guide/overview/index.md b/docs/docs/guides/developer-guide/overview/index.md
index 2fff5d6d84..c998cffbb5 100644
--- a/docs/docs/guides/developer-guide/overview/index.md
+++ b/docs/docs/guides/developer-guide/overview/index.md
@@ -24,7 +24,7 @@ Vendure is built on the following open-source technologies:
 
 - **SQL Database**: Vendure requires an SQL database compatible with [TypeORM](https://typeorm.io/). Officially we support **PostgreSQL**, **MySQL/MariaDB** and **SQLite** but Vendure can also be used with API-compatible variants such [Amazon Aurora](https://aws.amazon.com/rds/aurora/), [CockroachDB](https://www.cockroachlabs.com/), or [PlanetScale](https://planetscale.com/).
 - **TypeScript & Node.js**: Vendure is written in [TypeScript](https://www.typescriptlang.org/) and runs on [Node.js](https://nodejs.org).
-- **NestJS**: The underlying framework is [NestJS](https://nestjs.com/), which is a full-featured application development framework for Node.js. Building on NestJS means that Vendure from the well-defined structure and rich feature-set and ecosystem that NestJS provides.
+- **NestJS**: The underlying framework is [NestJS](https://nestjs.com/), which is a full-featured application development framework for Node.js. Building on NestJS means that Vendure benefits from the well-defined structure and rich feature-set and ecosystem that NestJS provides.
 - **GraphQL**: The Shop and Admin APIs use [GraphQL](https://graphql.org/), which is a modern API technology which allows you to specify the exact data that your client application needs in a convenient and type-safe way. Internally we use [Apollo Server](https://www.apollographql.com/docs/apollo-server/) to power our GraphQL APIs.
 - **Angular**: The Admin UI is built with [Angular](https://angular.io/), a popular, stable application framework from Google. Note that you do not need to know Angular to use Vendure, and UI extensions can even be written in the front-end framework of your choice, such as React or Vue.
 

From 19e735408eb5494f08e92be2124ac9b70f609325 Mon Sep 17 00:00:00 2001
From: Lacey Pevey <7490308+pevey@users.noreply.github.com>
Date: Mon, 23 Oct 2023 01:46:05 -0600
Subject: [PATCH 40/49] docs: Add missing word in docs (#2479)

---
 docs/docs/guides/developer-guide/rest-endpoint/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/docs/guides/developer-guide/rest-endpoint/index.md b/docs/docs/guides/developer-guide/rest-endpoint/index.md
index 2c8dd12e8d..32f033baba 100644
--- a/docs/docs/guides/developer-guide/rest-endpoint/index.md
+++ b/docs/docs/guides/developer-guide/rest-endpoint/index.md
@@ -9,7 +9,7 @@ REST-style endpoints can be defined as part of a [plugin](/guides/developer-guid
 REST endpoints are implemented as NestJS Controllers. For comprehensive documentation, see the [NestJS controllers documentation](https://docs.nestjs.com/controllers).
 :::
 
-In this guide we will define a plugin adds a single REST endpoint at `http://localhost:3000/products` which returns a list of all products.
+In this guide we will define a plugin that adds a single REST endpoint at `http://localhost:3000/products` which returns a list of all products.
 
 ## Create a controller
 

From 218561f04cbaf738c0f18302b67b1b077a056a7f Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Mon, 23 Oct 2023 09:50:00 +0200
Subject: [PATCH 41/49] docs: Add breaking change note to readme

---
 CHANGELOG.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ec9b40caf8..b869b886cc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -110,6 +110,8 @@ https://www.apollographql.com/docs/apollo-server/migration/
 
 * The ForbiddenError now defaults to a "warning" rather than "error" log level. Previously this was causing too much noise in logging services and the new level better reflects the severity of the error.
 
+* If after update you are running into the error `[GraphQL error]: Message: POST body missing, invalid Content-Type, or JSON object has no keys.`, this may be due to having the [body-parser](https://www.npmjs.com/package/body-parser) `json` middleware configured in your app. You should be able to safely remove this middleware in order to resolve the issue.
+
 ## <small>2.0.10 (2023-10-11)</small>
 
 

From c639ab69f8a73077593d9c9f5e5cf5b16090c94b Mon Sep 17 00:00:00 2001
From: Martijn <martijnvdbrug@users.noreply.github.com>
Date: Wed, 25 Oct 2023 21:47:15 +0200
Subject: [PATCH 42/49] docs: PR template (#2487)

---
 .github/pull_request_template.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 .github/pull_request_template.md

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
new file mode 100644
index 0000000000..e72141f2b3
--- /dev/null
+++ b/.github/pull_request_template.md
@@ -0,0 +1,22 @@
+# Description
+
+Please include a summary of the changes and the related issue.
+
+# Breaking changes
+
+Does this PR include any breaking changes we should be aware of?
+
+# Screenshots
+
+You can add screenshots here if applicable.
+
+# Checklist
+
+:pushpin: Always:
+- [ ] I have set a clear title
+- [ ] My PR is small and contains a single feature
+- [ ] I have [checked my own PR](## "Fix typo's and remove unused or commented out code")
+
+:zap: Most of the time:
+- [ ] I have added or updated test cases
+- [ ] I have updated the README if needed
\ No newline at end of file

From a2998bebd7b300154f979689a85acc3ba5acc46e Mon Sep 17 00:00:00 2001
From: Daniel Biegler <DanielBiegler@users.noreply.github.com>
Date: Fri, 27 Oct 2023 10:41:50 +0200
Subject: [PATCH 43/49] docs: Fix tanstack responseMiddleware (#2489)

---
 docs/docs/guides/storefront/connect-api/index.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/docs/guides/storefront/connect-api/index.mdx b/docs/docs/guides/storefront/connect-api/index.mdx
index 35799925ae..0aad8e05ff 100644
--- a/docs/docs/guides/storefront/connect-api/index.mdx
+++ b/docs/docs/guides/storefront/connect-api/index.mdx
@@ -536,7 +536,7 @@ const requestMiddleware: RequestMiddleware = async (request) => {
 
 // Check all responses for a new session token
 const responseMiddleware: ResponseMiddleware = (response) => {
-    if (!(response instanceof Error) && response.errors) {
+    if (!(response instanceof Error) && !response.errors) {
         const authHeader = response.headers.get('vendure-auth-token');
         if (authHeader) {
             // If the session token has been returned by the Vendure

From e4d1545edaec17d580cb8554befd78b38087f135 Mon Sep 17 00:00:00 2001
From: HoseinGhanbari <31586783+HoseinGhanbari@users.noreply.github.com>
Date: Fri, 27 Oct 2023 12:48:57 +0330
Subject: [PATCH 44/49] fix(admin-ui): Add some new ltr/rtl compatibility
 (#2466)

---
 .../admin-ui/src/lib/core/src/public_api.ts   |  1 +
 .../src/components/login/login.component.html |  2 +-
 .../src/components/login/login.component.scss | 28 ++++++++++++++++---
 .../src/components/login/login.component.ts   | 15 ++++++----
 4 files changed, 36 insertions(+), 10 deletions(-)

diff --git a/packages/admin-ui/src/lib/core/src/public_api.ts b/packages/admin-ui/src/lib/core/src/public_api.ts
index 8e6acb6291..0d33c245b8 100644
--- a/packages/admin-ui/src/lib/core/src/public_api.ts
+++ b/packages/admin-ui/src/lib/core/src/public_api.ts
@@ -113,6 +113,7 @@ export * from './providers/i18n/custom-message-format-compiler';
 export * from './providers/i18n/i18n.service';
 export * from './providers/job-queue/job-queue.service';
 export * from './providers/local-storage/local-storage.service';
+export * from './providers/localization/localization.service';
 export * from './providers/modal/modal.service';
 export * from './providers/modal/modal.types';
 export * from './providers/nav-builder/nav-builder-types';
diff --git a/packages/admin-ui/src/lib/login/src/components/login/login.component.html b/packages/admin-ui/src/lib/login/src/components/login/login.component.html
index 5651dc490c..0f8a870f17 100644
--- a/packages/admin-ui/src/lib/login/src/components/login/login.component.html
+++ b/packages/admin-ui/src/lib/login/src/components/login/login.component.html
@@ -1,4 +1,4 @@
-<div class="login-wrapper">
+<div class="login-wrapper" [dir]="direction$ | async">
     <div class="login-wrapper-inner">
         <div class="login-wrapper-image">
             <div class="login-wrapper-image-content">
diff --git a/packages/admin-ui/src/lib/login/src/components/login/login.component.scss b/packages/admin-ui/src/lib/login/src/components/login/login.component.scss
index 3ef1cfa4a8..97c3ae3161 100644
--- a/packages/admin-ui/src/lib/login/src/components/login/login.component.scss
+++ b/packages/admin-ui/src/lib/login/src/components/login/login.component.scss
@@ -10,6 +10,8 @@
     padding: 20px;
 
     .login-wrapper-inner {
+
+
         background: #fff;
         width: 1120px;
         height: 590px;
@@ -53,8 +55,8 @@
                 left: 0;
                 bottom: 0;
                 z-index: 10;
-                background: rgb(2,0,36);
-                background: linear-gradient(180deg, rgba(2,0,36,0) 0%, rgba(0,0,0,0.75) 100%);
+                background: rgb(2, 0, 36);
+                background: linear-gradient(180deg, rgba(2, 0, 36, 0) 0%, rgba(0, 0, 0, 0.75) 100%);
                 display: flex;
                 flex-direction: column;
                 align-items: flex-start;
@@ -74,13 +76,14 @@
 
                 .login-wrapper-image-copyright {
                     opacity: 0.8;
+
                     p {
                         font-size: 0.6rem;
                         color: white;
                         margin: 0 !important;
                     }
 
-                    a{
+                    a {
                         color: white;
                         text-decoration: underline;
                     }
@@ -96,7 +99,7 @@
             flex-direction: column;
             align-items: stretch;
             justify-content: center;
-            box-shadow: 0px 20px 25px rgba(0,0,0,0.1);
+            box-shadow: 0px 20px 25px rgba(0, 0, 0, 0.1);
             overflow: hidden;
             border-radius: 5px;
             flex-shrink: 0;
@@ -182,6 +185,7 @@
 }
 
 @keyframes shake {
+
     10%,
     90% {
         transform: translate3d(-1px, 0, 0);
@@ -203,3 +207,19 @@
         transform: translate3d(4px, 0, 0);
     }
 }
+
+.login-wrapper[dir="rtl"] {
+    .login-wrapper-inner {
+        .login-wrapper-logo {
+            right: auto;
+            left: 20px;
+        }
+
+        .login-wrapper-image {
+            .login-wrapper-image-content {
+                left: auto;
+                right: 0;
+            }
+        }
+    }
+}
\ No newline at end of file
diff --git a/packages/admin-ui/src/lib/login/src/components/login/login.component.ts b/packages/admin-ui/src/lib/login/src/components/login/login.component.ts
index 6f47de67e7..e3427e984d 100644
--- a/packages/admin-ui/src/lib/login/src/components/login/login.component.ts
+++ b/packages/admin-ui/src/lib/login/src/components/login/login.component.ts
@@ -1,14 +1,16 @@
-import { HttpClient, HttpParams } from '@angular/common/http';
-import { Component } from '@angular/core';
+import { HttpClient } from '@angular/common/http';
+import { Component, OnInit } from '@angular/core';
 import { Router } from '@angular/router';
-import { ADMIN_UI_VERSION, AuthService, AUTH_REDIRECT_PARAM, getAppConfig } from '@vendure/admin-ui/core';
+import { ADMIN_UI_VERSION, AuthService, AUTH_REDIRECT_PARAM, getAppConfig, LocalizationDirectionType, LocalizationService } from '@vendure/admin-ui/core';
 
 @Component({
     selector: 'vdr-login',
     templateUrl: './login.component.html',
     styleUrls: ['./login.component.scss'],
 })
-export class LoginComponent {
+export class LoginComponent implements OnInit {
+    direction$: LocalizationDirectionType;
+
     username = '';
     password = '';
     rememberMe = false;
@@ -24,13 +26,16 @@ export class LoginComponent {
     imageCreator = '';
     imageCreatorUrl = '';
 
-    constructor(private authService: AuthService, private router: Router, private httpClient: HttpClient) {
+    constructor(private authService: AuthService, private router: Router, private httpClient: HttpClient, private localizationService: LocalizationService) {
         if (this.customImageUrl) {
             this.imageUrl = this.customImageUrl;
         } else {
             this.loadImage();
         }
     }
+    ngOnInit(): void {
+        this.direction$ = this.localizationService.direction$;
+    }
 
     logIn(): void {
         this.errorMessage = undefined;

From 47f606ccb0a63d02e6d966af861c44ee9c775ca3 Mon Sep 17 00:00:00 2001
From: jacobfrantz1 <69358280+jacobfrantz1@users.noreply.github.com>
Date: Fri, 27 Oct 2023 06:57:27 -0400
Subject: [PATCH 45/49] fix(core): Fix configurable operation id decoding when
 using uuids (#2483)

---
 packages/core/src/api/common/configurable-operation-codec.ts | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/core/src/api/common/configurable-operation-codec.ts b/packages/core/src/api/common/configurable-operation-codec.ts
index a8e920530d..170ba9761f 100644
--- a/packages/core/src/api/common/configurable-operation-codec.ts
+++ b/packages/core/src/api/common/configurable-operation-codec.ts
@@ -43,8 +43,7 @@ export class ConfigurableOperationCodec {
                         const decodedIds = ids.map(id => this.idCodecService.decode(id));
                         arg.value = JSON.stringify(decodedIds);
                     } else {
-                        const decodedId = this.idCodecService.decode(arg.value);
-                        arg.value = JSON.stringify(decodedId);
+                        arg.value = this.idCodecService.decode(arg.value);
                     }
                 }
             }

From f1a8f134a3c32bc14b31c13f322a67b56421805d Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Fri, 27 Oct 2023 11:05:15 +0200
Subject: [PATCH 46/49] docs: Fix edit docs link

---
 docs/docusaurus.config.js | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js
index 09807a6d1d..9a710fdb91 100644
--- a/docs/docusaurus.config.js
+++ b/docs/docusaurus.config.js
@@ -39,9 +39,7 @@ const config = {
                 docs: {
                     routeBasePath: '/',
                     sidebarPath: require.resolve('./sidebars.js'),
-                    // Please change this to your repo.
-                    // Remove this to remove the "edit this page" links.
-                    editUrl: 'https://github.com/vendure-ecommerce/vendure/tree/new-docs/docs/',
+                    editUrl: 'https://github.com/vendure-ecommerce/vendure/blob/master/docs/',
                     showLastUpdateTime: true,
                 },
                 blog: false,

From 1095c746c4606e99d40a5a754580af53268290be Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Fri, 27 Oct 2023 13:20:20 +0200
Subject: [PATCH 47/49] chore: Update dev db name

---
 packages/dev-server/dev-config.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/dev-server/dev-config.ts b/packages/dev-server/dev-config.ts
index ea20c748bc..becfc88aed 100644
--- a/packages/dev-server/dev-config.ts
+++ b/packages/dev-server/dev-config.ts
@@ -192,7 +192,7 @@ function getDbConfig(): DataSourceOptions {
                 port: 3306,
                 username: 'root',
                 password: '',
-                database: 'vendure2-dev',
+                database: 'vendure-dev',
             };
     }
 }

From b8c4a7703f1662ac09b4448e7428048770315702 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Fri, 27 Oct 2023 14:17:22 +0200
Subject: [PATCH 48/49] fix(admin-ui): Add descriptive error when using
 getBreadcrumbs wrong

---
 .../src/extension/register-route-component.ts     | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/packages/admin-ui/src/lib/core/src/extension/register-route-component.ts b/packages/admin-ui/src/lib/core/src/extension/register-route-component.ts
index b3f3a8e8ba..df36938b75 100644
--- a/packages/admin-ui/src/lib/core/src/extension/register-route-component.ts
+++ b/packages/admin-ui/src/lib/core/src/extension/register-route-component.ts
@@ -86,6 +86,19 @@ export function registerRouteComponent<
     const breadcrumbSubject$ = new BehaviorSubject<BreadcrumbValue>(options.breadcrumb ?? '');
     const titleSubject$ = new BehaviorSubject<string | undefined>(options.title);
 
+    if (getBreadcrumbs != null && (query == null || entityKey == null)) {
+        console.error(
+            [
+                `[${
+                    options.path ?? 'custom'
+                } route] When using the "getBreadcrumbs" option, the "query" and "entityKey" options must also be provided.`,
+                ``,
+                `Alternatively, use the "breadcrumb" option instead, or use the "PageMetadataService" inside your Angular component`,
+                `or the "usePageMetadata" React hook to set the breadcrumb.`,
+            ].join('\n'),
+        );
+    }
+
     const resolveFn:
         | ResolveFn<{
               entity: Observable<ResultOf<T>[Field] | null>;
@@ -118,7 +131,7 @@ export function registerRouteComponent<
         data: {
             breadcrumb: breadcrumbSubject$,
             ...(options.routeConfig?.data ?? {}),
-            ...(getBreadcrumbs
+            ...(getBreadcrumbs && query && entityKey
                 ? {
                       breadcrumb: data =>
                           data.detail.entity.pipe(map((entity: any) => getBreadcrumbs(entity))),

From 82535c9f60317cf51f76312b609781d64eeec799 Mon Sep 17 00:00:00 2001
From: Michael Bromley <michael@michaelbromley.co.uk>
Date: Fri, 27 Oct 2023 14:18:17 +0200
Subject: [PATCH 49/49] chore: Update dev config

---
 packages/dev-server/dev-config.ts | 37 ++++---------------------------
 1 file changed, 4 insertions(+), 33 deletions(-)

diff --git a/packages/dev-server/dev-config.ts b/packages/dev-server/dev-config.ts
index becfc88aed..7cb3fc7c12 100644
--- a/packages/dev-server/dev-config.ts
+++ b/packages/dev-server/dev-config.ts
@@ -105,21 +105,10 @@ export const devConfig: VendureConfig = {
             //     outputPath: path.join(__dirname, './custom-admin-ui'),
             //     extensions: [
             //         {
-            //             id: 'test-ui-extension',
-            //             extensionPath: path.join(__dirname, 'test-plugins/with-ui-extension/ui'),
-            //             ngModules: [
-            //                 {
-            //                     type: 'lazy',
-            //                     route: 'greetz',
-            //                     ngModuleFileName: 'greeter.module.ts',
-            //                     ngModuleName: 'GreeterModule',
-            //                 },
-            //                 {
-            //                     type: 'shared',
-            //                     ngModuleFileName: 'greeter-shared.module.ts',
-            //                     ngModuleName: 'GreeterSharedModule',
-            //                 },
-            //             ],
+            //             id: 'ui-extensions-library',
+            //             extensionPath: path.join(__dirname, 'example-plugins/ui-extensions-library/ui'),
+            //             routes: [{ route: 'ui-library', filePath: 'routes.ts' }],
+            //             providers: ['providers.ts'],
             //         },
             //         {
             //             globalStyles: path.join(
@@ -127,24 +116,6 @@ export const devConfig: VendureConfig = {
             //                 'test-plugins/with-ui-extension/ui/custom-theme.scss',
             //             ),
             //         },
-            //         {
-            //             id: 'external-ui-extension',
-            //             extensionPath: path.join(__dirname, 'test-plugins/with-external-ui-extension'),
-            //             ngModules: [
-            //                 {
-            //                     type: 'lazy',
-            //                     route: 'greet',
-            //                     ngModuleFileName: 'external-ui-extension.ts',
-            //                     ngModuleName: 'ExternalUiExtensionModule',
-            //                 },
-            //             ],
-            //             staticAssets: [
-            //                 {
-            //                     path: path.join(__dirname, 'test-plugins/with-external-ui-extension/app'),
-            //                     rename: 'external-app',
-            //                 },
-            //             ],
-            //         },
             //     ],
             //     devMode: true,
             // }),