@deenruv/elasticsearch-plugin 1.0.0

package/LICENSE

@@ -0,0 +1,23 @@
+# License 1
+
+The MIT License
+
+Copyright (c) 2025-present Aexol
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+# License 2
+
+The MIT License
+
+Copyright (c) 2018-2025 Michael Bromley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,122 @@
+# @deenruv/elasticsearch-plugin
+
+Replaces the default Deenruv product search with [Elasticsearch](https://www.elastic.co/elasticsearch/) for advanced full-text search, faceted filtering, price range queries, custom mappings, and geo-spatial search.
+
+**Requires Elasticsearch v7.0 or higher** (below v7.10.2 due to client compatibility).
+
+## Installation
+
+```bash
+pnpm add @deenruv/elasticsearch-plugin @elastic/elasticsearch
+```
+
+Make sure to remove `DefaultSearchPlugin` from your config if present.
+
+## Configuration
+
+```typescript
+import { ElasticsearchPlugin } from '@deenruv/elasticsearch-plugin';
+
+const config = {
+  plugins: [
+    ElasticsearchPlugin.init({
+      host: 'http://localhost',
+      port: 9200,
+    }),
+  ],
+};
+```
+
+**Options:**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `host` | `string` | `'http://localhost'` | Elasticsearch host |
+| `port` | `number` | `9200` | Elasticsearch port |
+| `clientOptions` | `ClientOptions` | - | Direct Elasticsearch client options (overrides host/port) |
+| `connectionAttempts` | `number` | `10` | Max connection retry attempts on startup |
+| `connectionAttemptInterval` | `number` | `5000` | Interval (ms) between connection attempts |
+| `indexPrefix` | `string` | `'deenruv-'` | Prefix for Elasticsearch indices |
+| `indexSettings` | `object` | `{}` | Elasticsearch index settings (analyzers, filters, etc.) |
+| `indexMappingProperties` | `object` | `{}` | Custom index mapping properties |
+| `customProductMappings` | `object` | `{}` | Custom fields indexed from Products |
+| `customProductVariantMappings` | `object` | `{}` | Custom fields indexed from ProductVariants |
+| `searchConfig` | `SearchConfig` | See below | Internal search query configuration |
+| `bufferUpdates` | `boolean` | `false` | Buffer index updates for manual batch execution |
+| `hydrateProductRelations` | `string[]` | `[]` | Additional Product relations to fetch during reindexing |
+| `hydrateProductVariantRelations` | `string[]` | `[]` | Additional ProductVariant relations to fetch during reindexing |
+| `extendSearchInputType` | `object` | `{}` | Add custom fields to the `SearchInput` GraphQL type |
+| `extendSearchSortType` | `string[]` | `[]` | Add custom sort parameters |
+
+**SearchConfig defaults:**
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `facetValueMaxSize` | `50` | Max FacetValues returned per search |
+| `collectionMaxSize` | `50` | Max Collections returned per search |
+| `totalItemsMaxSize` | `10000` | Max total items tracked |
+| `multiMatchType` | `'best_fields'` | Elasticsearch multi-match query type |
+| `priceRangeBucketInterval` | `1000` | Price range bucket interval (in cents) |
+| `mapQuery` | identity | Custom query transformation function |
+| `mapSort` | identity | Custom sort transformation function |
+| `scriptFields` | `{}` | Computed script fields (e.g. geo-distance) |
+
+## Features
+
+- Drop-in replacement for `DefaultSearchPlugin`
+- Price range filtering and price bucket aggregations
+- Custom product/variant field mappings exposed via GraphQL
+- Script fields for computed values (e.g. geo-spatial distance)
+- Configurable search boosting per field
+- Custom index analyzers and mapping properties
+- Buffered updates for high-volume environments
+- Health check integration
+- Automatic index management and reindexing on entity changes
+- Supports fuzzy search, wildcard queries via `mapQuery`
+- Custom sort parameters via `mapSort`
+
+## Admin UI
+
+Server-only plugin. No Admin UI extensions.
+
+## API Extensions
+
+Both Admin and Shop APIs are extended with price range data and custom mapping fields:
+
+```graphql
+extend type SearchResponse {
+  prices: SearchResponsePriceData!
+}
+
+type SearchResponsePriceData {
+  range: PriceRange!
+  rangeWithTax: PriceRange!
+  buckets: [PriceRangeBucket!]!
+  bucketsWithTax: [PriceRangeBucket!]!
+}
+
+type PriceRangeBucket {
+  to: Int!
+  count: Int!
+}
+
+extend input SearchInput {
+  priceRange: PriceRangeInput
+  priceRangeWithTax: PriceRangeInput
+}
+
+input PriceRangeInput {
+  min: Int!
+  max: Int!
+}
+```
+
+When `customProductMappings` or `customProductVariantMappings` are defined, additional fields are exposed on `SearchResult`:
+
+```graphql
+type SearchResult {
+  customProductMappings: CustomProductMappings
+  customProductVariantMappings: CustomProductVariantMappings
+  customMappings: CustomMappings  # Union of both
+}
+```

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./src/plugin";
+export * from "./src/options";
+export * from "./src/types";

package/lib/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./src/plugin"), exports);
+__exportStar(require("./src/options"), exports);
+__exportStar(require("./src/types"), exports);
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,gDAA8B;AAC9B,8CAA4B"}

package/lib/src/api/api-extensions.d.ts

@@ -0,0 +1,3 @@
+import { DocumentNode } from "graphql";
+import { ElasticsearchOptions } from "../options";
+export declare function generateSchemaExtensions(options: ElasticsearchOptions): DocumentNode;

package/lib/src/api/api-extensions.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSchemaExtensions = void 0;
+const graphql_tag_1 = require("graphql-tag");
+function generateSchemaExtensions(options) {
+    const customMappingTypes = generateCustomMappingTypes(options);
+    const inputExtensions = Object.entries(options.extendSearchInputType || {});
+    const sortExtensions = options.extendSearchSortType || [];
+    const sortExtensionGql = `
+    extend input SearchResultSortParameter {
+        ${sortExtensions.map((key) => `${key}: SortOrder`).join("\n            ")}
+    }`;
+    return (0, graphql_tag_1.gql) `
+        extend type SearchResponse {
+            prices: SearchResponsePriceData!
+        }
+
+        extend type SearchResult {
+            inStock: Boolean
+        }
+
+        type SearchResponsePriceData {
+            range: PriceRange!
+            rangeWithTax: PriceRange!
+            buckets: [PriceRangeBucket!]!
+            bucketsWithTax: [PriceRangeBucket!]!
+        }
+
+        type PriceRangeBucket {
+            to: Int!
+            count: Int!
+        }
+
+        extend input SearchInput {
+            priceRange: PriceRangeInput
+            priceRangeWithTax: PriceRangeInput
+            inStock: Boolean
+            ${inputExtensions.map(([name, type]) => `${name}: ${type}`).join("\n            ")}
+        }
+
+        ${sortExtensions.length > 0 ? sortExtensionGql : ""}
+
+        input PriceRangeInput {
+            min: Int!
+            max: Int!
+        }
+
+        ${customMappingTypes ? customMappingTypes : ""}
+    `;
+}
+exports.generateSchemaExtensions = generateSchemaExtensions;
+function generateCustomMappingTypes(options) {
+    var _a, _b;
+    const productMappings = Object.entries(options.customProductMappings || {}).filter(([, value]) => { var _a; return (_a = value.public) !== null && _a !== void 0 ? _a : true; });
+    const variantMappings = Object.entries(options.customProductVariantMappings || {}).filter(([, value]) => { var _a; return (_a = value.public) !== null && _a !== void 0 ? _a : true; });
+    const searchInputTypeExtensions = Object.entries(options.extendSearchInputType || {});
+    const scriptProductFields = Object.entries(((_a = options.searchConfig) === null || _a === void 0 ? void 0 : _a.scriptFields) || {}).filter(([, scriptField]) => scriptField.context !== "variant");
+    const scriptVariantFields = Object.entries(((_b = options.searchConfig) === null || _b === void 0 ? void 0 : _b.scriptFields) || {}).filter(([, scriptField]) => scriptField.context !== "product");
+    let sdl = "";
+    if (scriptProductFields.length || scriptVariantFields.length) {
+        if (scriptProductFields.length) {
+            sdl += `
+            type CustomProductScriptFields {
+                ${scriptProductFields.map(([name, def]) => `${name}: ${def.graphQlType}`).join("\n")}
+            }
+            `;
+        }
+        if (scriptVariantFields.length) {
+            sdl += `
+            type CustomProductVariantScriptFields {
+                ${scriptVariantFields.map(([name, def]) => `${name}: ${def.graphQlType}`).join("\n")}
+            }
+            `;
+        }
+        if (scriptProductFields.length && scriptVariantFields.length) {
+            sdl += `
+                union CustomScriptFields = CustomProductScriptFields | CustomProductVariantScriptFields
+
+                extend type SearchResult {
+                    customScriptFields: CustomScriptFields!
+                }
+            `;
+        }
+        else if (scriptProductFields.length) {
+            sdl += `
+                extend type SearchResult {
+                    customScriptFields: CustomProductScriptFields!
+                }
+            `;
+        }
+        else if (scriptVariantFields.length) {
+            sdl += `
+                extend type SearchResult {
+                    customScriptFields: CustomProductVariantScriptFields!
+                }
+            `;
+        }
+    }
+    if (productMappings.length || variantMappings.length) {
+        if (productMappings.length) {
+            sdl += `
+            type CustomProductMappings {
+                ${productMappings.map(([name, def]) => `${name}: ${def.graphQlType}`).join("\n")}
+            }
+            `;
+        }
+        if (variantMappings.length) {
+            sdl += `
+            type CustomProductVariantMappings {
+                ${variantMappings.map(([name, def]) => `${name}: ${def.graphQlType}`).join("\n")}
+            }
+            `;
+        }
+        if (productMappings.length && variantMappings.length) {
+            sdl += `
+                union CustomMappings = CustomProductMappings | CustomProductVariantMappings
+
+                extend type SearchResult {
+                    customMappings: CustomMappings! @deprecated(reason: "Use customProductMappings or customProductVariantMappings")
+                    customProductMappings: CustomProductMappings!
+                    customProductVariantMappings: CustomProductVariantMappings!
+                }
+            `;
+        }
+        else if (productMappings.length) {
+            sdl += `
+                extend type SearchResult {
+                    customMappings: CustomProductMappings! @deprecated(reason: "Use customProductMappings or customProductVariantMappings")
+                    customProductMappings: CustomProductMappings!
+                }
+            `;
+        }
+        else if (variantMappings.length) {
+            sdl += `
+                extend type SearchResult {
+                    customMappings: CustomProductVariantMappings! @deprecated(reason: "Use customProductMappings or customProductVariantMappings")
+                    customProductVariantMappings: CustomProductVariantMappings!
+                }
+            `;
+        }
+    }
+    return sdl.length
+        ? (0, graphql_tag_1.gql) `
+        ${sdl}
+      `
+        : undefined;
+}
+//# sourceMappingURL=api-extensions.js.map

package/lib/src/api/api-extensions.js.map

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

package/lib/src/api/custom-mappings.resolver.d.ts

@@ -0,0 +1,12 @@
+import { DeepRequired } from "@deenruv/common/lib/shared-types";
+import { ElasticsearchOptions } from "../options";
+/**
+ * This resolver is only required if both customProductMappings and customProductVariantMappings are
+ * defined, since this particular configuration will result in a union type for the
+ * `SearchResult.customMappings` GraphQL field.
+ */
+export declare class CustomMappingsResolver {
+    private options;
+    constructor(options: DeepRequired<ElasticsearchOptions>);
+    __resolveType(value: any): string;
+}

package/lib/src/api/custom-mappings.resolver.js

@@ -0,0 +1,47 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomMappingsResolver = void 0;
+const common_1 = require("@nestjs/common");
+const graphql_1 = require("@nestjs/graphql");
+const constants_1 = require("../constants");
+/**
+ * This resolver is only required if both customProductMappings and customProductVariantMappings are
+ * defined, since this particular configuration will result in a union type for the
+ * `SearchResult.customMappings` GraphQL field.
+ */
+let CustomMappingsResolver = class CustomMappingsResolver {
+    constructor(options) {
+        this.options = options;
+    }
+    __resolveType(value) {
+        const productPropertyNames = Object.keys(this.options.customProductMappings);
+        return Object.keys(value).every((k) => productPropertyNames.includes(k))
+            ? "CustomProductMappings"
+            : "CustomProductVariantMappings";
+    }
+};
+exports.CustomMappingsResolver = CustomMappingsResolver;
+__decorate([
+    (0, graphql_1.ResolveField)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", String)
+], CustomMappingsResolver.prototype, "__resolveType", null);
+exports.CustomMappingsResolver = CustomMappingsResolver = __decorate([
+    (0, graphql_1.Resolver)("CustomMappings"),
+    __param(0, (0, common_1.Inject)(constants_1.ELASTIC_SEARCH_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], CustomMappingsResolver);
+//# sourceMappingURL=custom-mappings.resolver.js.map

package/lib/src/api/custom-mappings.resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-mappings.resolver.js","sourceRoot":"","sources":["../../../src/api/custom-mappings.resolver.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAwC;AACxC,6CAAyD;AAGzD,4CAAsD;AAGtD;;;;GAIG;AAEI,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjC,YAEU,OAA2C;QAA3C,YAAO,GAAP,OAAO,CAAoC;IAClD,CAAC;IAGJ,aAAa,CAAC,KAAU;QACtB,MAAM,oBAAoB,GAAG,MAAM,CAAC,IAAI,CACtC,IAAI,CAAC,OAAO,CAAC,qBAAqB,CACnC,CAAC;QACF,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACtE,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,8BAA8B,CAAC;IACrC,CAAC;CACF,CAAA;AAfY,wDAAsB;AAOjC;IADC,IAAA,sBAAY,GAAE;;;;2DAQd;iCAdU,sBAAsB;IADlC,IAAA,kBAAQ,EAAC,gBAAgB,CAAC;IAGtB,WAAA,IAAA,eAAM,EAAC,kCAAsB,CAAC,CAAA;;GAFtB,sBAAsB,CAelC"}

package/lib/src/api/custom-script-fields.resolver.d.ts

@@ -0,0 +1,12 @@
+import { DeepRequired } from "@deenruv/common/lib/shared-types";
+import { ElasticsearchOptions } from "../options";
+/**
+ * This resolver is only required if scriptFields are defined for both products and product variants.
+ * This particular configuration will result in a union type for the
+ * `SearchResult.customScriptFields` GraphQL field.
+ */
+export declare class CustomScriptFieldsResolver {
+    private options;
+    constructor(options: DeepRequired<ElasticsearchOptions>);
+    __resolveType(value: any): string;
+}

package/lib/src/api/custom-script-fields.resolver.js

@@ -0,0 +1,50 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomScriptFieldsResolver = void 0;
+const common_1 = require("@nestjs/common");
+const graphql_1 = require("@nestjs/graphql");
+const constants_1 = require("../constants");
+/**
+ * This resolver is only required if scriptFields are defined for both products and product variants.
+ * This particular configuration will result in a union type for the
+ * `SearchResult.customScriptFields` GraphQL field.
+ */
+let CustomScriptFieldsResolver = class CustomScriptFieldsResolver {
+    constructor(options) {
+        this.options = options;
+    }
+    __resolveType(value) {
+        var _a;
+        const productScriptFields = Object.entries(((_a = this.options.searchConfig) === null || _a === void 0 ? void 0 : _a.scriptFields) || {})
+            .filter(([, scriptField]) => scriptField.context !== "variant")
+            .map(([k]) => k);
+        return Object.keys(value).every((k) => productScriptFields.includes(k))
+            ? "CustomProductScriptFields"
+            : "CustomProductVariantScriptFields";
+    }
+};
+exports.CustomScriptFieldsResolver = CustomScriptFieldsResolver;
+__decorate([
+    (0, graphql_1.ResolveField)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", String)
+], CustomScriptFieldsResolver.prototype, "__resolveType", null);
+exports.CustomScriptFieldsResolver = CustomScriptFieldsResolver = __decorate([
+    (0, graphql_1.Resolver)("CustomScriptFields"),
+    __param(0, (0, common_1.Inject)(constants_1.ELASTIC_SEARCH_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], CustomScriptFieldsResolver);
+//# sourceMappingURL=custom-script-fields.resolver.js.map

package/lib/src/api/custom-script-fields.resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-script-fields.resolver.js","sourceRoot":"","sources":["../../../src/api/custom-script-fields.resolver.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAwC;AACxC,6CAAyD;AAGzD,4CAAsD;AAGtD;;;;GAIG;AAEI,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IACrC,YAEU,OAA2C;QAA3C,YAAO,GAAP,OAAO,CAAoC;IAClD,CAAC;IAGJ,aAAa,CAAC,KAAU;;QACtB,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,CACxC,CAAA,MAAA,IAAI,CAAC,OAAO,CAAC,YAAY,0CAAE,YAAY,KAAI,EAAE,CAC9C;aACE,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,KAAK,SAAS,CAAC;aAC9D,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACrE,CAAC,CAAC,2BAA2B;YAC7B,CAAC,CAAC,kCAAkC,CAAC;IACzC,CAAC;CACF,CAAA;AAjBY,gEAA0B;AAOrC;IADC,IAAA,sBAAY,GAAE;;;;+DAUd;qCAhBU,0BAA0B;IADtC,IAAA,kBAAQ,EAAC,oBAAoB,CAAC;IAG1B,WAAA,IAAA,eAAM,EAAC,kCAAsB,CAAC,CAAA;;GAFtB,0BAA0B,CAiBtC"}

package/lib/src/api/elasticsearch-resolver.d.ts

@@ -0,0 +1,34 @@
+import { Job as GraphQLJob, QuerySearchArgs, SearchResponse } from "@deenruv/common/lib/generated-types";
+import { Omit } from "@deenruv/common/lib/omit";
+import { Collection, FacetValue, RequestContext, SearchJobBufferService, SearchResolver } from "@deenruv/core";
+import { ElasticsearchService } from "../elasticsearch.service";
+import { ElasticSearchInput, SearchPriceData } from "../types";
+export declare class ShopElasticSearchResolver implements Pick<SearchResolver, "search"> {
+    private elasticsearchService;
+    constructor(elasticsearchService: ElasticsearchService);
+    search(ctx: RequestContext, args: QuerySearchArgs): Promise<Omit<SearchResponse, "facetValues" | "collections">>;
+    prices(ctx: RequestContext, parent: {
+        input: ElasticSearchInput;
+    }): Promise<SearchPriceData>;
+}
+export declare class AdminElasticSearchResolver implements Pick<SearchResolver, "search" | "reindex"> {
+    private elasticsearchService;
+    private searchJobBufferService;
+    constructor(elasticsearchService: ElasticsearchService, searchJobBufferService: SearchJobBufferService);
+    search(ctx: RequestContext, args: QuerySearchArgs): Promise<Omit<SearchResponse, "facetValues" | "collections">>;
+    reindex(ctx: RequestContext): Promise<GraphQLJob>;
+    pendingSearchIndexUpdates(...args: any[]): Promise<any>;
+    runPendingSearchIndexUpdates(...args: any[]): Promise<any>;
+}
+export declare class EntityElasticSearchResolver implements Pick<SearchResolver, "facetValues" | "collections"> {
+    private elasticsearchService;
+    constructor(elasticsearchService: ElasticsearchService);
+    facetValues(ctx: RequestContext, parent: Omit<SearchResponse, "facetValues" | "collections">): Promise<Array<{
+        facetValue: FacetValue;
+        count: number;
+    }>>;
+    collections(ctx: RequestContext, parent: Omit<SearchResponse, "facetValues" | "collections">): Promise<Array<{
+        collection: Collection;
+        count: number;
+    }>>;
+}

package/lib/src/api/elasticsearch-resolver.js

@@ -0,0 +1,150 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityElasticSearchResolver = exports.AdminElasticSearchResolver = exports.ShopElasticSearchResolver = void 0;
+const graphql_1 = require("@nestjs/graphql");
+const generated_types_1 = require("@deenruv/common/lib/generated-types");
+const core_1 = require("@deenruv/core");
+const elasticsearch_service_1 = require("../elasticsearch.service");
+let ShopElasticSearchResolver = class ShopElasticSearchResolver {
+    constructor(elasticsearchService) {
+        this.elasticsearchService = elasticsearchService;
+    }
+    async search(ctx, args) {
+        const result = await this.elasticsearchService.search(ctx, args.input, true);
+        // ensure the facetValues property resolver has access to the input args
+        result.input = args.input;
+        return result;
+    }
+    async prices(ctx, parent) {
+        return this.elasticsearchService.priceRange(ctx, parent.input);
+    }
+};
+exports.ShopElasticSearchResolver = ShopElasticSearchResolver;
+__decorate([
+    (0, graphql_1.Query)(),
+    (0, core_1.Allow)(generated_types_1.Permission.Public),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, graphql_1.Args)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, Object]),
+    __metadata("design:returntype", Promise)
+], ShopElasticSearchResolver.prototype, "search", null);
+__decorate([
+    (0, graphql_1.ResolveField)(),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, graphql_1.Parent)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, Object]),
+    __metadata("design:returntype", Promise)
+], ShopElasticSearchResolver.prototype, "prices", null);
+exports.ShopElasticSearchResolver = ShopElasticSearchResolver = __decorate([
+    (0, graphql_1.Resolver)("SearchResponse"),
+    __metadata("design:paramtypes", [elasticsearch_service_1.ElasticsearchService])
+], ShopElasticSearchResolver);
+let AdminElasticSearchResolver = class AdminElasticSearchResolver {
+    constructor(elasticsearchService, searchJobBufferService) {
+        this.elasticsearchService = elasticsearchService;
+        this.searchJobBufferService = searchJobBufferService;
+    }
+    async search(ctx, args) {
+        const result = await this.elasticsearchService.search(ctx, args.input, false);
+        // ensure the facetValues property resolver has access to the input args
+        result.input = args.input;
+        return result;
+    }
+    async reindex(ctx) {
+        return this.elasticsearchService.reindex(ctx);
+    }
+    async pendingSearchIndexUpdates(...args) {
+        return this.searchJobBufferService.getPendingSearchUpdates();
+    }
+    async runPendingSearchIndexUpdates(...args) {
+        // Intentionally not awaiting this method call
+        void this.searchJobBufferService.runPendingSearchUpdates();
+        return { success: true };
+    }
+};
+exports.AdminElasticSearchResolver = AdminElasticSearchResolver;
+__decorate([
+    (0, graphql_1.Query)(),
+    (0, core_1.Allow)(generated_types_1.Permission.ReadCatalog, generated_types_1.Permission.ReadProduct),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, graphql_1.Args)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, Object]),
+    __metadata("design:returntype", Promise)
+], AdminElasticSearchResolver.prototype, "search", null);
+__decorate([
+    (0, graphql_1.Mutation)(),
+    (0, core_1.Allow)(generated_types_1.Permission.UpdateCatalog, generated_types_1.Permission.UpdateProduct),
+    __param(0, (0, core_1.Ctx)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext]),
+    __metadata("design:returntype", Promise)
+], AdminElasticSearchResolver.prototype, "reindex", null);
+__decorate([
+    (0, graphql_1.Query)(),
+    (0, core_1.Allow)(generated_types_1.Permission.ReadCatalog, generated_types_1.Permission.ReadProduct),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], AdminElasticSearchResolver.prototype, "pendingSearchIndexUpdates", null);
+__decorate([
+    (0, graphql_1.Mutation)(),
+    (0, core_1.Allow)(generated_types_1.Permission.UpdateCatalog, generated_types_1.Permission.UpdateProduct),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], AdminElasticSearchResolver.prototype, "runPendingSearchIndexUpdates", null);
+exports.AdminElasticSearchResolver = AdminElasticSearchResolver = __decorate([
+    (0, graphql_1.Resolver)("SearchResponse"),
+    __metadata("design:paramtypes", [elasticsearch_service_1.ElasticsearchService,
+        core_1.SearchJobBufferService])
+], AdminElasticSearchResolver);
+let EntityElasticSearchResolver = class EntityElasticSearchResolver {
+    constructor(elasticsearchService) {
+        this.elasticsearchService = elasticsearchService;
+    }
+    async facetValues(ctx, parent) {
+        const facetValues = await this.elasticsearchService.facetValues(ctx, parent.input, true);
+        return facetValues.filter((i) => !i.facetValue.facet.isPrivate);
+    }
+    async collections(ctx, parent) {
+        const collections = await this.elasticsearchService.collections(ctx, parent.input, true);
+        return collections.filter((i) => !i.collection.isPrivate);
+    }
+};
+exports.EntityElasticSearchResolver = EntityElasticSearchResolver;
+__decorate([
+    (0, graphql_1.ResolveField)(),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, graphql_1.Parent)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, Object]),
+    __metadata("design:returntype", Promise)
+], EntityElasticSearchResolver.prototype, "facetValues", null);
+__decorate([
+    (0, graphql_1.ResolveField)(),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, graphql_1.Parent)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, Object]),
+    __metadata("design:returntype", Promise)
+], EntityElasticSearchResolver.prototype, "collections", null);
+exports.EntityElasticSearchResolver = EntityElasticSearchResolver = __decorate([
+    (0, graphql_1.Resolver)("SearchResponse"),
+    __metadata("design:paramtypes", [elasticsearch_service_1.ElasticsearchService])
+], EntityElasticSearchResolver);
+//# sourceMappingURL=elasticsearch-resolver.js.map