@vendure/core 1.5.2 → 1.6.2

package/dist/api/resolvers/shop/shop-products.resolver.js

@@ -15,11 +15,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ShopProductsResolver = void 0;
 const graphql_1 = require("@nestjs/graphql");
 const errors_1 = require("../../../common/error/errors");
+const collection_entity_1 = require("../../../entity/collection/collection.entity");
+const facet_entity_1 = require("../../../entity/facet/facet.entity");
+const product_entity_1 = require("../../../entity/product/product.entity");
 const service_1 = require("../../../service");
 const facet_value_service_1 = require("../../../service/services/facet-value.service");
 const product_variant_service_1 = require("../../../service/services/product-variant.service");
 const product_service_1 = require("../../../service/services/product.service");
 const request_context_1 = require("../../common/request-context");
+const relations_decorator_1 = require("../../decorators/relations.decorator");
 const request_context_decorator_1 = require("../../decorators/request-context.decorator");
 let ShopProductsResolver = class ShopProductsResolver {
     constructor(productService, productVariantService, facetValueService, collectionService, facetService) {
@@ -29,17 +33,18 @@ let ShopProductsResolver = class ShopProductsResolver {
         this.collectionService = collectionService;
         this.facetService = facetService;
     }
-    async products(ctx, args) {
+    async products(ctx, args, relations) {
         const options = Object.assign(Object.assign({}, args.options), { filter: Object.assign(Object.assign({}, (args.options && args.options.filter)), { enabled: { eq: true } }) });
-        return this.productService.findAll(ctx, options);
+        return this.productService.findAll(ctx, options, relations);
     }
-    async product(ctx, args) {
+    async product(ctx, args, relations) {
+        var _a;
         let result;
         if (args.id) {
-            result = await this.productService.findOne(ctx, args.id);
+            result = await this.productService.findOne(ctx, args.id, relations);
         }
         else if (args.slug) {
-            result = await this.productService.findOneBySlug(ctx, args.slug);
+            result = await this.productService.findOneBySlug(ctx, args.slug, relations);
         }
         else {
             throw new errors_1.UserInputError(`error.product-id-or-slug-must-be-provided`);
@@ -50,23 +55,23 @@ let ShopProductsResolver = class ShopProductsResolver {
         if (result.enabled === false) {
             return;
         }
-        result.facetValues = result.facetValues.filter(fv => !fv.facet.isPrivate);
+        result.facetValues = (_a = result.facetValues) === null || _a === void 0 ? void 0 : _a.filter(fv => !fv.facet.isPrivate);
         return result;
     }
-    async collections(ctx, args) {
+    async collections(ctx, args, relations) {
         const options = Object.assign(Object.assign({}, args.options), { filter: Object.assign(Object.assign({}, (args.options && args.options.filter)), { isPrivate: { eq: false } }) });
-        return this.collectionService.findAll(ctx, options || undefined);
+        return this.collectionService.findAll(ctx, options || undefined, relations);
     }
-    async collection(ctx, args) {
+    async collection(ctx, args, relations) {
         let collection;
         if (args.id) {
-            collection = await this.collectionService.findOne(ctx, args.id);
+            collection = await this.collectionService.findOne(ctx, args.id, relations);
             if (args.slug && collection && collection.slug !== args.slug) {
                 throw new errors_1.UserInputError(`error.collection-id-slug-mismatch`);
             }
         }
         else if (args.slug) {
-            collection = await this.collectionService.findOneBySlug(ctx, args.slug);
+            collection = await this.collectionService.findOneBySlug(ctx, args.slug, relations);
         }
         else {
             throw new errors_1.UserInputError(`error.collection-id-or-slug-must-be-provided`);
@@ -79,12 +84,12 @@ let ShopProductsResolver = class ShopProductsResolver {
     async search(...args) {
         throw new errors_1.InternalServerError(`error.no-search-plugin-configured`);
     }
-    async facets(ctx, args) {
+    async facets(ctx, args, relations) {
         const options = Object.assign(Object.assign({}, args.options), { filter: Object.assign(Object.assign({}, (args.options && args.options.filter)), { isPrivate: { eq: false } }) });
-        return this.facetService.findAll(ctx, options || undefined);
+        return this.facetService.findAll(ctx, options || undefined, relations);
     }
-    async facet(ctx, args) {
-        const facet = await this.facetService.findOne(ctx, args.id);
+    async facet(ctx, args, relations) {
+        const facet = await this.facetService.findOne(ctx, args.id, relations);
         if (facet && facet.isPrivate) {
             return;
         }
@@ -95,32 +100,36 @@ __decorate([
     graphql_1.Query(),
     __param(0, request_context_decorator_1.Ctx()),
     __param(1, graphql_1.Args()),
+    __param(2, relations_decorator_1.Relations({ entity: product_entity_1.Product, omit: ['variants', 'assets'] })),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [request_context_1.RequestContext, Object]),
+    __metadata("design:paramtypes", [request_context_1.RequestContext, Object, Array]),
     __metadata("design:returntype", Promise)
 ], ShopProductsResolver.prototype, "products", null);
 __decorate([
     graphql_1.Query(),
     __param(0, request_context_decorator_1.Ctx()),
     __param(1, graphql_1.Args()),
+    __param(2, relations_decorator_1.Relations({ entity: product_entity_1.Product, omit: ['variants', 'assets'] })),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [request_context_1.RequestContext, Object]),
+    __metadata("design:paramtypes", [request_context_1.RequestContext, Object, Array]),
     __metadata("design:returntype", Promise)
 ], ShopProductsResolver.prototype, "product", null);
 __decorate([
     graphql_1.Query(),
     __param(0, request_context_decorator_1.Ctx()),
     __param(1, graphql_1.Args()),
+    __param(2, relations_decorator_1.Relations({ entity: collection_entity_1.Collection, omit: ['productVariants', 'assets'] })),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [request_context_1.RequestContext, Object]),
+    __metadata("design:paramtypes", [request_context_1.RequestContext, Object, Array]),
     __metadata("design:returntype", Promise)
 ], ShopProductsResolver.prototype, "collections", null);
 __decorate([
     graphql_1.Query(),
     __param(0, request_context_decorator_1.Ctx()),
     __param(1, graphql_1.Args()),
+    __param(2, relations_decorator_1.Relations({ entity: collection_entity_1.Collection, omit: ['productVariants', 'assets'] })),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [request_context_1.RequestContext, Object]),
+    __metadata("design:paramtypes", [request_context_1.RequestContext, Object, Array]),
     __metadata("design:returntype", Promise)
 ], ShopProductsResolver.prototype, "collection", null);
 __decorate([
@@ -133,16 +142,18 @@ __decorate([
     graphql_1.Query(),
     __param(0, request_context_decorator_1.Ctx()),
     __param(1, graphql_1.Args()),
+    __param(2, relations_decorator_1.Relations(facet_entity_1.Facet)),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [request_context_1.RequestContext, Object]),
+    __metadata("design:paramtypes", [request_context_1.RequestContext, Object, Array]),
     __metadata("design:returntype", Promise)
 ], ShopProductsResolver.prototype, "facets", null);
 __decorate([
     graphql_1.Query(),
     __param(0, request_context_decorator_1.Ctx()),
     __param(1, graphql_1.Args()),
+    __param(2, relations_decorator_1.Relations(facet_entity_1.Facet)),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [request_context_1.RequestContext, Object]),
+    __metadata("design:paramtypes", [request_context_1.RequestContext, Object, Array]),
     __metadata("design:returntype", Promise)
 ], ShopProductsResolver.prototype, "facet", null);
 ShopProductsResolver = __decorate([

package/dist/api/resolvers/shop/shop-products.resolver.js.map

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

package/dist/api/schema/admin-api/collection.api.graphql

@@ -3,6 +3,8 @@ type Query {
     "Get a Collection either by id or slug. If neither id nor slug is specified, an error will result."
     collection(id: ID, slug: String): Collection
     collectionFilters: [ConfigurableOperationDefinition!]!
+    "Used for real-time previews of the contents of a Collection"
+    previewCollectionVariants(input: PreviewCollectionVariantsInput!, options: ProductVariantListOptions): ProductVariantList!
 }
 
 type Mutation {
@@ -52,6 +54,11 @@ input CreateCollectionInput {
     translations: [CreateCollectionTranslationInput!]!
 }
 
+input PreviewCollectionVariantsInput {
+    parentId: ID
+    filters: [ConfigurableOperationInput!]!
+}
+
 input UpdateCollectionInput {
     id: ID!
     isPrivate: Boolean

package/dist/bootstrap.js

@@ -30,6 +30,7 @@ const vendure_logger_1 = require("./config/logger/vendure-logger");
 const administrator_entity_1 = require("./entity/administrator/administrator.entity");
 const entities_1 = require("./entity/entities");
 const register_custom_entity_fields_1 = require("./entity/register-custom-entity-fields");
+const run_entity_metadata_modifiers_1 = require("./entity/run-entity-metadata-modifiers");
 const set_entity_id_strategy_1 = require("./entity/set-entity-id-strategy");
 const validate_custom_fields_config_1 = require("./entity/validate-custom-fields-config");
 const plugin_metadata_1 = require("./plugin/plugin-metadata");
@@ -157,6 +158,7 @@ async function preBootstrapConfig(userConfig) {
     }
     config = await runPluginConfigurations(config);
     register_custom_entity_fields_1.registerCustomEntityFields(config);
+    await run_entity_metadata_modifiers_1.runEntityMetadataModifiers(config);
     setExposedHeaders(config);
     return config;
 }

package/dist/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AACA,uCAA2C;AAC3C,6CAAqD;AAErD,gDAAiD;AAGjD,kDAA4D;AAC5D,4DAA+D;AAC/D,mEAA+D;AAC/D,mEAAwD;AAExD,sFAA4E;AAC5E,gDAAoD;AACpD,0FAAoF;AACpF,0FAAoF;AACpF,4EAAsE;AACtE,0FAAoF;AACpF,8DAA4F;AAC5F,wDAAiE;AACjE,uEAAsE;AACtE,4DAAwD;AAIxD;;;;;;;;;;;;;;KAcK;AACE,KAAK,UAAU,SAAS,CAAC,UAAkC;IAC9D,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACpD,uBAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,uBAAM,CAAC,IAAI,CAAC,sCAAsC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IAErE,8EAA8E;IAC9E,gFAAgF;IAChF,sCAAsC;IACtC,MAAM,SAAS,GAAG,wDAAa,cAAc,GAAC,CAAC;IAC/C,mCAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5B,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC;IAC/D,8BAAa,CAAC,oBAAoB,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE;QACtD,IAAI;QACJ,MAAM,EAAE,IAAI,uBAAM,EAAE;KACvB,CAAC,CAAC;IACH,8BAAa,CAAC,uBAAuB,EAAE,CAAC;IACxC,GAAG,CAAC,SAAS,CAAC,IAAI,uBAAM,EAAE,CAAC,CAAC;IAC5B,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC;IAC3C,MAAM,WAAW,GACb,WAAW,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/F,IAAI,WAAW,EAAE;QACb,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC;QAC7C,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;KACzC;IACD,MAAM,gBAAgB,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACpE,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QAC3B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IACH,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;IACvC,GAAG,CAAC,mBAAmB,EAAE,CAAC;IAC1B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,GAAG,CAAC;AACf,CAAC;AAjCD,8BAiCC;AAED;;;;;;;;;;;;;;;;;;;;;KAqBK;AACE,KAAK,UAAU,eAAe,CAAC,UAAkC;IACpE,MAAM,aAAa,GAAG,MAAM,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,MAAM,YAAY,8BAAa,EAAE;QACxC,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;KACrD;IACD,uBAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,uBAAM,CAAC,IAAI,CAAC,sCAAsC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IAErE,mCAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5B,8BAAa,CAAC,oBAAoB,EAAE,CAAC;IAErC,MAAM,YAAY,GAAG,MAAM,kDAAO,wBAAwB,IAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACtF,MAAM,SAAS,GAAG,MAAM,kBAAW,CAAC,wBAAwB,CAAC,YAAY,EAAE;QACvE,MAAM,EAAE,IAAI,uBAAM,EAAE;KACvB,CAAC,CAAC;IACH,8BAAa,CAAC,uBAAuB,EAAE,CAAC;IACxC,SAAS,CAAC,SAAS,CAAC,IAAI,uBAAM,EAAE,CAAC,CAAC;IAClC,SAAS,CAAC,mBAAmB,EAAE,CAAC;IAChC,MAAM,yBAAyB,CAAC,SAAS,CAAC,CAAC;IAC3C,uBAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACvC,OAAO,IAAI,8BAAa,CAAC,SAAS,CAAC,CAAC;AACxC,CAAC;AAtBD,0CAsBC;AAED;;GAEG;AACI,KAAK,UAAU,kBAAkB,CACpC,UAAkC;;IAElC,IAAI,UAAU,EAAE;QACZ,0BAAS,CAAC,UAAU,CAAC,CAAC;KACzB;IAED,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;IAClD,MAAM,EAAE,kBAAkB,EAAE,GAAG,wDAAa,sBAAsB,GAAC,CAAC;IACpE,0BAAS,CAAC;QACN,mBAAmB,EAAE;YACjB,QAAQ;YACR,WAAW,EAAE;gBACT,GAAG,CAAC,MAAA,MAAA,UAAU,CAAC,mBAAmB,0CAAE,WAAW,mCAAI,EAAE,CAAC;gBACtD,GAAI,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAA4C;aACnF;SACJ;KACJ,CAAC,CAAC;IAEH,IAAI,MAAM,GAAG,0BAAS,EAAE,CAAC;IACzB,MAAM,gBAAgB,GAAG,MAAA,MAAM,CAAC,aAAa,CAAC,gBAAgB,mCAAI,MAAM,CAAC,gBAAgB,CAAC;IAC1F,4CAAmB,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;IAChD,MAAM,2BAA2B,GAAG,0DAA0B,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC9F,IAAI,CAAC,2BAA2B,CAAC,KAAK,EAAE;QACpC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,2BAA2B,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;KACvG;IACD,MAAM,GAAG,MAAM,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAC/C,0DAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,0DAA0B,CAAC,MAAM,CAAC,CAAC;IACzC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC;AAClB,CAAC;AAhCD,gDAgCC;AAED;;GAEG;AACH,KAAK,UAAU,uBAAuB,CAAC,MAA4B;IAC/D,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE;QACjC,MAAM,QAAQ,GAAG,0CAAwB,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE;YAChC,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;SACnC;KACJ;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,cAAc,CAAC,UAAkC;IACnE,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,0BAAe,CAAqB,CAAC;IACxE,MAAM,cAAc,GAAG,wCAAsB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAElE,MAAM,WAAW,GAAqB,YAAY,CAAC;IAEnD,mEAAmE;IACnE,yCAAyC;IACzC,KAAK,MAAM,YAAY,IAAI,cAAc,EAAE;QACvC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI,CAAC,EAAE;YACrD,MAAM,IAAI,4BAAmB,CAAC,4BAA4B,EAAE,EAAE,UAAU,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;SAClG;aAAM;YACH,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;SAClC;KACJ;IACD,OAAO,WAAW,CAAC;AACvB,CAAC;AAhBD,wCAgBC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,MAAsC;IAC7D,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC;IAC3C,MAAM,kBAAkB,GACpB,WAAW,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/F,IAAI,kBAAkB,EAAE;QACpB,MAAM,kBAAkB,GAAG,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC;QACjE,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;QAC3C,IAAI,OAAO,WAAW,KAAK,SAAS,EAAE;YAClC,MAAM,EAAE,cAAc,EAAE,GAAG,WAAW,CAAC;YACvC,IAAI,yBAAmC,CAAC;YACxC,IAAI,CAAC,cAAc,EAAE;gBACjB,yBAAyB,GAAG,CAAC,kBAAkB,CAAC,CAAC;aACpD;iBAAM,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE;gBAC3C,yBAAyB,GAAG,cAAc;qBACrC,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;qBAClB,MAAM,CAAC,kBAAkB,CAAC,CAAC;aACnC;iBAAM;gBACH,yBAAyB,GAAG,cAAc,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;aACzE;YACD,WAAW,CAAC,cAAc,GAAG,yBAAyB,CAAC;SAC1D;KACJ;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,MAA4B;IACnD,IAAI,OAAe,CAAC;IACpB,IAAI;QACA,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC;KAChD;IAAC,OAAO,CAAC,EAAE;QACR,OAAO,GAAG,UAAU,CAAC;KACxB;IACD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC;IACxE,MAAM,eAAe,GAAqC,EAAE,CAAC;IAC7D,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,UAAU,QAAQ,IAAI,WAAW,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;IACxF,eAAe,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC3D,eAAe,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC7D,eAAe,CAAC,IAAI,CAChB,GAAG,uCAAwB,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,CAAU,CAAC,CAC5F,CAAC;IACF,MAAM,iBAAiB,GAAG,4BAA4B,CAAC,eAAe,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,oBAAoB,OAAO,yBAAyB,IAAI,EAAE,CAAC;IACzE,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACtF,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzG,uBAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;IACvC,uBAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC;IAC3D,uBAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;IAChE,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,uBAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,uBAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,4BAA4B,CAAC,KAAuC;IACzE,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,UAA0C;IAClE,MAAM,MAAM,qBAAQ,UAAU,CAAE,CAAC;IACjC,MAAM,CAAC,mBAAmB,GAAG,gCACtB,UAAU,CAAC,mBAAmB,KACjC,WAAW,EAAE,KAAK,GACA,CAAC;IACvB,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,yBAAyB,CAAC,MAA+B;IACpE,MAAM,UAAU,GAAe,MAAM,CAAC,GAAG,CAAC,4BAAkB,EAAE,CAAC,CAAC;IAChE,MAAM,IAAI,OAAO,CAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;QAC9C,MAAM,cAAc,GAAG,KAAK,IAAsB,EAAE;YAChD,IAAI;gBACA,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,oCAAa,CAAC,CAAC,KAAK,EAAE,CAAC;gBACzE,OAAO,CAAC,GAAG,UAAU,CAAC;aACzB;YAAC,OAAO,CAAC,EAAE;gBACR,OAAO,KAAK,CAAC;aAChB;QACL,CAAC,CAAC;QAEF,MAAM,cAAc,GAAG,IAAI,CAAC;QAC5B,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,MAAM,WAAW,GAAG,EAAE,CAAC;QACvB,IAAI,mBAAmB,GAAG,KAAK,CAAC;QAChC,uBAAM,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC;QAC9D,OAAO,CAAC,mBAAmB,IAAI,QAAQ,GAAG,WAAW,EAAE;YACnD,QAAQ,EAAE,CAAC;YACX,mBAAmB,GAAG,MAAM,cAAc,EAAE,CAAC;YAC7C,IAAI,mBAAmB,EAAE;gBACrB,uBAAM,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;gBAC3C,OAAO,EAAE,CAAC;gBACV,OAAO;aACV;YACD,uBAAM,CAAC,OAAO,CACV,6DAA6D,cAAc,eAAe,QAAQ,OAAO,WAAW,GAAG,CAC1H,CAAC;YACF,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;SACvE;QACD,MAAM,CAAC,4DAA4D,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/common/calculated-decorator.d.ts

@@ -5,13 +5,23 @@ import { SelectQueryBuilder } from 'typeorm';
  */
 export declare const CALCULATED_PROPERTIES = "__calculatedProperties__";
 /**
- * Optional metadata used to tell the ListQueryBuilder how to deal with
- * calculated columns when sorting or filtering.
+ * @description
+ * Optional metadata used to tell the {@link ListQueryBuilder} & {@link Relations} decorator how to deal with
+ * calculated columns when sorting, filtering and deriving required relations from GraphQL operations.
+ *
+ * @docsCategory data-access
+ * @docsPage Calculated
  */
 export interface CalculatedColumnQueryInstruction {
+    /**
+     * @description
+     * If the calculated property depends on one or more relations being present
+     * on the entity (e.g. an `Order` entity calculating the `totalQuantity` by adding
+     * up the quantities of each `OrderLine`), then those relations should be defined here.
+     */
     relations?: string[];
     query?: (qb: SelectQueryBuilder<any>) => void;
-    expression: string;
+    expression?: string;
 }
 export interface CalculatedColumnDefinition {
     name: string | symbol;
@@ -22,5 +32,8 @@ export interface CalculatedColumnDefinition {
  * Used to define calculated entity getters. The decorator simply attaches an array of "calculated"
  * property names to the entity's prototype. This array is then used by the {@link CalculatedPropertySubscriber}
  * to transfer the getter function from the prototype to the entity instance.
+ *
+ * @docsCategory data-access
+ * @docsWeight 0
  */
 export declare function Calculated(queryInstruction?: CalculatedColumnQueryInstruction): MethodDecorator;

package/dist/common/calculated-decorator.js

@@ -11,6 +11,9 @@ exports.CALCULATED_PROPERTIES = '__calculatedProperties__';
  * Used to define calculated entity getters. The decorator simply attaches an array of "calculated"
  * property names to the entity's prototype. This array is then used by the {@link CalculatedPropertySubscriber}
  * to transfer the getter function from the prototype to the entity instance.
+ *
+ * @docsCategory data-access
+ * @docsWeight 0
  */
 function Calculated(queryInstruction) {
     return (target, propertyKey, descriptor) => {

package/dist/common/calculated-decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"calculated-decorator.js","sourceRoot":"","sources":["../../src/common/calculated-decorator.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACU,QAAA,qBAAqB,GAAG,0BAA0B,CAAC;AAiBhE;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,gBAAmD;IAC1E,OAAO,CACH,MAAuC,EACvC,WAA4B,EAC5B,UAA8B,EAChC,EAAE;QACA,MAAM,UAAU,GAA+B;YAC3C,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,gBAAgB;SAC9B,CAAC;QACF,IAAI,MAAM,CAAC,6BAAqB,CAAC,EAAE;YAC/B,IACI,CAAC,MAAM,CAAC,6BAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,CAA6B,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAClF,UAAU,CAAC,IAAI,CAClB,EACH;gBACE,MAAM,CAAC,6BAAqB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;aAClD;SACJ;aAAM;YACH,MAAM,CAAC,6BAAqB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;SAChD;IACL,CAAC,CAAC;AACN,CAAC;AAtBD,gCAsBC"}
+{"version":3,"file":"calculated-decorator.js","sourceRoot":"","sources":["../../src/common/calculated-decorator.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACU,QAAA,qBAAqB,GAAG,0BAA0B,CAAC;AA2BhE;;;;;;;;GAQG;AACH,SAAgB,UAAU,CAAC,gBAAmD;IAC1E,OAAO,CACH,MAAuC,EACvC,WAA4B,EAC5B,UAA8B,EAChC,EAAE;QACA,MAAM,UAAU,GAA+B;YAC3C,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,gBAAgB;SAC9B,CAAC;QACF,IAAI,MAAM,CAAC,6BAAqB,CAAC,EAAE;YAC/B,IACI,CAAC,MAAM,CAAC,6BAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,CAA6B,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAClF,UAAU,CAAC,IAAI,CAClB,EACH;gBACE,MAAM,CAAC,6BAAqB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;aAClD;SACJ;aAAM;YACH,MAAM,CAAC,6BAAqB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;SAChD;IACL,CAAC,CAAC;AACN,CAAC;AAtBD,gCAsBC"}

package/dist/common/types/entity-relation-paths.d.ts

@@ -30,7 +30,7 @@ export declare type PathsToStringProps1<T extends VendureEntity> = T extends str
     [K in EntityRelationKeys<T>]: K;
 }[Extract<EntityRelationKeys<T>, string>];
 export declare type PathsToStringProps2<T extends VendureEntity> = T extends string ? never : {
-    [K in EntityRelationKeys<T>]: T[K] extends VendureEntity[] ? [K, PathsToStringProps1<T[K][number]>] : T[K] extends VendureEntity ? [K, PathsToStringProps1<T[K]>] : never;
+    [K in EntityRelationKeys<T>]: T[K] extends VendureEntity[] ? [K, PathsToStringProps1<T[K][number]>] : T[K] extends VendureEntity | undefined ? [K, PathsToStringProps1<T[K]>] : never;
 }[Extract<EntityRelationKeys<T>, string>];
 export declare type TripleDotPath = `${string}.${string}.${string}`;
 export declare type Join<T extends Array<string | any>, D extends string> = T extends [] ? never : T extends [infer F] ? F : T extends [infer F, ...infer R] ? F extends string ? `${F}${D}${Join<Extract<R, string[]>, D>}` : never : string;

package/dist/config/catalog/collection-filter.d.ts

@@ -15,6 +15,38 @@ export interface CollectionFilterConfig<T extends ConfigArgs> extends Configurab
  * Creating a CollectionFilter is considered an advanced Vendure topic. For more insight into how
  * they work, study the [default collection filters](https://github.com/vendure-ecommerce/vendure/blob/master/packages/core/src/config/catalog/default-collection-filters.ts)
  *
+ * Here's a simple example of a custom CollectionFilter:
+ *
+ * @example
+ * ```TypeScript
+ * import { CollectionFilter, LanguageCode } from '\@vendure/core';
+ *
+ * export const skuCollectionFilter = new CollectionFilter({
+ *   args: {
+ *     // The `args` object defines the user-configurable arguments
+ *     // which will get passed to the filter's `apply()` function.
+ *     sku: {
+ *       type: 'string',
+ *       label: [{ languageCode: LanguageCode.en, value: 'SKU' }],
+ *       description: [
+ *         {
+ *           languageCode: LanguageCode.en,
+ *           value: 'Matches any product variants with SKUs containing this value',
+ *         },
+ *       ],
+ *     },
+ *   },
+ *   code: 'variant-sku-filter',
+ *   description: [{ languageCode: LanguageCode.en, value: 'Filter by matching SKU' }],
+ *
+ *   // This is the function that defines the logic of the filter.
+ *   apply: (qb, args) => {
+ *     const LIKE = qb.connection.options.type === 'postgres' ? 'ILIKE' : 'LIKE';
+ *     return qb.andWhere(`productVariant.sku ${LIKE} :sku`, { sku: `%${args.sku}%` });
+ *   },
+ * });
+ * ```
+ *
  * @docsCategory configuration
  */
 export declare class CollectionFilter<T extends ConfigArgs = ConfigArgs> extends ConfigurableOperationDef<T> {

package/dist/config/catalog/collection-filter.js

@@ -12,6 +12,38 @@ const configurable_operation_1 = require("../../common/configurable-operation");
  * Creating a CollectionFilter is considered an advanced Vendure topic. For more insight into how
  * they work, study the [default collection filters](https://github.com/vendure-ecommerce/vendure/blob/master/packages/core/src/config/catalog/default-collection-filters.ts)
  *
+ * Here's a simple example of a custom CollectionFilter:
+ *
+ * @example
+ * ```TypeScript
+ * import { CollectionFilter, LanguageCode } from '\@vendure/core';
+ *
+ * export const skuCollectionFilter = new CollectionFilter({
+ *   args: {
+ *     // The `args` object defines the user-configurable arguments
+ *     // which will get passed to the filter's `apply()` function.
+ *     sku: {
+ *       type: 'string',
+ *       label: [{ languageCode: LanguageCode.en, value: 'SKU' }],
+ *       description: [
+ *         {
+ *           languageCode: LanguageCode.en,
+ *           value: 'Matches any product variants with SKUs containing this value',
+ *         },
+ *       ],
+ *     },
+ *   },
+ *   code: 'variant-sku-filter',
+ *   description: [{ languageCode: LanguageCode.en, value: 'Filter by matching SKU' }],
+ *
+ *   // This is the function that defines the logic of the filter.
+ *   apply: (qb, args) => {
+ *     const LIKE = qb.connection.options.type === 'postgres' ? 'ILIKE' : 'LIKE';
+ *     return qb.andWhere(`productVariant.sku ${LIKE} :sku`, { sku: `%${args.sku}%` });
+ *   },
+ * });
+ * ```
+ *
  * @docsCategory configuration
  */
 class CollectionFilter extends configurable_operation_1.ConfigurableOperationDef {

package/dist/config/catalog/collection-filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"collection-filter.js","sourceRoot":"","sources":["../../../src/config/catalog/collection-filter.ts"],"names":[],"mappings":";;;AAGA,gFAK6C;AAW7C,iCAAiC;AACjC;;;;;;;;;;GAUG;AACH,MAAa,gBAAoD,SAAQ,iDAA2B;IAGhG,YAAY,MAAiC;QACzC,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,EAAsC,EAAE,IAAiB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IACxD,CAAC;CACJ;AAXD,4CAWC"}
+{"version":3,"file":"collection-filter.js","sourceRoot":"","sources":["../../../src/config/catalog/collection-filter.ts"],"names":[],"mappings":";;;AAGA,gFAK6C;AAW7C,iCAAiC;AACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAa,gBAAoD,SAAQ,iDAA2B;IAGhG,YAAY,MAAiC;QACzC,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,EAAsC,EAAE,IAAiB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IACxD,CAAC;CACJ;AAXD,4CAWC"}

package/dist/config/catalog/default-collection-filters.d.ts

@@ -1,4 +1,18 @@
+import { LanguageCode } from '@vendure/common/lib/generated-types';
+import { ConfigArgDef } from '../../common/configurable-operation';
 import { CollectionFilter } from './collection-filter';
+/**
+ * @description
+ * Used to created unique key names for DB query parameters, to avoid conflicts if the
+ * same filter is applied multiple times.
+ */
+export declare function randomSuffix(prefix: string): string;
+/**
+ * @description
+ * Add this to your CollectionFilter `args` object to display the standard UI component
+ * for selecting the combination mode when working with multiple filters.
+ */
+export declare const combineWithAndArg: ConfigArgDef<'boolean'>;
 /**
  * Filters for ProductVariants having the given facetValueIds (including parent Product)
  */
@@ -9,10 +23,23 @@ export declare const facetValueCollectionFilter: CollectionFilter<{
         ui: {
             component: string;
         };
+        label: {
+            languageCode: LanguageCode.en;
+            value: string;
+        }[];
     };
     containsAny: {
         type: "boolean";
+        label: {
+            languageCode: LanguageCode.en;
+            value: string;
+        }[];
+        description: {
+            languageCode: LanguageCode.en;
+            value: string;
+        }[];
     };
+    combineWithAnd: import("../../common/configurable-operation").ConfigArgCommonDef<"boolean"> & import("../../common/configurable-operation").WithArgConfig<never>;
 }>;
 export declare const variantNameCollectionFilter: CollectionFilter<{
     operator: {
@@ -27,6 +54,37 @@ export declare const variantNameCollectionFilter: CollectionFilter<{
     term: {
         type: "string";
     };
+    combineWithAnd: import("../../common/configurable-operation").ConfigArgCommonDef<"boolean"> & import("../../common/configurable-operation").WithArgConfig<never>;
+}>;
+export declare const variantIdCollectionFilter: CollectionFilter<{
+    variantIds: {
+        type: "ID";
+        list: true;
+        label: {
+            languageCode: LanguageCode.en;
+            value: string;
+        }[];
+        ui: {
+            component: string;
+            selectionMode: string;
+        };
+    };
+    combineWithAnd: import("../../common/configurable-operation").ConfigArgCommonDef<"boolean"> & import("../../common/configurable-operation").WithArgConfig<never>;
+}>;
+export declare const productIdCollectionFilter: CollectionFilter<{
+    productIds: {
+        type: "ID";
+        list: true;
+        label: {
+            languageCode: LanguageCode.en;
+            value: string;
+        }[];
+        ui: {
+            component: string;
+            selectionMode: string;
+        };
+    };
+    combineWithAnd: import("../../common/configurable-operation").ConfigArgCommonDef<"boolean"> & import("../../common/configurable-operation").WithArgConfig<never>;
 }>;
 export declare const defaultCollectionFilters: (CollectionFilter<{
     facetValueIds: {
@@ -35,10 +93,23 @@ export declare const defaultCollectionFilters: (CollectionFilter<{
         ui: {
             component: string;
         };
+        label: {
+            languageCode: LanguageCode.en;
+            value: string;
+        }[];
     };
     containsAny: {
         type: "boolean";
+        label: {
+            languageCode: LanguageCode.en;
+            value: string;
+        }[];
+        description: {
+            languageCode: LanguageCode.en;
+            value: string;
+        }[];
     };
+    combineWithAnd: import("../../common/configurable-operation").ConfigArgCommonDef<"boolean"> & import("../../common/configurable-operation").WithArgConfig<never>;
 }> | CollectionFilter<{
     operator: {
         type: "string";
@@ -52,4 +123,33 @@ export declare const defaultCollectionFilters: (CollectionFilter<{
     term: {
         type: "string";
     };
+    combineWithAnd: import("../../common/configurable-operation").ConfigArgCommonDef<"boolean"> & import("../../common/configurable-operation").WithArgConfig<never>;
+}> | CollectionFilter<{
+    variantIds: {
+        type: "ID";
+        list: true;
+        label: {
+            languageCode: LanguageCode.en;
+            value: string;
+        }[];
+        ui: {
+            component: string;
+            selectionMode: string;
+        };
+    };
+    combineWithAnd: import("../../common/configurable-operation").ConfigArgCommonDef<"boolean"> & import("../../common/configurable-operation").WithArgConfig<never>;
+}> | CollectionFilter<{
+    productIds: {
+        type: "ID";
+        list: true;
+        label: {
+            languageCode: LanguageCode.en;
+            value: string;
+        }[];
+        ui: {
+            component: string;
+            selectionMode: string;
+        };
+    };
+    combineWithAnd: import("../../common/configurable-operation").ConfigArgCommonDef<"boolean"> & import("../../common/configurable-operation").WithArgConfig<never>;
 }>)[];