@sixtyninecommerce/admin 0.9.0 → 0.11.0

package/dist/catalog/products.js

@@ -1,8 +1,11 @@
 import { ValidationError } from '@sixtyninecommerce/core';
 import { bulkProducts, readProductBulkRun, } from './products-bulk.js';
-import { ASSET_REF_FIELDS, assertDeleted, availabilityCustomFields, CATALOGUE_OWNERSHIP_FIELDS, DELETION_FIELDS, FACET_VALUE_REF_FIELDS, fieldOf, unwrapResult, vendureListPage, } from './types.js';
+import { ASSET_REF_FIELDS, assertDeleted, availabilityCustomFields, CATALOGUE_OWNERSHIP_FIELDS, DELETION_FIELDS, FACET_VALUE_REF_FIELDS, fieldOf, toAssetRef, unwrapResult, vendureListPage, } from './types.js';
+import { assertPricesStateBasis, } from './variants.js';
 /** The engine's bound on one `exclude` or `include` call (`STORE_EXCLUSION_BATCH_LIMIT`). */
 export const MAX_STORE_EXCLUSION_PRODUCTS = 500;
+/** At most this many distinct products per {@link ProductsModule.storePriceRanges} call. */
+export const MAX_STORE_PRICE_RANGE_PRODUCTS = 100;
 /**
  * The engine's bounds on one `setAvailabilityInStores` or `availabilityInStores` call
  * (`AVAILABILITY_*_LIMIT`).
@@ -28,11 +31,19 @@ export const PRODUCT_FIELDS = /* GraphQL */ `
     id
     code
     name
+    customFields {
+      isShared
+    }
     options {
       id
       code
       name
     }
+    translations {
+      id
+      languageCode
+      name
+    }
   }
   translations {
     id
@@ -49,6 +60,8 @@ export const PRODUCT_FIELDS = /* GraphQL */ `
     availabilityState
     availableFrom
     preorderLimit
+    brand
+    condition
   }
 `;
 export const PRODUCTS_QUERY = /* GraphQL */ `
@@ -59,9 +72,36 @@ export const PRODUCTS_QUERY = /* GraphQL */ `
     }
   }
 `;
