@laioutr/app-shopware 0.14.5 → 0.15.0

package/README.md

@@ -71,6 +71,93 @@ export default defineNuxtConfig({
 in the private runtime config, and only `storefrontUrl`'s origin is exposed publicly. Read them
 from the environment rather than committing them to `nuxt.config.ts`.
 
+In a Laioutr project the same options come from the app's `config` object in `laioutrrc.json`,
+which the platform passes into this module — the `nuxt.config.ts` form above is for the playground
+and for standalone Nuxt apps.
+
+```jsonc
+// laioutrrc.json
+{
+  "apps": [
+    {
+      "name": "@laioutr/app-shopware",
+      "version": "0.14.5",
+      "config": { "endpoint": "https://shop.example.com/store-api" }
+    }
+  ]
+}
+```
+
+## Tuning the Store API reads
+
+What the app asks Shopware for, and what those reads cost, is reachable through two Nitro hooks
+rather than through config. A project's config is on its way to being editable from Studio, and
+none of this is an editor's decision: a wrong `includes` value empties an entity component with no
+error to trace it back from, and `maxLimit` describes the shop's deployment.
+
+Both are **filter** hooks, seeded with what the app would otherwise have used — register no
+handler and every read behaves exactly as it shipped.
+
+### `shopware:criteria:resolve`
+
+Fires once per store-API read that hydrates a canonical entity, carrying the projection and
+relations for that read.
+
+```ts
+// server/plugins/shopware-criteria.ts
+export default defineNitroPlugin((nitro) => {
+  nitro.hooks.hook('shopware:criteria:resolve', ({ target, result }) => {
+    if (target !== 'product') return;
+
+    result.criteria.includes.product.push('customFields');
+    result.criteria.associations.properties = { associations: { group: {} } };
+  });
+});
+```
+
+| `target` | Read |
+| --- | --- |
+| `product` | A product read, composed — the variant branch nested under it has already been through `product-variant`. |
+| `product-variant` | A standalone variant read *and* the branch nested inside a product read, so widening variants widens them everywhere. |
+| `category` | The category component resolver's read. |
+| `menu` | The navigation read behind `MenuByAliasQuery`. |
+| `product-review` | The review component resolver's read. |
+
+Reads that hydrate nothing have no target and never fire: the id-only listing queries, both page
+indexes, the breadcrumb link and the child-category link. Their payloads never reach a mapper.
+
+`category` and `menu` arrive with an empty `includes` and stay that way unless a handler fills it —
+Shopware returns whole rows when a read projects nothing. Putting a field there turns the read into
+a whitelist, which is a way to make it *smaller*, not larger.
+
+### `shopware:settings:resolve`
+
+Fires once per Orchestr request, carrying what the reads cost and how far they reach.
+
+```ts
+// server/plugins/shopware-settings.ts
+export default defineNitroPlugin((nitro) => {
+  nitro.hooks.hook('shopware:settings:resolve', ({ result }) => {
+    result.settings.maxLimit = 25;
+    result.settings.totalCountMode = 'next-pages';
+    result.settings.catalog.menuDepth = 3;
+  });
+});
+```
+
+| Setting | Default | Purpose |
+| --- | --- | --- |
+| `maxLimit` | `100` | The shop's `api.max_limit`. Page-index walks and the media library's folder read are clamped to it; a larger `limit` is rejected with a 400. |
+| `totalCountMode` | `exact` | `total-count-mode` for product listing reads. `next-pages` is markedly cheaper on a large catalog but leaves the total an estimate. |
+| `loadVariantsOnListing` | `true` | Pre-load every variant of every product on a category listing. Off, the variant resolver fetches on demand: smaller listing payloads, one extra read where the listing itself renders a variant picker. |
+| `queryTemplateLimit` | `50` | How many categories the Studio query-template picker offers. |
+| `mediaFolderLimit` | `500` | Page size for the media library's folder reads. |
+| `catalog.menuDepth` | unset | Navigation depth for menu reads. Left unset, Shopware applies its own default of two levels. |
+| `catalog.categoryPageIndex.types` | `['page']` | Shopware category `type` values the listing-page index covers. Add `'landing_page'` for shops that serve landing pages as listing pages. |
+| `catalog.categoryPageIndex.minLevel` | `1` | Only categories *deeper* than this level are indexed — the default drops the navigation roots the storefront renders as the home page and the footer menu. |
+| `catalog.categoryPageIndex.activeOnly` | `true` | Restrict the index to active categories. |
+| `catalog.seoRouteNames` | `frontend.detail.page`; `frontend.navigation.page`, `frontend.landing.page` | `seo_url.routeName` values the slug resolver accepts, per entity type. Extend it when a plugin serves detail or listing pages under its own route name. |
+
 ## Checkout
 
 The app registers a `Checkout` page type. Tag one page with it in Studio and drop the

package/dist/module.d.mts

@@ -1,4 +1,6 @@
 import { HookResult, NuxtModule } from '@nuxt/schema';
+import { ShopwareCriteriaTarget, ShopwareCriteria } from '../dist/runtime/server/types/criteria.js';
+import { ShopwareSettings } from '../dist/runtime/server/types/settings.js';
 import { H3Event } from 'h3';
 
 declare module 'vue' {
@@ -36,6 +38,19 @@ declare module 'nitropack' {
             event: H3Event;
             token: string | null;
         }) => HookResult;
+        'shopware:criteria:resolve': (args: {
+            event: H3Event;
+            target: ShopwareCriteriaTarget;
+            result: {
+                criteria: ShopwareCriteria;
+            };
+        }) => HookResult;
+        'shopware:settings:resolve': (args: {
+            event: H3Event;
+            result: {
+                settings: ShopwareSettings;
+            };
+        }) => HookResult;
     }
 }
 

