@sixtyninecommerce/admin 0.10.0 → 0.11.0

package/dist/catalog/products.js

@@ -1,9 +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`).
@@ -29,11 +31,19 @@ export const PRODUCT_FIELDS = /* GraphQL */ `
     id
     code
     name
+    customFields {
+      isShared
+    }
     options {
       id
       code
       name
     }
+    translations {
+      id
+      languageCode
+      name
+    }
   }
   translations {
     id
@@ -50,6 +60,8 @@ export const PRODUCT_FIELDS = /* GraphQL */ `
     availabilityState
     availableFrom
     preorderLimit
+    brand
+    condition
   }
 `;
 export const PRODUCTS_QUERY = /* GraphQL */ `
@@ -60,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 */ `
@@ -196,15 +235,28 @@ export const SAVE_PRODUCT_MUTATION = /* GraphQL */ `
  * 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, brand, condition, ...rest } = input;
     const customFields = availabilityCustomFields({
@@ -237,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' });
 }
@@ -290,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
@@ -362,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', {

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) {

package/dist/catalog/recommendations.d.ts

@@ -0,0 +1,261 @@
+/**
+ * Product recommendations (headless spec §9.2 `catalog`: "recommendations"; W10-13): the store's
+ * recommendation groups ("Customers also bought", "Complete the look"), what each one draws its
+ * products from, and the products hand-picked per product for a manual group.
+ *
+ * - **A `DYNAMIC` group's entries are its rules**, read in `position` order: one named product
+ *   (`PRODUCT`), the products of a collection (`COLLECTION`) or with a facet value
+ *   (`FACET_VALUE`), or the viewed product's own collections (`SAME_COLLECTION`) or properties
+ *   (`SAME_PROPERTIES`). The storefront fills the group up to `maxItems` from the first entry on,
+ *   never with the viewed product, a disabled product or one the store hides from the shopper.
+ * - **A `MANUAL` group has no entries**: its products are picked per viewed product
+ *   (`manual.set`), and the storefront shows them in the order picked. A group's mode is chosen
+ *   when it is created and never changes.
+ * - **A disabled group** (`enabled: false`) is kept but never shown on the storefront.
+ * - **Positions** are integers; a group or entry created without one goes after the last.
+ *   `reorder` rewrites them as `0, 1, 2…` in the order given.
+ *
+ * Permissions: reads need `ReadCatalog`, writes `UpdateCatalog`. Every row is the store's own: a
+ * group or entry of another store is never answered and never changed (a read answers `null` or
+ * leaves it out; a write refuses it as unknown), and a rule only ever draws from the store's own
+ * products, collections and facet values.
+ *
+ * Refusals, GraphQL errors mapped by `core`. An unknown id and another store's get the same answer,
+ * so none tells whether another store holds the row:
+ * - `ENTITY_NOT_FOUND` → `NotFoundError` (404): a group or entry the store does not have, and the
+ *   viewed product of `manual.set` when the store does not hold it.
+ * - `RECOMMENDATION_SOURCE_NOT_FOUND` → `NotFoundError` (404): a rule's `sourceId` that is not a
+ *   product, collection or facet value of the store (`entries.create`, `entries.update`).
+ * - `RECOMMENDATION_TARGET_NOT_FOUND` → `NotFoundError` (404): `manual.set` picks the store does
+ *   not hold, each named in the message and in `details` (`field` `/targetProductIds/<index>`).
+ * - `RECOMMENDATION_GROUP_SLUG_TAKEN` → `ConflictError` (409): another of the store's groups holds
+ *   the slug, also when two writes race for one free slug.
+ * - `USER_INPUT_ERROR` → `ValidationError` (400), in the engine's words: a rule that does not fit
+ *   its group or its type (a `MANUAL` group, a `sourceId` missing or sent where none goes), picks
+ *   in a `DYNAMIC` group.
+ * - `FORBIDDEN` → `PermissionDeniedError` (403) without the permission.
+ *
+ * An id that is not a uuid (any id argument, a `sourceId` and each pick included) is refused
+ * before all of these with core's `ENTITY_NOT_FOUND` (`NotFoundError`, 404, no `details`), so
+ * branch on the class for not-found and on the code only to tell which row is missing.
+ *
+ * A platform release older than these codes answers each not-found and a taken slug as
+ * `USER_INPUT_ERROR` (400) in its own words ("Recommendation group not found"), a slug lost in a
+ * race as `DUPLICATE_RECORD`, and takes another store's collection or facet value as a rule's
+ * source.
+ *
+ * No release gate: every operation here is served by every platform release this SDK supports.
+ * No method deduplicates on `idempotencyKey`: repeating a `create` makes a second row.
+ */
+import type { Transport } from '@sixtyninecommerce/core';
+import type { Call } from '../types.js';
+/** What a `DYNAMIC` group's entry draws its products from. */
+export type RecommendationSourceType = 'PRODUCT' | 'COLLECTION' | 'FACET_VALUE' | 'SAME_COLLECTION' | 'SAME_PROPERTIES';
+/** `DYNAMIC`: rules (entries). `MANUAL`: products picked per viewed product (`manual.set`). */
+export type RecommendationGroupMode = 'DYNAMIC' | 'MANUAL';
+/** The source types whose entry names a row (`sourceId`); the others must name none. */
+export declare const RECOMMENDATION_SOURCE_TYPES_WITH_ID: readonly RecommendationSourceType[];
+/** One rule of a `DYNAMIC` group. */
+export interface RecommendationEntry {
+    id: string;
+    groupId: string;
+    sourceType: RecommendationSourceType;
+    /**
+     * The product, collection or facet value for `PRODUCT`, `COLLECTION` and `FACET_VALUE`; `null`
+     * for `SAME_COLLECTION` and `SAME_PROPERTIES`. Always a row of this store when it was written:
+     * `entries.create` and `entries.update` refuse any other (`RECOMMENDATION_SOURCE_NOT_FOUND`). A
+     * row deleted or taken out of the store since adds nothing, and the storefront never draws from
+     * another store's collection or facet value, a rule stored before the refusal included. A deleted
+     * product's `PRODUCT` entries are removed with it.
+     */
+    sourceId: string | null;
+    position: number;
+    /** ISO-8601 UTC. */
+    createdAt: string;
+    /** ISO-8601 UTC. */
+    updatedAt: string;
+}
+/** A group without its entries, as `manual.get` and `manual.set` answer it. */
+export interface RecommendationGroupSummary {
+    id: string;
+    name: string;
+    /** Unique within the store; the storefront asks for one group by it. */
+    slug: string;
+    description: string | null;
+    /** The most products the storefront shows for this group. */
+    maxItems: number;
+    position: number;
+    enabled: boolean;
+    mode: RecommendationGroupMode;
+    /** ISO-8601 UTC. */
+    createdAt: string;
+    /** ISO-8601 UTC. */
+    updatedAt: string;
+}
+export interface RecommendationGroup extends RecommendationGroupSummary {
+    /** In `position` order (ties: the older first). Always empty on a `MANUAL` group. */
+    entries: RecommendationEntry[];
+}
+/** One `MANUAL` group and the products picked in it for one viewed product. */
+export interface ProductManualRecommendations {
+    group: RecommendationGroupSummary;
+    /** In the order picked; empty when none are. */
+    productIds: string[];
+}
+export interface CreateRecommendationGroupInput {
+    name: string;
+    /** Defaults to the name, lower-cased, every run of other characters than `a-z0-9` a `-`. */
+    slug?: string;
+    description?: string;
+    /** Defaults to 10. The engine sets no bounds. */
+    maxItems?: number;
+    /** Defaults to after the store's last group. */
+    position?: number;
+    /** Defaults to true. */
+    enabled?: boolean;
+    /** Defaults to `DYNAMIC`; never changes afterwards. */
+    mode?: RecommendationGroupMode;
+}
+/** Only the fields named change; `description: null` clears it. */
+export interface UpdateRecommendationGroupInput {
+    name?: string;
+    slug?: string;
+    description?: string | null;
+    maxItems?: number;
+    position?: number;
+    enabled?: boolean;
+}
+export interface CreateRecommendationEntryInput {
+    groupId: string;
+    sourceType: RecommendationSourceType;
+    /** Required for `PRODUCT`, `COLLECTION` and `FACET_VALUE`; refused for the other two. */
+    sourceId?: string;
+    /** Defaults to after the group's last entry. */
+    position?: number;
+}
+/** Only the fields named change; `sourceId: null` clears it (for a `SAME_*` source type). */
+export interface UpdateRecommendationEntryInput {
+    sourceType?: RecommendationSourceType;
+    sourceId?: string | null;
+    position?: number;
+}
+export interface RecommendationsModule {
+    groups: {
+        /**
+         * Every group of the store, in `position` order (ties: the older first), each with its
+         * entries. The engine answers them all at once; there are no pages.
+         *
+         * @effect read
+         */
+        list(options?: Call): Promise<RecommendationGroup[]>;
+        /**
+         * One group with its entries; `null` when the store has no group with that id.
+         *
+         * @effect read
+         */
+        get(id: string, options?: Call): Promise<RecommendationGroup | null>;
+        /**
+         * Refused (`RECOMMENDATION_GROUP_SLUG_TAKEN`) when the store already has a group with that
+         * slug, the defaulted one included.
+         *
+         * @effect write
+         */
+        create(input: CreateRecommendationGroupInput, options?: Call): Promise<RecommendationGroup>;
+        /**
+         * Refused: a group the store does not have (`ENTITY_NOT_FOUND`), a slug another of its groups
+         * holds (`RECOMMENDATION_GROUP_SLUG_TAKEN`).
+         *
+         * @effect write
+         */
+        update(id: string, input: UpdateRecommendationGroupInput, options?: Call): Promise<RecommendationGroup>;
+        /**
+         * Deletes the group, its entries and every product's picks in it. Refused
+         * (`ENTITY_NOT_FOUND`) for a group the store does not have.
+         *
+         * @effect destructive
+         */
+        delete(id: string, options?: Call): Promise<void>;
+        /**
+         * Gives the named groups the positions `0, 1, 2…` in the order given, and answers every group
+         * as `list` does. An id the store does not hold is skipped without a word; a group left out
+         * keeps its position, which may then equal a named one's: name them all.
+         *
+         * @effect write
+         */
+        reorder(ids: string[], options?: Call): Promise<RecommendationGroup[]>;
+    };
+    /** The rules of `DYNAMIC` groups. */
+    entries: {
+        /**
+         * Refused: a group the store does not have (`ENTITY_NOT_FOUND`); a `sourceId` that is not a
+         * product, collection or facet value of the store (`RECOMMENDATION_SOURCE_NOT_FOUND`: another
+         * store's is refused like an unknown id); a `MANUAL` group, or a `sourceId` missing for
+         * `PRODUCT` / `COLLECTION` / `FACET_VALUE` or sent for `SAME_COLLECTION` / `SAME_PROPERTIES`
+         * (`USER_INPUT_ERROR`).
+         *
+         * @effect write
+         */
+        create(input: CreateRecommendationEntryInput, options?: Call): Promise<RecommendationEntry>;
+        /**
+         * Refused: an entry the store does not have (`ENTITY_NOT_FOUND`); a source type and
+         * `sourceId` that do not go together once the change is applied (`USER_INPUT_ERROR`); a
+         * change of either that leaves the rule naming no row of the store
+         * (`RECOMMENDATION_SOURCE_NOT_FOUND`). A change of `position` alone is not judged.
+         *
+         * @effect write
+         */
+        update(id: string, input: UpdateRecommendationEntryInput, options?: Call): Promise<RecommendationEntry>;
+        /**
+         * Refused (`ENTITY_NOT_FOUND`) for an entry the store does not have.
+         *
+         * @effect destructive
+         */
+        delete(id: string, options?: Call): Promise<void>;
+        /**
+         * Gives the group's named entries the positions `0, 1, 2…` in the order given, and answers
+         * the group's entries in `position` order. An id that is not one of THIS group's entries is
+         * skipped without a word (another group's entry never moves); an entry left out keeps its
+         * position. Refused (`ENTITY_NOT_FOUND`) for a group the store does not have.
+         *
+         * @effect write
+         */
+        reorder(groupId: string, ids: string[], options?: Call): Promise<RecommendationEntry[]>;
+    };
+    /** The products picked per viewed product in `MANUAL` groups (the product page's card). */
+    manual: {
+        /**
+         * Every `MANUAL` group of the store, in `position` order, each with the products picked for
+         * `productId`. A product with no picks (or none of this store) answers every group with an
+         * empty `productIds`; a store with no manual group answers `[]`.
+         *
+         * @effect read
+         */
+        get(productId: string, options?: Call): Promise<ProductManualRecommendations[]>;
+        /**
+         * Replaces the products picked for `productId` in one `MANUAL` group, in the order given:
+         * `[]` clears them. The product itself and repeats are dropped (the first one kept). One
+         * write: refused, nothing changes.
+         *
+         * Refused: a group the store does not have, or `productId` not a product of this store
+         * (`ENTITY_NOT_FOUND`); a picked product that is not (`RECOMMENDATION_TARGET_NOT_FOUND`,
+         * naming each, `details` pointing at where it was sent); a `DYNAMIC` group
+         * (`USER_INPUT_ERROR`).
+         *
+         * @effect write
+         */
+        set(productId: string, groupId: string, productIds: string[], options?: Call): Promise<RecommendationGroupSummary>;
+    };
+}
+export declare const RECOMMENDATION_GROUPS_QUERY = "\n  query CatalogRecommendationGroups {\n    recommendationGroups { \n  \n  id\n  name\n  slug\n  description\n  maxItems\n  position\n  enabled\n  mode\n  createdAt\n  updatedAt\n\n  entries { \n  id\n  groupId\n  sourceType\n  sourceId\n  position\n  createdAt\n  updatedAt\n }\n }\n  }\n";
+export declare const RECOMMENDATION_GROUP_QUERY = "\n  query CatalogRecommendationGroup($id: ID!) {\n    recommendationGroup(id: $id) { \n  \n  id\n  name\n  slug\n  description\n  maxItems\n  position\n  enabled\n  mode\n  createdAt\n  updatedAt\n\n  entries { \n  id\n  groupId\n  sourceType\n  sourceId\n  position\n  createdAt\n  updatedAt\n }\n }\n  }\n";
+export declare const CREATE_RECOMMENDATION_GROUP_MUTATION = "\n  mutation CatalogCreateRecommendationGroup($input: CreateRecommendationGroupInput!) {\n    createRecommendationGroup(input: $input) { \n  \n  id\n  name\n  slug\n  description\n  maxItems\n  position\n  enabled\n  mode\n  createdAt\n  updatedAt\n\n  entries { \n  id\n  groupId\n  sourceType\n  sourceId\n  position\n  createdAt\n  updatedAt\n }\n }\n  }\n";
+export declare const UPDATE_RECOMMENDATION_GROUP_MUTATION = "\n  mutation CatalogUpdateRecommendationGroup($id: ID!, $input: UpdateRecommendationGroupInput!) {\n    updateRecommendationGroup(id: $id, input: $input) { \n  \n  id\n  name\n  slug\n  description\n  maxItems\n  position\n  enabled\n  mode\n  createdAt\n  updatedAt\n\n  entries { \n  id\n  groupId\n  sourceType\n  sourceId\n  position\n  createdAt\n  updatedAt\n }\n }\n  }\n";
+export declare const DELETE_RECOMMENDATION_GROUP_MUTATION = "\n  mutation CatalogDeleteRecommendationGroup($id: ID!) {\n    deleteRecommendationGroup(id: $id) { \n  result\n  message\n }\n  }\n";
+export declare const REORDER_RECOMMENDATION_GROUPS_MUTATION = "\n  mutation CatalogReorderRecommendationGroups($ids: [ID!]!) {\n    reorderRecommendationGroups(ids: $ids) { \n  \n  id\n  name\n  slug\n  description\n  maxItems\n  position\n  enabled\n  mode\n  createdAt\n  updatedAt\n\n  entries { \n  id\n  groupId\n  sourceType\n  sourceId\n  position\n  createdAt\n  updatedAt\n }\n }\n  }\n";
+export declare const CREATE_RECOMMENDATION_ENTRY_MUTATION = "\n  mutation CatalogCreateRecommendationEntry($input: CreateRecommendationEntryInput!) {\n    createRecommendationEntry(input: $input) { \n  id\n  groupId\n  sourceType\n  sourceId\n  position\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const UPDATE_RECOMMENDATION_ENTRY_MUTATION = "\n  mutation CatalogUpdateRecommendationEntry($id: ID!, $input: UpdateRecommendationEntryInput!) {\n    updateRecommendationEntry(id: $id, input: $input) { \n  id\n  groupId\n  sourceType\n  sourceId\n  position\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const DELETE_RECOMMENDATION_ENTRY_MUTATION = "\n  mutation CatalogDeleteRecommendationEntry($id: ID!) {\n    deleteRecommendationEntry(id: $id) { \n  result\n  message\n }\n  }\n";
+export declare const REORDER_RECOMMENDATION_ENTRIES_MUTATION = "\n  mutation CatalogReorderRecommendationEntries($groupId: ID!, $ids: [ID!]!) {\n    reorderRecommendationEntries(groupId: $groupId, ids: $ids) { \n  id\n  groupId\n  sourceType\n  sourceId\n  position\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare const PRODUCT_MANUAL_RECOMMENDATIONS_QUERY = "\n  query CatalogProductManualRecommendations($productId: ID!) {\n    productManualRecommendations(productId: $productId) {\n      group { \n  id\n  name\n  slug\n  description\n  maxItems\n  position\n  enabled\n  mode\n  createdAt\n  updatedAt\n }\n      productIds\n    }\n  }\n";
+export declare const SET_PRODUCT_MANUAL_RECOMMENDATIONS_MUTATION = "\n  mutation CatalogSetProductManualRecommendations(\n    $productId: ID!\n    $groupId: ID!\n    $targetProductIds: [ID!]!\n  ) {\n    setProductManualRecommendations(\n      productId: $productId\n      groupId: $groupId\n      targetProductIds: $targetProductIds\n    ) { \n  id\n  name\n  slug\n  description\n  maxItems\n  position\n  enabled\n  mode\n  createdAt\n  updatedAt\n }\n  }\n";
+export declare function createRecommendationsModule(transport: Transport): RecommendationsModule;