+const STORE_PRICE_FIELDS = 'price priceWithTax currencyCode';
+export const PRODUCT_STORE_PRICE_RANGES_QUERY = /* GraphQL */ `
+  query CatalogProductStorePriceRanges($options: ProductListOptions) {
+    products(options: $options) {
+      items {
+        id
+        storePriceRange {
+          min { ${STORE_PRICE_FIELDS} }
+          max { ${STORE_PRICE_FIELDS} }
+          someVariantsUnpriced
+        }
+      }
+    }
+  }
+`;
+/**
+ * One product, with the collections it is in. No variant data beyond `variantList`'s count: a
+ * product can have 100,000 variants, and core's `variants` would hand back the first 1,000 with
+ * no sign of the rest (`catalog.variants.list` pages them).
+ */
 export const PRODUCT_QUERY = /* GraphQL */ `
   query CatalogProduct($id: ID!) {
-    product(id: $id) { ${PRODUCT_FIELDS} }
+    product(id: $id) {
+      ${PRODUCT_FIELDS}
+      collections {
+        id
+        name
+        slug
+      }
+    }
   }
 `;
 export const CREATE_PRODUCT_MUTATION = /* GraphQL */ `
@@ -168,28 +208,66 @@ export const SET_PRODUCT_COLLECTIONS_MUTATION = /* GraphQL */ `
     }
   }
 `;
+export const SAVE_PRODUCT_MUTATION = /* GraphQL */ `
+  mutation CatalogSaveProduct($input: SaveProductInput!, $idempotencyKey: String) {
+    saveProduct(input: $input, idempotencyKey: $idempotencyKey) {
+      product { ${PRODUCT_FIELDS} }
+      collections {
+        added
+        removed
+        unchanged
+        notRemoved {
+          collectionId
+          reason
+        }
+      }
+      warnings {
+        code
+        message
+        propertyIds
+      }
+    }
+  }
+`;
 /**
  * Lift the availability custom fields to first-class fields. A server older
  * than the pre-order engine has no such fields and would refuse the document
  * outright, so the defaults below only cover a NULL value, never an absent one.
  */
 export function toProduct(wire) {
-    const { variantList, customFields, ...rest } = wire;
+    const { variantList, customFields, featuredAsset, assets, optionGroups, ...rest } = wire;
     return {
         ...rest,
+        featuredAsset: featuredAsset ? toAssetRef(featuredAsset) : null,
+        assets: assets.map(toAssetRef),
+        optionGroups: optionGroups.map(({ customFields: groupFields, ...group }) => ({
+            ...group,
+            isShared: groupFields?.isShared === true,
+        })),
         variantCount: variantList.totalItems,
         availabilityState: customFields?.availabilityState ?? 'none',
         availableFrom: customFields?.availableFrom ?? null,
         preorderLimit: customFields?.preorderLimit ?? null,
+        brand: customFields?.brand ?? null,
+        condition: customFields?.condition ?? null,
     };
 }
+/** {@link toProduct}, plus the collections. */
+function toProductDetail(wire) {
+    const { collections, ...rest } = wire;
+    return { ...toProduct(rest), collections };
+}
 function toWireInput(input) {
-    const { availabilityState, availableFrom, preorderLimit, ...rest } = input;
+    const { availabilityState, availableFrom, preorderLimit, brand, condition, ...rest } = input;
     const customFields = availabilityCustomFields({
         availabilityState,
         availableFrom,
         preorderLimit,
     });
+    if (brand !== undefined)
+        customFields.brand = brand;
+    if (condition !== undefined)
+        customFields.condition = condition;
     return Object.keys(customFields).length > 0 ? { ...rest, customFields } : rest;
 }
 export function productFilter(filter) {
@@ -211,6 +289,16 @@ export function productFilter(filter) {
     }
     return out;
 }
+/** The engine's `ProductListOptions` for one page of {@link ProductListOptions}. */
+export function productListOptions(options, skip, take) {
+    const filter = productFilter(options?.filter);
+    return {
+        skip,
+        take,
+        ...(Object.keys(filter).length > 0 ? { filter, filterOperator: 'AND' } : {}),
+        ...(options?.sort ? { sort: { [options.sort.field]: options.sort.direction } } : {}),
+    };
+}
 function refuse(code, message) {
     return new ValidationError({ code, message, status: 400, service: 'vendure' });
 }
@@ -264,19 +352,11 @@ export function createProductsModule(transport) {
     };
     return {
         async list(options) {
-            const filter = productFilter(options?.filter);
-            return vendureListPage(transport, PRODUCTS_QUERY, 'products', (skip, take) => ({
-                options: {
-                    skip,
-                    take,
-                    ...(Object.keys(filter).length > 0 ? { filter, filterOperator: 'AND' } : {}),
-                    ...(options?.sort ? { sort: { [options.sort.field]: options.sort.direction } } : {}),
-                },
-            }), options, toProduct);
+            return vendureListPage(transport, PRODUCTS_QUERY, 'products', (skip, take) => ({ options: productListOptions(options, skip, take) }), options, toProduct);
         },
         async get(id, options) {
             const product = await fieldOf(transport, PRODUCT_QUERY, 'product', { id }, options);
-            return product ? toProduct(product) : null;
+            return product ? toProductDetail(product) : null;
         },
         // `async` so every refusal below — including `toWireInput`'s datetime
         // check — arrives as a rejection, never as a synchronous throw a caller's
@@ -336,6 +416,27 @@ export function createProductsModule(transport) {
             assertAvailabilityInput(input, 'read');
             return fieldOf(transport, ORGANIZATION_PRODUCT_AVAILABILITY_QUERY, 'organizationProductAvailability', { productIds: input.productIds, channelIds: input.channelIds }, options);
         },
+        async storePriceRanges(productIds, options) {
+            // The engine stores a uuid lower-case, so an upper-case repeat is the same product.
+            const named = new Map();
+            for (const id of productIds) {
+                const key = String(id).toLowerCase();
+                if (!named.has(key))
+                    named.set(key, id);
+            }
+            if (named.size > MAX_STORE_PRICE_RANGE_PRODUCTS) {
+                throw refuse('PRODUCT_STORE_PRICE_RANGE_INPUT_INVALID', `Ask for at most ${String(MAX_STORE_PRICE_RANGE_PRODUCTS)} products per call; this one named ${String(named.size)}. Nothing was sent.`);
+            }
+            if (named.size === 0)
+                return [];
+            const ids = [...named.values()];
+            const page = await fieldOf(transport, PRODUCT_STORE_PRICE_RANGES_QUERY, 'products', { options: { filter: { id: { in: ids } }, take: ids.length } }, options);
+            const answered = new Map(page.items.map((item) => [item.id.toLowerCase(), item]));
+            return [...named.keys()].flatMap((key) => {
+                const item = answered.get(key);
+                return item ? [{ productId: item.id, range: item.storePriceRange }] : [];
+            });
+        },
         async makeLocalCopy(productId, options) {
             const { skus, ...call } = options ?? {};
             const result = await fieldOf(transport, MAKE_LOCAL_COPY_MUTATION, 'makeLocalCopy', {
@@ -355,6 +456,15 @@ export function createProductsModule(transport) {
                 fromCollectionIds: from === undefined ? null : [...from],
             }, call);
         },
+        async save(input, options) {
+            assertCollectionLists({
+                collectionIds: input.collectionIds,
+                fromCollectionIds: input.fromCollectionIds,
+            });
+            await assertPricesStateBasis(transport, input.variants ?? [], options);
+            const result = await fieldOf(transport, SAVE_PRODUCT_MUTATION, 'saveProduct', { input: toWireSaveInput(input), idempotencyKey: options?.idempotencyKey ?? null }, options);
+            return { ...result, product: toProduct(result.product) };
+        },
         bulk(input, options) {
             return bulkProducts(transport, input, options);
         },
@@ -363,3 +473,61 @@ export function createProductsModule(transport) {
         },
     };
 }
+/** The variant fields a save writes as custom fields on the wire. */
+const SAVE_VARIANT_CUSTOM_FIELDS = [
+    'minOrderQuantity',
+    'salesUnit',
+    'cost',
+    'packageWeightGrams',
+    'packageLengthCm',
+    'packageWidthCm',
+    'packageHeightCm',
+    'parcelCapacity',
+    'parcelPacking',
+    'backorderPolicy',
+    'backorderLimit',
+    'gtin',
+    'mpn',
+];
+/** The SDK's flat save as the engine's `SaveProductInput`: custom fields nested, no basis. */
+function toWireSaveInput(input) {
+    const wire = { id: input.id, languageCode: input.languageCode };
+    if (input.product) {
+        const { availabilityState, availableFrom, preorderLimit, brand, condition, ...rest } = input.product;
+        const customFields = availabilityCustomFields({
+            availabilityState,
+            availableFrom,
+            preorderLimit,
+        });
+        if (brand !== undefined)
+            customFields.brand = brand;
+        if (condition !== undefined)
+            customFields.condition = condition;
+        wire.product = Object.keys(customFields).length > 0 ? { ...rest, customFields } : rest;
+    }
+    if (input.variants) {
+        wire.variants = input.variants.map((variant) => {
+            const { availabilityState, availableFrom, preorderLimit, priceBasis, ...rest } = variant;
+            void priceBasis;
+            const customFields = availabilityCustomFields({
+                availabilityState,
+                availableFrom,
+                preorderLimit,
+            });
+            const out = { ...rest };
+            for (const key of SAVE_VARIANT_CUSTOM_FIELDS) {
+                if (key in out) {
+                    if (out[key] !== undefined)
+                        customFields[key] = out[key];
+                    delete out[key];
+                }
+            }
+            return Object.keys(customFields).length > 0 ? { ...out, customFields } : out;
+        });
+    }
+    for (const key of ['collectionIds', 'fromCollectionIds', 'propertyValues']) {
+        if (input[key] !== undefined)
+            wire[key] = input[key];
+    }
+    return wire;
+}

package/dist/catalog/properties.d.ts

@@ -33,6 +33,11 @@ export interface Property {
     position: number;
     config: PropertyConfig | null;
     facetId: string | null;
+    /**
+     * A filterable `content_item` property's field-level facets, one per content field it filters
+     * by, as `configureFieldFacets` last wrote them; null when it has none.
+     */
+    fieldFacets: PropertyFieldFacet[] | null;
     translations: Array<{
         id: string;
         languageCode: LanguageCode;
@@ -40,6 +45,25 @@ export interface Property {
         helpText: string | null;
     }>;
 }
+/** One field-level facet of a `content_item` property: the facet a content field's values fill. */
+export interface PropertyFieldFacet {
+    fieldSlug: string;
+    /** The content field's type (`enum`, `multi_enum`, `boolean`). */
+    fieldType: string;
+    facetId: string;
+}
+/** A content field a `content_item` property filters by (`configureFieldFacets`). */
+export interface FieldFacetDefinition {
+    /** The content type's field slug. */
+    fieldSlug: string;
+    /** The content field's type (`enum`, `multi_enum`, `boolean`). */
+    fieldType: string;
+    /** For an `enum` / `multi_enum` field: its options, each becoming one facet value. */
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+}
 export interface PropertyGroup {
     id: string;
     createdAt: string;
@@ -186,47 +210,111 @@ export interface ContentFacetSyncResult {
  */
 export interface PropertiesModule {
     groups: {
-        /** The complete list, as one terminal page — the query takes no paging. */
+        /**
+         * The store's own groups, the complete list as one terminal page (the query takes no paging).
+         *
+         * @effect read
+         */
         list(options?: Call): Promise<Page<PropertyGroup>>;
+        /**
+         * One of the store's own groups, or null.
+         *
+         * @effect read
+         */
         get(id: string, options?: Call): Promise<PropertyGroup | null>;
+        /** @effect write */
         create(input: CreatePropertyGroupInput, options?: Call): Promise<PropertyGroup>;
+        /** @effect write */
         update(input: UpdatePropertyGroupInput, options?: Call): Promise<PropertyGroup>;
-        /** Deletes the group AND every property in it, with their values. */
+        /**
+         * Deletes the group AND every property in it, with their values on every product and the
+         * filter values (facets) the filterable ones mirror. Not undoable.
+         *
+         * @effect destructive
+         */
         delete(id: string, options?: Call): Promise<void>;
         /**
          * Pass EVERY group id of the store, in the order wanted. Only the store's own groups:
          * a workspace group (`editableHere` false) or another store's id refuses the whole call.
+         *
+         * @effect write
          */
         reorder(ids: string[], options?: Call): Promise<PropertyGroup[]>;
     };
+    /** @effect write */
     create(input: CreatePropertyInput, options?: Call): Promise<Property>;
+    /** @effect write */
     update(input: UpdatePropertyInput, options?: Call): Promise<Property>;
+    /**
+     * Deletes the property with its values on every product, and the filter values (facets) a
+     * filterable one mirrors. Not undoable.
+     *
+     * @effect destructive
+     */
     delete(id: string, options?: Call): Promise<void>;
-    /** Pass every property id of the group, in the order wanted. */
+    /**
+     * Pass every property id of the group, in the order wanted.
+     *
+     * @effect write
+     */
     reorder(groupId: string, propertyIds: string[], options?: Call): Promise<Property[]>;
+    /**
+     * Sets which content fields a filterable `content_item` property filters by: one field-level
+     * facet per field named, its values the field's options (an `enum` / `multi_enum` field) or
+     * yes/no (a `boolean` one). Needs `UpdateCatalog`.
+     *
+     * `fields` is the WHOLE set: a field already configured keeps its facet (its values follow the
+     * options sent), a new one gets a facet, and a field left out loses its facet, which is removed
+     * from every product of the store. `[]` removes them all. Send the fields the property was
+     * SAVED with (`config.filterableFieldSlugs`), never an unsaved form's. The products' field
+     * values are filled by `catalog.syncContentFacets`, not here. It resolves with nothing (the
+     * engine answers only that it is done): the property's `fieldFacets`, read again through
+     * `groups.get`, holds what was written.
+     *
+     * Refusals (nothing is written):
+     * - `PROPERTY_NOT_FOUND` → `NotFoundError` (404): no such property among the store's own groups.
+     * - `PROPERTY_FACET_SYNC_INVALID` → `ValidationError` (400): not a `content_item` property, or
+     *   not saved as filterable.
+     * - `MANAGED_BY_ORGANIZATION` → `BusinessRuleError` (422): in a store of an organization, a
+     *   property of the workspace's groups (`editableHere` false): configure it in the workspace.
+     *
+     * Not idempotent by key; repeating the same `fields` writes the same facets again.
+     *
+     * Destructive: a dropped field's facet and a dropped option's filter value leave every product.
+     *
+     * @effect destructive
+     */
+    configureFieldFacets(propertyId: string, fields: FieldFacetDefinition[], options?: Call): Promise<void>;
     values: {
         /**
          * Every group of the store, each with this product's stored values in every language. For a
          * product the store holds from its organization, the workspace's groups and values come too,
          * with `group.editableHere` false.
+         *
+         * @effect read
          */
         get(productId: string, options?: Call): Promise<ProductPropertyGroupValues[]>;
-        /** Upsert the given values; properties not named keep theirs. */
+        /**
+         * Upsert the given values; properties not named keep theirs.
+         *
+         * @effect write
+         */
         set(productId: string, values: SetPropertyValueInput[], options?: Call): Promise<void>;
     };
 }
-export declare const PROPERTY_GROUP_FIELDS = "\n  id\n  createdAt\n  updatedAt\n  position\n  translations {\n    id\n    languageCode\n    name\n  }\n  properties { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  editableHere\n";
-export declare const PROPERTY_GROUPS_QUERY = "\n  query CatalogPropertyGroups {\n    propertyGroups { \n  id\n  createdAt\n  updatedAt\n  position\n  translations {\n    id\n    languageCode\n    name\n  }\n  properties { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  editableHere\n }\n  }\n";
-export declare const PROPERTY_GROUP_QUERY = "\n  query CatalogPropertyGroup($id: ID!) {\n    propertyGroup(id: $id) { \n  id\n  createdAt\n  updatedAt\n  position\n  translations {\n    id\n    languageCode\n    name\n  }\n  properties { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  editableHere\n }\n  }\n";
-export declare const CREATE_PROPERTY_GROUP_MUTATION = "\n  mutation CatalogCreatePropertyGroup($input: CreatePropertyGroupInput!) {\n    createPropertyGroup(input: $input) { \n  id\n  createdAt\n  updatedAt\n  position\n  translations {\n    id\n    languageCode\n    name\n  }\n  properties { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  editableHere\n }\n  }\n";
-export declare const UPDATE_PROPERTY_GROUP_MUTATION = "\n  mutation CatalogUpdatePropertyGroup($input: UpdatePropertyGroupInput!) {\n    updatePropertyGroup(input: $input) { \n  id\n  createdAt\n  updatedAt\n  position\n  translations {\n    id\n    languageCode\n    name\n  }\n  properties { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  editableHere\n }\n  }\n";
+export declare const PROPERTY_GROUP_FIELDS = "\n  id\n  createdAt\n  updatedAt\n  position\n  translations {\n    id\n    languageCode\n    name\n  }\n  properties { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  fieldFacets {\n    fieldSlug\n    fieldType\n    facetId\n  }\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  editableHere\n";
+export declare const PROPERTY_GROUPS_QUERY = "\n  query CatalogPropertyGroups {\n    propertyGroups { \n  id\n  createdAt\n  updatedAt\n  position\n  translations {\n    id\n    languageCode\n    name\n  }\n  properties { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  fieldFacets {\n    fieldSlug\n    fieldType\n    facetId\n  }\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  editableHere\n }\n  }\n";
+export declare const PROPERTY_GROUP_QUERY = "\n  query CatalogPropertyGroup($id: ID!) {\n    propertyGroup(id: $id) { \n  id\n  createdAt\n  updatedAt\n  position\n  translations {\n    id\n    languageCode\n    name\n  }\n  properties { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  fieldFacets {\n    fieldSlug\n    fieldType\n    facetId\n  }\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  editableHere\n }\n  }\n";
+export declare const CREATE_PROPERTY_GROUP_MUTATION = "\n  mutation CatalogCreatePropertyGroup($input: CreatePropertyGroupInput!) {\n    createPropertyGroup(input: $input) { \n  id\n  createdAt\n  updatedAt\n  position\n  translations {\n    id\n    languageCode\n    name\n  }\n  properties { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  fieldFacets {\n    fieldSlug\n    fieldType\n    facetId\n  }\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  editableHere\n }\n  }\n";
+export declare const UPDATE_PROPERTY_GROUP_MUTATION = "\n  mutation CatalogUpdatePropertyGroup($input: UpdatePropertyGroupInput!) {\n    updatePropertyGroup(input: $input) { \n  id\n  createdAt\n  updatedAt\n  position\n  translations {\n    id\n    languageCode\n    name\n  }\n  properties { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  fieldFacets {\n    fieldSlug\n    fieldType\n    facetId\n  }\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  editableHere\n }\n  }\n";
 export declare const DELETE_PROPERTY_GROUP_MUTATION = "\n  mutation CatalogDeletePropertyGroup($id: ID!) {\n    deletePropertyGroup(id: $id) { \n  result\n  message\n }\n  }\n";
-export declare const REORDER_PROPERTY_GROUPS_MUTATION = "\n  mutation CatalogReorderPropertyGroups($ids: [ID!]!) {\n    reorderPropertyGroups(ids: $ids) { \n  id\n  createdAt\n  updatedAt\n  position\n  translations {\n    id\n    languageCode\n    name\n  }\n  properties { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  editableHere\n }\n  }\n";
-export declare const CREATE_PROPERTY_MUTATION = "\n  mutation CatalogCreateProperty($input: CreatePropertyInput!) {\n    createProperty(input: $input) { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  }\n";
-export declare const UPDATE_PROPERTY_MUTATION = "\n  mutation CatalogUpdateProperty($input: UpdatePropertyInput!) {\n    updateProperty(input: $input) { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  }\n";
+export declare const REORDER_PROPERTY_GROUPS_MUTATION = "\n  mutation CatalogReorderPropertyGroups($ids: [ID!]!) {\n    reorderPropertyGroups(ids: $ids) { \n  id\n  createdAt\n  updatedAt\n  position\n  translations {\n    id\n    languageCode\n    name\n  }\n  properties { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  fieldFacets {\n    fieldSlug\n    fieldType\n    facetId\n  }\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  editableHere\n }\n  }\n";
+export declare const CREATE_PROPERTY_MUTATION = "\n  mutation CatalogCreateProperty($input: CreatePropertyInput!) {\n    createProperty(input: $input) { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  fieldFacets {\n    fieldSlug\n    fieldType\n    facetId\n  }\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  }\n";
+export declare const UPDATE_PROPERTY_MUTATION = "\n  mutation CatalogUpdateProperty($input: UpdatePropertyInput!) {\n    updateProperty(input: $input) { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  fieldFacets {\n    fieldSlug\n    fieldType\n    facetId\n  }\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  }\n";
 export declare const DELETE_PROPERTY_MUTATION = "\n  mutation CatalogDeleteProperty($id: ID!) {\n    deleteProperty(id: $id) { \n  result\n  message\n }\n  }\n";
-export declare const REORDER_PROPERTIES_MUTATION = "\n  mutation CatalogReorderProperties($groupId: ID!, $propertyIds: [ID!]!) {\n    reorderProperties(groupId: $groupId, propertyIds: $propertyIds) { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  }\n";
-export declare const PRODUCT_PROPERTY_VALUES_QUERY = "\n  query CatalogProductPropertyValues($productId: ID!) {\n    productPropertyValues(productId: $productId) {\n      group { \n  id\n  createdAt\n  updatedAt\n  position\n  translations {\n    id\n    languageCode\n    name\n  }\n  properties { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  editableHere\n }\n      values {\n        id\n        propertyId\n        languageCode\n        value\n      }\n    }\n  }\n";
+export declare const REORDER_PROPERTIES_MUTATION = "\n  mutation CatalogReorderProperties($groupId: ID!, $propertyIds: [ID!]!) {\n    reorderProperties(groupId: $groupId, propertyIds: $propertyIds) { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  fieldFacets {\n    fieldSlug\n    fieldType\n    facetId\n  }\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  }\n";
+export declare const CONFIGURE_FIELD_FACETS_MUTATION = "\n  mutation CatalogConfigureFieldFacets($propertyId: ID!, $fields: [FieldFacetDefinitionInput!]!) {\n    configureFieldFacets(propertyId: $propertyId, fields: $fields)\n  }\n";
+export declare const PRODUCT_PROPERTY_VALUES_QUERY = "\n  query CatalogProductPropertyValues($productId: ID!) {\n    productPropertyValues(productId: $productId) {\n      group { \n  id\n  createdAt\n  updatedAt\n  position\n  translations {\n    id\n    languageCode\n    name\n  }\n  properties { \n  id\n  createdAt\n  updatedAt\n  slug\n  fieldType\n  isFilterable\n  isRequired\n  position\n  config {\n    options {\n      value\n      label\n    }\n    min\n    max\n    maxLength\n    allowedCollectionIds\n    filterableFieldSlugs\n    productFilter\n  }\n  facetId\n  fieldFacets {\n    fieldSlug\n    fieldType\n    facetId\n  }\n  translations {\n    id\n    languageCode\n    name\n    helpText\n  }\n }\n  editableHere\n }\n      values {\n        id\n        propertyId\n        languageCode\n        value\n      }\n    }\n  }\n";
 export declare const SET_PRODUCT_PROPERTY_VALUES_MUTATION = "\n  mutation CatalogSetProductPropertyValues($productId: ID!, $values: [SetProductPropertyValueInput!]!) {\n    setProductPropertyValues(productId: $productId, values: $values)\n  }\n";
 export declare const SYNC_PROPERTY_FACETS_MUTATION = "\n  mutation CatalogSyncPropertyFacets($propertyId: ID!) {\n    syncPropertyFacets(propertyId: $propertyId) {\n      propertyId\n      items\n      unresolved\n      fieldFacets\n    }\n  }\n";
 /** `catalog.syncContentFacets`; its contract is on {@link CatalogModule.syncContentFacets}. */

package/dist/catalog/properties.js

@@ -22,6 +22,11 @@ const PROPERTY_FIELDS = /* GraphQL */ `
     productFilter
   }
   facetId