package/dist/module.json

@@ -1,6 +1,6 @@
 {
   "name": "@laioutr/app-shopware",
-  "version": "0.14.5",
+  "version": "0.15.0",
   "configKey": "@laioutr/app-shopware",
   "builder": {
     "@nuxt/module-builder": "1.0.1",

package/dist/module.mjs

@@ -4,7 +4,7 @@ import { CHECKOUT_ENDPOINT_PATH, ADOPT_SESSION_ENDPOINT_PATH } from '../dist/run
 import { registerLaioutrApp } from '@laioutr-core/kit';
 
 const name = "@laioutr/app-shopware";
-const version = "0.14.5";
+const version = "0.15.0";
 
 const module$1 = defineNuxtModule({
   meta: {

package/dist/runtime/server/media-libraries/shopware.js

@@ -38,10 +38,10 @@ export const buildShopwareMediaFilters = (query) => {
   }
   return filters;
 };
-const fetchChildFolders = async (api, parentId) => {
+const fetchChildFolders = async (api, parentId, limit) => {
   const response = await api.invoke("searchMediaFolder post /search/media-folder", {
     body: {
-      limit: 500,
+      limit,
       filter: [{ type: "equals", field: "parentId", value: parentId ?? null }],
       sort: [{ field: "name", order: "ASC" }]
     }
@@ -69,7 +69,7 @@ export default defineShopware.mediaLibrary({
         ...query.term ? { query: generateSearchFilter(query.term) } : {}
       }
     });
-    const folders = query.cursor || query.scope === "all" || query.term ? void 0 : await fetchChildFolders(api, query.folderId);
+    const folders = query.cursor || query.scope === "all" || query.term ? void 0 : await fetchChildFolders(api, query.folderId, ctx.settings.mediaFolderLimit);
     const items = response.data.data?.map((media) => ({
       media: mapMedia(media),
       previewUrl: media.thumbnails?.[0]?.url ?? media.url ?? "",

package/dist/runtime/server/middleware/defineShopware.js

@@ -1,6 +1,7 @@
-import { defineOrchestr } from "#imports";
+import { defineOrchestr, useNitroApp } from "#imports";
 import { shopwareAdminClientFactory } from "../client/shopwareAdminClientFactory.js";
 import { shopwareClientFactory } from "../client/shopwareClientFactory.js";
+import { defaultShopwareSettings } from "../shopware-helper/shopwareSettings.js";
 import { getCurrentSystemEntities } from "../shopware-helper/system/getCurrentSystemEntities.js";
 import { getCachedSystemEntities } from "../shopware-helper/system/getSystemEntities.js";
 export const defineShopware = defineOrchestr.meta({
@@ -10,10 +11,18 @@ export const defineShopware = defineOrchestr.meta({
 }).extendRequest(async (args) => {
   const storefrontClient = await shopwareClientFactory(args.event);
   const adminClient = shopwareAdminClientFactory();
+  const nitro = useNitroApp();
   const systemEntities = await getCachedSystemEntities(storefrontClient);
   const currentSystemEntities = getCurrentSystemEntities(systemEntities, args.clientEnv);
   storefrontClient.defaultHeaders["sw-currency-id"] = currentSystemEntities.currency.id;
   storefrontClient.defaultHeaders["sw-language-id"] = currentSystemEntities.locale.languageId;
+  const settings = { settings: defaultShopwareSettings() };
+  await nitro.hooks.callHook("shopware:settings:resolve", { event: args.event, result: settings });
+  const resolveCriteria = async (target, criteria) => {
+    const result = { criteria };
+    await nitro.hooks.callHook("shopware:criteria:resolve", { event: args.event, target, result });
+    return result.criteria;
+  };
   return {
     context: {
       storefrontClient,
@@ -21,7 +30,9 @@ export const defineShopware = defineOrchestr.meta({
       systemEntities,
       currentSystemEntities,
       /** The systems current currency iso code */
-      swCurrency: currentSystemEntities.currency.iso
+      swCurrency: currentSystemEntities.currency.iso,
+      settings: settings.settings,
+      resolveCriteria
     }
   };
 });

package/dist/runtime/server/orchestr/category/base.resolver.js

@@ -1,6 +1,7 @@
 import { CategoryBase, CategoryContent, CategoryMedia, CategorySeo } from "@laioutr-core/canonical-types/entity/category";
 import { categoriesToken } from "../../const/passthroughTokens.js";
 import { defineShopwareComponentResolver } from "../../middleware/defineShopware.js";
+import { toRequestCriteria } from "../../shopware-helper/criteria.js";
 import { entitySlug } from "../../shopware-helper/mappers/slugMapper.js";
 import { mapMedia } from "../../shopware-helper/mediaMapper.js";
 import { swTranslated } from "../../shopware-helper/swTranslated.js";
@@ -10,10 +11,14 @@ export default defineShopwareComponentResolver({
   provides: [CategoryBase, CategoryContent, CategoryMedia, CategorySeo],
   resolve: async ({ entityIds, context, passthrough, $entity }) => {
     const { storefrontClient } = context;
-    const categories = passthrough.has(categoriesToken) ? passthrough.get(categoriesToken) : (await storefrontClient.invoke("readCategoryList post /category", {
-      // Neither association is returned by default; without `media` the media component is always empty.
-      body: { ids: entityIds, associations: { seoUrls: {}, media: {} } }
-    })).data.elements;
+    const readCategories = async () => {
+      const criteria = await context.resolveCriteria("category", { includes: {}, associations: { seoUrls: {}, media: {} } });
+      const response = await storefrontClient.invoke("readCategoryList post /category", {
+        body: { ids: entityIds, ...toRequestCriteria(criteria) }
+      });
+      return response.data.elements;
+    };
+    const categories = passthrough.has(categoriesToken) ? passthrough.get(categoriesToken) : await readCategories();
     if (!categories) {
       throw new Error(
         "Categories not found in passthrough. The component resolver does not request categories from shopware at the moment."

package/dist/runtime/server/orchestr/category/bySlug.query.js

@@ -3,7 +3,7 @@ import { defineShopwareQuery } from "../../middleware/defineShopware.js";
 import { useSeoResolver } from "../../shopware-helper/useSeoResolver.js";
 export default defineShopwareQuery(CategoryBySlugQuery, async ({ context, input }) => {
   const { slug } = input;
-  const seoResolver = useSeoResolver(context.storefrontClient);
+  const seoResolver = useSeoResolver(context.storefrontClient, context.settings.catalog.seoRouteNames);
   const seoEntry = await seoResolver.resolve("category", slug);
   if (!seoEntry) {
     throw new Error(`No seo url found for category slug: ${slug}`);

package/dist/runtime/server/orchestr/category/listing-page.page-index.js

@@ -5,22 +5,22 @@ import { toCategoryPageEntry } from "../../shopware-helper/pageIndexEntries.js";
 import { readCategoryPageMeta } from "../../shopware-helper/readCategoryPageMeta.js";
 import { SHOPWARE_MAX_LIMIT, storeApiPageFetcher } from "../../shopware-helper/storeApiPageFetcher.js";
 import { useSeoResolver } from "../../shopware-helper/useSeoResolver.js";
-const membershipFilter = [
-  { type: "equals", field: "type", value: "page" },
-  { type: "equals", field: "active", value: true },
-  { type: "range", field: "level", parameters: { gt: 1 } }
+const buildMembershipFilter = ({ categoryPageIndex }) => [
+  { type: "equalsAny", field: "type", value: categoryPageIndex.types },
+  ...categoryPageIndex.activeOnly ? [{ type: "equals", field: "active", value: true }] : [],
+  { type: "range", field: "level", parameters: { gt: categoryPageIndex.minLevel } }
 ];
-const pageIndexCriteria = {
+const buildPageIndexCriteria = (catalog) => ({
   associations: { seoUrls: {}, media: {} },
   includes: {
     category: ["id", "name", "translated", "updatedAt", "seoUrls", "media"],
     seo_url: ["seoPathInfo", "isCanonical", "routeName"],
     media: ["url"]
   },
-  filter: membershipFilter,
+  filter: buildMembershipFilter(catalog),
   // Page-number cursors need a stable upstream order, or a resumed walk shifts entries between passes.
   sort: [{ field: "id", order: "ASC" }]
-};
+});
 export default defineShopwarePageIndex({
   for: ProductListingPage,
   label: "Shopware Category",
@@ -37,7 +37,10 @@ export default defineShopwarePageIndex({
    * locale would claim the category has no page in any other.
    */
   locate: async ({ context, params }) => {
-    const seoEntry = await useSeoResolver(context.storefrontClient).resolve("category", params.slug);
+    const seoEntry = await useSeoResolver(context.storefrontClient, context.settings.catalog.seoRouteNames).resolve(
+      "category",
+      params.slug
+    );
     if (!seoEntry) return void 0;
     return {
       subject: { type: "Category", id: seoEntry.id },
@@ -46,16 +49,16 @@ export default defineShopwarePageIndex({
   },
   count: async ({ context }) => {
     const response = await context.storefrontClient.invoke("readCategoryList post /category", {
-      body: { ...pageIndexCriteria, limit: 1, "total-count-mode": "exact" }
+      body: { ...buildPageIndexCriteria(context.settings.catalog), limit: 1, "total-count-mode": "exact" }
     });
     return response.data.total ?? 0;
   },
   /** Substring match on name and metaTitle, the same form the query-template picker uses for categories. */
   search: ({ context, term, take }) => context.storefrontClient.invoke("readCategoryList post /category", {
     body: {
-      ...pageIndexCriteria,
+      ...buildPageIndexCriteria(context.settings.catalog),
       filter: [
-        ...membershipFilter,
+        ...buildMembershipFilter(context.settings.catalog),
         {
           type: "multi",
           operator: "or",
@@ -65,14 +68,14 @@ export default defineShopwarePageIndex({
           ]
         }
       ],
-      limit: take
+      limit: Math.min(take, context.settings.maxLimit)
     }
   }).then((response) => (response.data.elements ?? []).map(toCategoryPageEntry)),
   list: ({ context, batchSize, startCursor }) => paginate(
     storeApiPageFetcher(
-      ({ page, limit }) => context.storefrontClient.invoke("readCategoryList post /category", { body: { ...pageIndexCriteria, page, limit } }).then((response) => response.data),
+      ({ page, limit }) => context.storefrontClient.invoke("readCategoryList post /category", { body: { ...buildPageIndexCriteria(context.settings.catalog), page, limit } }).then((response) => response.data),
       toCategoryPageEntry,
-      batchSize
+      Math.min(batchSize, context.settings.maxLimit)
     ),
     startCursor
   )

package/dist/runtime/server/orchestr/menu/byAlias.query.js

@@ -2,16 +2,21 @@ import { MenuByAliasQuery } from "@laioutr-core/canonical-types/ecommerce";
 import { categoriesToken } from "../../const/passthroughTokens.js";
 import { defineShopwareQuery } from "../../middleware/defineShopware.js";
 import { flattenCategories } from "../../shopware-helper/categoryFlattener.js";
+import { toRequestCriteria } from "../../shopware-helper/criteria.js";
 export default defineShopwareQuery({
   implements: MenuByAliasQuery,
   run: async ({ input, context, passthrough }) => {
     const { alias } = input;
+    const criteria = await context.resolveCriteria("menu", { includes: {}, associations: { seoUrls: {} } });
     const response = await context.storefrontClient.invoke("readNavigation post /navigation/{activeId}/{rootId}", {
       pathParams: {
         activeId: alias,
         rootId: alias
       },
-      body: { associations: { seoUrls: {} } }
+      body: {
+        ...toRequestCriteria(criteria),
+        ...context.settings.catalog.menuDepth === void 0 ? {} : { depth: context.settings.catalog.menuDepth }
+      }
     });
     const flattenedCategories = flattenCategories(response.data ?? []);
     passthrough.set(categoriesToken, flattenedCategories);

package/dist/runtime/server/orchestr/product/base.resolver.js

@@ -37,7 +37,11 @@ export default defineShopwareComponentResolver({
     const loadedVariants = passthrough.get(productVariantsToken) ?? [];
     const missingVariantIds = variantIds.filter((id) => !loadedVariants.some((variant) => variant.id === id));
     if (missingVariantIds.length > 0) {
-      const response = await fetchAllProducts(context.storefrontClient, { productIds: missingVariantIds, loadVariants: false });
+      const response = await fetchAllProducts(context.storefrontClient, {
+        productIds: missingVariantIds,
+        loadVariants: false,
+        resolveCriteria: context.resolveCriteria
+      });
       loadedVariants.push(...response);
     }
     const shopwareProducts = variantIds.map((id) => {

package/dist/runtime/server/orchestr/product/byCategoryId.query.js

@@ -22,7 +22,7 @@ export default defineShopwareQuery(
         includes: {
           product: ["id", "parentId"]
         },
-        "total-count-mode": "exact",
+        "total-count-mode": context.settings.totalCountMode,
         "min-price": swBuiltInFilters?.["min-price"],
         "max-price": swBuiltInFilters?.["max-price"],
         manufacturer: swBuiltInFilters?.manufacturer,

package/dist/runtime/server/orchestr/product/byCategorySlug.query.js

@@ -13,7 +13,7 @@ export default defineShopwareQuery(
   ProductsByCategorySlugQuery,
   async ({ context, input, pagination, filter: selectedFilters, sorting, passthrough }) => {
     const { categorySlug } = input;
-    const seoResolver = useSeoResolver(context.storefrontClient);
+    const seoResolver = useSeoResolver(context.storefrontClient, context.settings.catalog.seoRouteNames);
     const seoEntry = await seoResolver.resolve("category", categorySlug);
     if (!seoEntry) {
       throw new Error(`No seo url found for category slug: ${categorySlug}`);
@@ -29,7 +29,7 @@ export default defineShopwareQuery(
         includes: {
           product: ["id", "parentId"]
         },
-        "total-count-mode": "exact",
+        "total-count-mode": context.settings.totalCountMode,
         "min-price": swBuiltInFilters?.["min-price"],
         "max-price": swBuiltInFilters?.["max-price"],
         manufacturer: swBuiltInFilters?.manufacturer,
@@ -43,11 +43,14 @@ export default defineShopwareQuery(
     );
     passthrough.set(parentIdToDefaultVariantIdToken, parentIdToDefaultVariantId);
     cacheProductParentIds(response.data.elements.map((product) => [product.id, product.parentId ?? product.id]));
-    const allVariants = await fetchAllProducts(context.storefrontClient, {
-      productIds: Object.keys(parentIdToDefaultVariantId),
-      loadVariants: true
-    });
-    passthrough.set(productVariantsToken, allVariants);
+    if (context.settings.loadVariantsOnListing) {
+      const allVariants = await fetchAllProducts(context.storefrontClient, {
+        productIds: Object.keys(parentIdToDefaultVariantId),
+        loadVariants: true,
+        resolveCriteria: context.resolveCriteria
+      });
+      passthrough.set(productVariantsToken, allVariants);
+    }
     return {
       // Return the parent-id, in case the received product is a variant
       ids: response.data.elements.map((product) => product.parentId ?? product.id),

package/dist/runtime/server/orchestr/product/byCategorySlug.template.js

@@ -23,7 +23,7 @@ export default defineShopwareQueryTemplateProvider({
           category: ["id", "name", "translated", "seoUrls"],
           seo_url: ["seoPathInfo", "isCanonical", "routeName"]
         },
-        limit: 50
+        limit: context.settings.queryTemplateLimit
       }
     });
     const templates = [];

package/dist/runtime/server/orchestr/product/bySlug.query.js

@@ -4,7 +4,7 @@ import { parentIdToDefaultVariantIdToken } from "../../const/passthroughTokens.j
 import { defineShopwareQuery } from "../../middleware/defineShopware.js";
 import { useSeoResolver } from "../../shopware-helper/useSeoResolver.js";
 export default defineShopwareQuery(ProductBySlugQuery, async ({ context, input, passthrough }) => {
-  const seoResolver = useSeoResolver(context.storefrontClient);
+  const seoResolver = useSeoResolver(context.storefrontClient, context.settings.catalog.seoRouteNames);
   const seoEntry = await seoResolver.resolve("product", input.slug);
   if (!seoEntry) {
     throw new Error(`No product found for slug: ${input.slug}`);

package/dist/runtime/server/orchestr/product/detail-page.page-index.js

@@ -34,7 +34,7 @@ export default defineShopwarePageIndex({
    */
   locate: async ({ context, params }) => {
     const client = context.storefrontClient;
-    const seoEntry = await useSeoResolver(client).resolve("product", params.slug);
+    const seoEntry = await useSeoResolver(client, context.settings.catalog.seoRouteNames).resolve("product", params.slug);
     if (!seoEntry) return void 0;
     const parentId = await useGetProductParentId(client)(seoEntry.id);
     const productId = parentId ?? seoEntry.id;
@@ -46,12 +46,14 @@ export default defineShopwarePageIndex({
     });
     return response.data.total ?? 0;
   },
-  search: ({ context, term, take }) => context.storefrontClient.invoke("readProduct post /product", { body: { ...pageIndexCriteria, term, limit: take } }).then((response) => (response.data.elements ?? []).map(toProductPageEntry)),
+  search: ({ context, term, take }) => context.storefrontClient.invoke("readProduct post /product", {
+    body: { ...pageIndexCriteria, term, limit: Math.min(take, context.settings.maxLimit) }
+  }).then((response) => (response.data.elements ?? []).map(toProductPageEntry)),
   list: ({ context, batchSize, startCursor }) => paginate(
     storeApiPageFetcher(
       ({ page, limit }) => context.storefrontClient.invoke("readProduct post /product", { body: { ...pageIndexCriteria, page, limit } }).then((response) => response.data),
       toProductPageEntry,
-      batchSize
+      Math.min(batchSize, context.settings.maxLimit)
     ),
     startCursor
   )

package/dist/runtime/server/orchestr/product/variants.link.js

@@ -3,7 +3,11 @@ import { productVariantsToken } from "../../const/passthroughTokens.js";
 import { defineShopwareLink } from "../../middleware/defineShopware.js";
 import { fetchAllProducts } from "../../shopware-helper/fetchAllProductVariants.js";
 export default defineShopwareLink(ProductVariantsLink, async ({ entityIds, context, passthrough }) => {
-  const allVariants = passthrough.get(productVariantsToken) ?? await fetchAllProducts(context.storefrontClient, { productIds: entityIds, loadVariants: true });
+  const allVariants = passthrough.get(productVariantsToken) ?? await fetchAllProducts(context.storefrontClient, {
+    productIds: entityIds,
+    loadVariants: true,
+    resolveCriteria: context.resolveCriteria
+  });
   passthrough.set(productVariantsToken, allVariants);
   return {
     links: entityIds.map((productId) => {

package/dist/runtime/server/orchestr/product-variant/base.resolver.js

@@ -12,6 +12,7 @@ import {
 import { productVariantsToken } from "../../const/passthroughTokens.js";
 import { defineShopwareComponentResolver } from "../../middleware/defineShopware.js";
 import { resolveProductVariantFields } from "../../orchestr-helper/requestedFields.js";
+import { toRequestCriteria } from "../../shopware-helper/criteria.js";
 import { mapMedia } from "../../shopware-helper/mediaMapper.js";
 import { swTranslated } from "../../shopware-helper/swTranslated.js";
 export default defineShopwareComponentResolver({
@@ -32,10 +33,11 @@ export default defineShopwareComponentResolver({
     const loadedVariants = passthrough.get(productVariantsToken) ?? [];
     const missingVariantIds = entityIds.filter((id) => !loadedVariants.some((variant) => variant.id === id));
     if (missingVariantIds.length > 0) {
+      const criteria = await resolveProductVariantFields(context.resolveCriteria);
       const response = await context.storefrontClient.invoke("readProduct post /product", {
         body: {
           ids: missingVariantIds,
-          ...resolveProductVariantFields()
+          ...toRequestCriteria(criteria)
         }
       });
       loadedVariants.push(...response.data.elements ?? []);

package/dist/runtime/server/orchestr/review/base.resolver.js

@@ -1,6 +1,7 @@
 import { ReviewBase } from "@laioutr-core/canonical-types/entity/review";
 import { currentProductIdsToken } from "../../const/passthroughTokens.js";
 import { defineShopwareComponentResolver } from "../../middleware/defineShopware.js";
+import { toRequestCriteria } from "../../shopware-helper/criteria.js";
 export default defineShopwareComponentResolver({
   label: "Shopware Product Review Connector",
   entityType: "Review",
@@ -9,14 +10,16 @@ export default defineShopwareComponentResolver({
     const currentProductIds = passthrough.get(currentProductIdsToken);
     if (!currentProductIds) throw new Error("Missing `currentProductIdsToken` in passthrough.");
     let entities = [];
+    const criteria = await context.resolveCriteria("product-review", {
+      includes: { product_review: ["id", "title", "content", "points", "externalUser"] },
+      associations: {}
+    });
     for (const productId of currentProductIds) {
       const res = await context.storefrontClient.invoke("readProductReviews post /product/{productId}/reviews", {
         pathParams: { productId },
         body: {
           ids: entityIds,
-          includes: {
-            product_review: ["id", "title", "content", "points", "externalUser"]
-          }
+          ...toRequestCriteria(criteria)
         }
       });
       entities = entities.concat(...res.data.elements ?? []);

package/dist/runtime/server/orchestr-helper/requestedFields.d.ts

@@ -1,18 +1,5 @@
+import type { ResolveCriteria, ShopwareCriteria } from '../types/criteria.js';
 export declare const resolveProductFields: ({ loadVariants }: {
     loadVariants: boolean;
-}) => {
-    associations: {
-        [key: string]: /*elided*/ any;
-    };
-    includes: {
-        [key: string]: string[];
-    };
-};
-export declare const resolveProductVariantFields: () => {
-    associations: {
-        [key: string]: /*elided*/ any;
-    };
-    includes: {
-        [key: string]: string[];
-    };
-};
+}, resolveCriteria: ResolveCriteria) => Promise<ShopwareCriteria>;
+export declare const resolveProductVariantFields: (resolveCriteria: ResolveCriteria) => Promise<ShopwareCriteria>;

package/dist/runtime/server/orchestr-helper/requestedFields.js

@@ -1,102 +1,49 @@
-import { ProductVariantsLink } from "@laioutr-core/canonical-types/ecommerce";
 import { MediaIncludes } from "../const/includes.js";
-const unique = (arr) => Array.from(new Set(arr));
+import { mergeIncludes } from "../shopware-helper/criteria.js";
 const addAssociation = (name, add, association = {}) => add ? { [name]: association } : {};
-const _resolveRequestedFields = ({
-  requestedComponents,
-  requestedLinks
-}) => {
-  const requestedVariants = requestedLinks[ProductVariantsLink];
-  const variantFields = requestedVariants ? resolveProductVariantFields() : void 0;
-  const associations = {
-    ...requestedComponents.includes("media") ? { cover: { associations: { media: {} } }, media: { associations: { media: {} } } } : {},
-    // gallery images (via product_media -> media)
-    ...requestedComponents.includes("options") ? { options: { associations: { group: {} } } } : {},
-    // variant options like Color/Size + their group names
-    ...requestedVariants ? {
-      children: {
-        associations: variantFields?.associations ?? {}
-      }
-    } : {}
-  };
-  const includes = {
-    product: unique([
-      "id",
-      "parentId",
-      ...requestedComponents.includes("base") ? ["name", "seoUrls"] : [],
-      ...requestedComponents.includes("info") ? ["name", "productNumber", "ean", "translated", "manufacturer", "description", "cover"] : [],
-      ...requestedComponents.includes("description") ? ["translated", "description"] : [],
-      ...requestedComponents.includes("seo") ? ["metaTitle", "metaDescription", "seoUrls"] : [],
-      ...requestedComponents.includes("media") ? ["cover", "media"] : [],
-      ...requestedComponents.includes("prices") ? ["minPurchase", "purchaseSteps", "maxPurchase", "calculatedPrice", "calculatedPrices"] : [],
-      ...requestedLinks["ecommerce/product/variants"] ? ["children"] : [],
-      ...variantFields?.includes?.product ?? []
-    ]),
-    product_media: requestedComponents.includes("media") ? ["id", "mediaId", "media"] : [],
-    media: requestedComponents.includes("media") ? MediaIncludes : [],
-    property_group_option: requestedComponents.includes("availability") ? ["id", "name", "group"] : [],
-    property_group: requestedComponents.includes("availability") ? ["id", "name"] : []
-  };
-  return { associations, includes };
-};
-const mergeIncludes = (includes1, includes2) => {
-  const merged = {};
-  for (const [key, value] of Object.entries(includes1)) {
-    merged[key] = [...value];
-  }
-  for (const [key, value] of Object.entries(includes2)) {
-    merged[key] = [...merged[key] ?? [], ...value];
-  }
-  for (const [key, value] of Object.entries(merged)) {
-    merged[key] = unique([...value]);
-  }
-  return merged;
-};
-export const resolveProductFields = ({ loadVariants }) => {
-  const variantFields = loadVariants ? resolveProductVariantFields() : void 0;
-  const associations = {
-    cover: { associations: { media: {} } },
-    media: { associations: { media: {} } },
-    ...addAssociation("children", loadVariants, variantFields?.associations ? { associations: variantFields?.associations } : {})
-  };
-  const includes = mergeIncludes(
-    {
-      product: [
-        "id",
-        "parentId",
-        "name",
-        "seoUrls",
-        "productNumber",
-        "ean",
-        "translated",
-        "manufacturer",
-        "description",
-        "cover",
-        "metaTitle",
-        "metaDescription",
-        "cover",
-        "media",
-        "minPurchase",
-        "purchaseSteps",
-        "maxPurchase",
-        "calculatedPrice",
-        "calculatedPrices",
-        "children",
-        "ratingAverage",
-        "productReviews"
-      ],
-      product_media: ["id", "mediaId", "media"],
-      media: MediaIncludes
+export const resolveProductFields = async ({ loadVariants }, resolveCriteria) => {
+  const variantFields = loadVariants ? await resolveProductVariantFields(resolveCriteria) : void 0;
+  return resolveCriteria("product", {
+    associations: {
+      cover: { associations: { media: {} } },
+      media: { associations: { media: {} } },
+      ...addAssociation("children", loadVariants, variantFields ? { associations: variantFields.associations } : {})
     },
-    variantFields?.includes ?? {}
-  );
-  return {
-    associations,
-    includes
-  };
+    includes: mergeIncludes(
+      {
+        product: [
+          "id",
+          "parentId",
+          "name",
+          "seoUrls",
+          "productNumber",
+          "ean",
+          "translated",
+          "manufacturer",
+          "description",
+          "cover",
+          "metaTitle",
+          "metaDescription",
+          "cover",
+          "media",
+          "minPurchase",
+          "purchaseSteps",
+          "maxPurchase",
+          "calculatedPrice",
+          "calculatedPrices",
+          "children",
+          "ratingAverage",
+          "productReviews"
+        ],
+        product_media: ["id", "mediaId", "media"],
+        media: MediaIncludes
+      },
+      variantFields?.includes ?? {}
+    )
+  });
 };
-export const resolveProductVariantFields = () => {
-  const associations = {
+export const resolveProductVariantFields = async (resolveCriteria) => resolveCriteria("product-variant", {
+  associations: {
     cover: { associations: { media: {} } },
     // main image
     media: { associations: { media: {} } },
@@ -106,8 +53,8 @@ export const resolveProductVariantFields = () => {
     manufacturer: {},
     deliveryTime: {},
     prices: { associations: { rule: {} } }
-  };
-  const includes = {
+  },
+  includes: {
     product: [
       "id",
       "parentId",
@@ -137,9 +84,5 @@ export const resolveProductVariantFields = () => {
     media: MediaIncludes,
     property_group_option: ["id", "name", "group", "translated"],
     property_group: ["id", "name", "translated"]
-  };
-  return {
-    associations,
-    includes
-  };
-};
+  }
+});

package/dist/runtime/server/shopware-helper/criteria.d.ts

@@ -0,0 +1,11 @@
+import type { ShopwareCriteria } from '../types/criteria.js';
+import type { ShopwareIncludesQuery } from '../types/shopware.js';
+export declare const mergeIncludes: (...projections: ShopwareIncludesQuery[]) => ShopwareIncludesQuery;
+export declare const toRequestCriteria: ({ includes, associations }: ShopwareCriteria) => {
+    associations?: {
+        [key: string]: /*elided*/ any;
+    } | undefined;
+    includes?: {
+        [key: string]: string[];
+    } | undefined;
+};

package/dist/runtime/server/shopware-helper/criteria.js

@@ -0,0 +1,14 @@
+const unique = (arr) => Array.from(new Set(arr));
+export const mergeIncludes = (...projections) => {
+  const merged = {};
+  for (const projection of projections) {
+    for (const [entity, fields] of Object.entries(projection)) {
+      merged[entity] = unique([...merged[entity] ?? [], ...fields]);
+    }
+  }
+  return merged;
+};
+export const toRequestCriteria = ({ includes, associations }) => ({
+  ...Object.keys(includes).length > 0 ? { includes } : {},
+  ...Object.keys(associations).length > 0 ? { associations } : {}
+});

package/dist/runtime/server/shopware-helper/fetchAllProductVariants.d.ts

@@ -1,7 +1,9 @@
+import type { ResolveCriteria } from '../types/criteria.js';
 import { StorefrontClient } from '../types/shopware.js';
-export declare const fetchAllProducts: (storefrontClient: StorefrontClient, { productIds, loadVariants }: {
+export declare const fetchAllProducts: (storefrontClient: StorefrontClient, { productIds, loadVariants, resolveCriteria }: {
     productIds: string[];
     loadVariants: boolean;
+    resolveCriteria: ResolveCriteria;
 }) => Promise<{
     active?: boolean;
     apiAlias: "product";

package/dist/runtime/server/shopware-helper/fetchAllProductVariants.js

@@ -1,13 +1,14 @@
+import { toRequestCriteria } from "./criteria.js";
 import { resolveProductFields } from "../orchestr-helper/requestedFields.js";
-export const fetchAllProducts = async (storefrontClient, { productIds, loadVariants }) => {
-  const fields = resolveProductFields({ loadVariants });
+export const fetchAllProducts = async (storefrontClient, { productIds, loadVariants, resolveCriteria }) => {
   if (productIds.length === 0) {
     return [];
   }
+  const criteria = await resolveProductFields({ loadVariants }, resolveCriteria);
   const response = await storefrontClient.invoke("readProduct post /product", {
     body: {
       ids: productIds,
-      ...fields
+      ...toRequestCriteria(criteria)
     }
   });
   const products = response.data.elements ?? [];

package/dist/runtime/server/shopware-helper/shopwareSettings.d.ts

@@ -0,0 +1,2 @@
+import type { ShopwareSettings } from '../types/settings.js';
+export declare const defaultShopwareSettings: () => ShopwareSettings;

package/dist/runtime/server/shopware-helper/shopwareSettings.js

@@ -0,0 +1,16 @@
+import { SHOPWARE_MAX_LIMIT } from "./storeApiPageFetcher.js";
+export const defaultShopwareSettings = () => ({
+  maxLimit: SHOPWARE_MAX_LIMIT,
+  totalCountMode: "exact",
+  loadVariantsOnListing: true,
+  queryTemplateLimit: 50,
+  mediaFolderLimit: 500,
+  catalog: {
+    menuDepth: void 0,
+    categoryPageIndex: { types: ["page"], minLevel: 1, activeOnly: true },
+    seoRouteNames: {
+      product: ["frontend.detail.page"],
+      category: ["frontend.navigation.page", "frontend.landing.page"]
+    }
+  }
+});

package/dist/runtime/server/shopware-helper/useSeoResolver.d.ts

@@ -1,3 +1,4 @@
+import type { ShopwareCatalogSettings } from '../types/settings.js';
 import { StorefrontClient } from '../types/shopware.js';
 type SeoUrlType = 'product' | 'category';
 interface SeoEntry {
@@ -5,7 +6,7 @@ interface SeoEntry {
     id: string;
     matchedPath: string;
 }
-export declare const useSeoResolver: (storefrontClient: StorefrontClient) => {
+export declare const useSeoResolver: (storefrontClient: StorefrontClient, routeNames: ShopwareCatalogSettings["seoRouteNames"]) => {
     resolve: (type: SeoUrlType, slug: string) => Promise<SeoEntry | undefined>;
 };
 export {};

package/dist/runtime/server/shopware-helper/useSeoResolver.js

@@ -1,12 +1,8 @@
 import { extractShopwareId, isShopwareId } from "./isShopwareId.js";
 import { isSlugMatchingSeoPath } from "./mappers/slugMapper.js";
 import { useUserlandCache } from "#imports";
-const typeToRouteNames = {
-  product: ["frontend.detail.page"],
-  category: ["frontend.navigation.page", "frontend.landing.page"]
-};
 const SEO_ENTRY_TTL = 60 * 60 * 24;
-export const useSeoResolver = (storefrontClient) => {
+export const useSeoResolver = (storefrontClient, routeNames) => {
   const cache = useUserlandCache("shopware/seo-urls");
   const resolve = async (type, slug) => {
     const languageId = storefrontClient.defaultHeaders["sw-language-id"] ?? "default";
@@ -38,7 +34,7 @@ export const useSeoResolver = (storefrontClient) => {
                   { field: "seoPathInfo", type: "equals", value: slug }
                 ]
               },
-              { field: "routeName", type: "equalsAny", value: typeToRouteNames[type] }
+              { field: "routeName", type: "equalsAny", value: routeNames[type] }
             ]
           }
         ]

package/dist/runtime/server/types/criteria.d.ts

@@ -0,0 +1,7 @@
+import type { ShopwareAssociationsQuery, ShopwareIncludesQuery } from './shopware.js';
+export type ShopwareCriteriaTarget = 'product' | 'product-variant' | 'category' | 'menu' | 'product-review';
+export interface ShopwareCriteria {
+    includes: ShopwareIncludesQuery;
+    associations: ShopwareAssociationsQuery;
+}
+export type ResolveCriteria = (target: ShopwareCriteriaTarget, criteria: ShopwareCriteria) => Promise<ShopwareCriteria>;

package/dist/runtime/server/types/settings.d.ts

@@ -0,0 +1,21 @@
+import type { Schemas } from './storeApiTypes.js';
+export interface ShopwareCatalogSettings {
+    menuDepth: number | undefined;
+    categoryPageIndex: {
+        types: string[];
+        minLevel: number;
+        activeOnly: boolean;
+    };
+    seoRouteNames: {
+        product: string[];
+        category: string[];
+    };
+}
+export interface ShopwareSettings {
+    maxLimit: number;
+    totalCountMode: Schemas['TotalCountMode'];
+    loadVariantsOnListing: boolean;
+    queryTemplateLimit: number;
+    mediaFolderLimit: number;
+    catalog: ShopwareCatalogSettings;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laioutr/app-shopware",
-  "version": "0.14.5",
+  "version": "0.15.0",
   "description": "Laioutr integration with Shopware 6",
   "repository": "github:laioutr/app-shopware",
   "license": "MIT",