+  fieldFacets {
+    fieldSlug
+    fieldType
+    facetId
+  }
   translations {
     id
     languageCode
@@ -92,6 +97,11 @@ export const REORDER_PROPERTIES_MUTATION = /* GraphQL */ `
     reorderProperties(groupId: $groupId, propertyIds: $propertyIds) { ${PROPERTY_FIELDS} }
   }
 `;
+export const CONFIGURE_FIELD_FACETS_MUTATION = /* GraphQL */ `
+  mutation CatalogConfigureFieldFacets($propertyId: ID!, $fields: [FieldFacetDefinitionInput!]!) {
+    configureFieldFacets(propertyId: $propertyId, fields: $fields)
+  }
+`;
 export const PRODUCT_PROPERTY_VALUES_QUERY = /* GraphQL */ `
   query CatalogProductPropertyValues($productId: ID!) {
     productPropertyValues(productId: $productId) {
@@ -148,6 +158,9 @@ export function createPropertiesModule(transport) {
         update: (input, options) => call(UPDATE_PROPERTY_MUTATION, 'updateProperty', { input }, options),
         delete: (id, options) => deleted(DELETE_PROPERTY_MUTATION, 'deleteProperty', 'PROPERTY_NOT_DELETED', id, options),
         reorder: (groupId, propertyIds, options) => call(REORDER_PROPERTIES_MUTATION, 'reorderProperties', { groupId, propertyIds }, options),
+        async configureFieldFacets(propertyId, fields, options) {
+            await call(CONFIGURE_FIELD_FACETS_MUTATION, 'configureFieldFacets', { propertyId, fields }, options);
+        },
         values: {
             get: (productId, options) => call(PRODUCT_PROPERTY_VALUES_QUERY, 'productPropertyValues', { productId }, options),
             async set(productId, values, options) {