@sixtyninecommerce/admin 0.10.0 → 0.11.0

package/dist/catalog/collections.js

@@ -1,4 +1,30 @@
-import { ASSET_REF_FIELDS, assertDeleted, CATALOGUE_OWNERSHIP_FIELDS, DELETION_FIELDS, fieldOf, vendureListPage, } from './types.js';
+import { pageFromVendureList, ValidationError, } from '@sixtyninecommerce/core';
+import { createSearchModule } from '../search/index.js';
+import { ASSET_REF_FIELDS, assertDeleted, CATALOGUE_OWNERSHIP_FIELDS, DEFAULT_PAGE_SIZE, DELETION_FIELDS, fieldOf, toAssetRef, vendureListPage, } from './types.js';
+/** The most collections one {@link CollectionsModule.search} answers. */
+export const MAX_COLLECTION_SEARCH_TAKE = 100;
+const SEO_FIELDS = /* GraphQL */ `
+  customFields {
+    isRoutable
+    isCanonical
+    noindex
+    nofollow
+    metaRobotsMaxImagePreview
+    socialImageId
+    socialOgType
+    twitterCardType
+  }
+`;
+const TRANSLATION_SEO_FIELDS = /* GraphQL */ `
+  customFields {
+    seoTitle
+    seoDescription
+    canonicalUrl
+    socialTitle
+    socialDescription
+    socialImageAlt
+  }
+`;
 export const COLLECTION_FIELDS = /* GraphQL */ `
   id
   ${CATALOGUE_OWNERSHIP_FIELDS}
@@ -26,12 +52,14 @@ export const COLLECTION_FIELDS = /* GraphQL */ `
     slug
   }
   productVariantCount
+  ${SEO_FIELDS}
   translations {
     id
     languageCode
     name
     slug
     description
+    ${TRANSLATION_SEO_FIELDS}
   }
 `;
 export const COLLECTIONS_QUERY = /* GraphQL */ `
@@ -44,7 +72,19 @@ export const COLLECTIONS_QUERY = /* GraphQL */ `
 `;
 export const COLLECTION_QUERY = /* GraphQL */ `
   query CatalogCollection($id: ID!) {
-    collection(id: $id) { ${COLLECTION_FIELDS} }
+    collection(id: $id) {
+      ${COLLECTION_FIELDS}
+      parent {
+        id
+        name
+      }
+      children {
+        id
+        name
+        slug
+        position
+      }
+    }
   }
 `;
 export const CREATE_COLLECTION_MUTATION = /* GraphQL */ `
@@ -67,25 +107,216 @@ export const MOVE_COLLECTION_MUTATION = /* GraphQL */ `
     moveCollection(input: $input) { ${COLLECTION_FIELDS} }
   }
 `;
+export const COLLECTION_FILTER_DEFINITIONS_QUERY = /* GraphQL */ `
+  query CatalogCollectionFilterDefinitions {
+    collectionFilters {
+      code
+      description
+      args {
+        name
+        type
+        list
+        required
+        defaultValue
+        label
+        description
+        ui
+      }
+    }
+  }
+`;
+/**
+ * The preview's price is `storePrice` (null for a variant the store has no price for), never
+ * core's `price` / `priceWithTax` / `currencyCode`, which raise "No price information was
+ * found…" for such a variant and, being non-null, empty the whole preview (#1504).
+ */
+export const PREVIEW_COLLECTION_VARIANTS_QUERY = /* GraphQL */ `
+  query CatalogPreviewCollectionVariants(
+    $input: PreviewCollectionVariantsInput!
+    $options: ProductVariantListOptions
+  ) {
+    previewCollectionVariants(input: $input, options: $options) {
+      items {
+        id
+        name
+        sku
+        storePrice {
+          price
+          priceWithTax
+          currencyCode
+        }
+        product {
+          id
+          name
+          featuredAsset { ${ASSET_REF_FIELDS} }
+        }
+      }
+      totalItems
+    }
+  }
+`;
+const COLLECTION_SORT_FIELDS = [
+    'position',
+    'name',
+    'createdAt',
+    'updatedAt',
+    'id',
+];
+function toPreviewVariant(wire) {
+    const { featuredAsset, ...product } = wire.product;
+    return {
+        ...wire,
+        product: { ...product, featuredAsset: featuredAsset ? toAssetRef(featuredAsset) : null },
+    };
+}
+function toSeo(wire) {
+    return {
+        isRoutable: wire?.isRoutable ?? null,
+        isCanonical: wire?.isCanonical ?? null,
+        noindex: wire?.noindex ?? null,
+        nofollow: wire?.nofollow ?? null,
+        metaRobotsMaxImagePreview: wire?.metaRobotsMaxImagePreview ?? null,
+        socialImageId: wire?.socialImageId ?? null,
+        socialOgType: wire?.socialOgType ?? null,
+        twitterCardType: wire?.twitterCardType ?? null,
+    };
+}
+function toTranslationSeo(wire) {
+    return {
+        seoTitle: wire?.seoTitle ?? null,
+        seoDescription: wire?.seoDescription ?? null,
+        canonicalUrl: wire?.canonicalUrl ?? null,
+        socialTitle: wire?.socialTitle ?? null,
+        socialDescription: wire?.socialDescription ?? null,
+        socialImageAlt: wire?.socialImageAlt ?? null,
+    };
+}
+function toCollection(wire) {
+    const { customFields, translations, featuredAsset, assets, ...rest } = wire;
+    return {
+        ...rest,
+        featuredAsset: featuredAsset ? toAssetRef(featuredAsset) : null,
+        assets: (assets ?? []).map(toAssetRef),
+        seo: toSeo(customFields),
+        translations: (translations ?? []).map(({ customFields: seo, ...translation }) => ({
+            ...translation,
+            seo: toTranslationSeo(seo),
+        })),
+    };
+}
+/** `seo` goes on the wire as the engine's `customFields`, only the keys the caller named. */
+function toWireTranslation(translation) {
+    const { seo, ...rest } = translation;
+    return seo === undefined ? rest : { ...rest, customFields: { ...seo } };
+}
+function toWireInput(input) {
+    const { seo, translations, ...rest } = input;
+    return {
+        ...rest,
+        ...(translations === undefined ? {} : { translations: translations.map(toWireTranslation) }),
+        ...(seo === undefined ? {} : { customFields: { ...seo } }),
+    };
+}
+function invalidSort(sort) {
+    return new ValidationError({
+        code: 'INVALID_COLLECTION_SORT',
+        message: `sort must name one of ${COLLECTION_SORT_FIELDS.join(', ')} and the direction ASC or DESC; got ${JSON.stringify(sort)}. Nothing was sent.`,
+        status: 400,
+        service: 'vendure',
+    });
+}
+function listOptionsOf(options) {
+    const filter = {};
+    if (options?.parentId !== undefined)
+        filter.parentId = { eq: options.parentId };
+    if (options?.name !== undefined)
+        filter.name = { contains: options.name };
+    if (options?.ids !== undefined)
+        filter.id = { in: [...options.ids] };
+    const sort = options?.sort;
+    if (sort !== undefined &&
+        (!COLLECTION_SORT_FIELDS.includes(sort.field) ||
+            (sort.direction !== 'ASC' && sort.direction !== 'DESC'))) {
+        throw invalidSort(sort);
+    }
+    return {
+        ...(options?.topLevelOnly === true ? { topLevelOnly: true } : {}),
+        ...(Object.keys(filter).length > 0 ? { filter } : {}),
+        ...(sort === undefined ? {} : { sort: { [sort.field]: sort.direction } }),
+    };
+}
+function invalidSearch(message) {
+    return new ValidationError({
+        code: 'SEARCH_INPUT_INVALID',
+        message: `${message} Nothing was sent.`,
+        status: 400,
+        service: 'vendure',
+    });
+}
 export function createCollectionsModule(transport) {
+    const write = async (document, field, variables, options) => toCollection(await fieldOf(transport, document, field, variables, options));
+    const list = async (options) => {
+        const listOptions = listOptionsOf(options);
+        if (options?.ids !== undefined && options.ids.length === 0) {
+            return pageFromVendureList({ items: [], totalItems: 0 }, 0, options.limit ?? DEFAULT_PAGE_SIZE, () => Promise.reject(new Error('an empty page has no next page')));
+        }
+        return vendureListPage(transport, COLLECTIONS_QUERY, 'collections', (skip, take) => ({ options: { skip, take, ...listOptions } }), options, toCollection);
+    };
     return {
-        list: (options) => {
-            const filter = {};
-            if (options?.parentId !== undefined)
-                filter.parentId = { eq: options.parentId };
-            if (options?.name !== undefined)
-                filter.name = { contains: options.name };
-            return vendureListPage(transport, COLLECTIONS_QUERY, 'collections', (skip, take) => ({
-                options: { skip, take, ...(Object.keys(filter).length > 0 ? { filter } : {}) },
-            }), options);
+        list,
+        async get(id, options) {
+            const collection = await fieldOf(transport, COLLECTION_QUERY, 'collection', { id }, options);
+            return collection ? toCollection(collection) : null;
         },
-        get: (id, options) => fieldOf(transport, COLLECTION_QUERY, 'collection', { id }, options),
-        create: (input, options) => fieldOf(transport, CREATE_COLLECTION_MUTATION, 'createCollection', { input }, options),
-        update: (input, options) => fieldOf(transport, UPDATE_COLLECTION_MUTATION, 'updateCollection', { input }, options),
+        async search(term, options = {}) {
+            const { take = DEFAULT_PAGE_SIZE, skip = 0, ...call } = options;
+            if (!Number.isInteger(take) || take < 1 || take > MAX_COLLECTION_SEARCH_TAKE) {
+                throw invalidSearch(`take must be a whole number from 1 to ${String(MAX_COLLECTION_SEARCH_TAKE)}; got ${String(take)}.`);
+            }
+            if (!Number.isInteger(skip) || skip < 0) {
+                throw invalidSearch(`skip must be a whole number from 0; got ${String(skip)}.`);
+            }
+            const hits = await createSearchModule(transport).index('collections', { term, take, skip }, call);
+            const ids = [...new Set(hits.items.map((hit) => hit.id))];
+            if (ids.length === 0)
+                return { items: [], total: hits.total };
+            // The index says which and in what order; the rows are the engine's, read in the store the
+            // call acts on, so a collection the store no longer holds is not answered.
+            const page = await list({ ...call, ids, limit: ids.length });
+            const byId = new Map(page.items.map((collection) => [collection.id, collection]));
+            return {
+                items: ids.flatMap((id) => {
+                    const collection = byId.get(id);
+                    return collection ? [collection] : [];
+                }),
+                total: hits.total,
+            };
+        },
+        create: (input, options) => write(CREATE_COLLECTION_MUTATION, 'createCollection', { input: toWireInput(input) }, options),
+        update: (input, options) => write(UPDATE_COLLECTION_MUTATION, 'updateCollection', { input: toWireInput(input) }, options),
         async delete(id, options) {
             const response = await fieldOf(transport, DELETE_COLLECTION_MUTATION, 'deleteCollection', { id }, options);
             assertDeleted('COLLECTION_NOT_DELETED', [response]);
         },
-        move: (collectionId, parentId, index, options) => fieldOf(transport, MOVE_COLLECTION_MUTATION, 'moveCollection', { input: { collectionId, parentId, index } }, options),
+        move: (collectionId, parentId, index, options) => write(MOVE_COLLECTION_MUTATION, 'moveCollection', { input: { collectionId, parentId, index } }, options),
+        filterDefinitions: (options) => fieldOf(transport, COLLECTION_FILTER_DEFINITIONS_QUERY, 'collectionFilters', {}, options),
+        previewVariants(input, options = {}) {
+            const { term: rawTerm, ...listOptions } = options;
+            const term = rawTerm?.trim() ?? '';
+            const filter = term === ''
+                ? {}
+                : {
+                    filter: { name: { contains: term }, sku: { contains: term } },
+                    filterOperator: 'OR',
+                };
+            return vendureListPage(transport, PREVIEW_COLLECTION_VARIANTS_QUERY, 'previewCollectionVariants', (skip, take) => ({
+                input: {
+                    filters: input.filters,
+                    inheritFilters: input.inheritFilters,
+                    ...(input.parentId === undefined ? {} : { parentId: input.parentId }),
+                },
+                options: { skip, take, ...filter },
+            }), listOptions, toPreviewVariant);
+        },
     };
 }

package/dist/catalog/index.d.ts

@@ -6,12 +6,15 @@ import { type FacetsModule } from './facets.js';
 import { type OptionsModule } from './options.js';
 import { type ProductsModule } from './products.js';
 import { type ContentFacetSyncResult, type PropertiesModule } from './properties.js';
+import { type RecommendationsModule } from './recommendations.js';
+import { type ReviewsModule } from './reviews.js';
 import { type VariantsModule } from './variants.js';
 import { type VisibilityModule } from './visibility.js';
 /**
  * The catalogue (spec §9.2 `catalog`): products, variants, options, facets,
- * collections, assets, storefront visibility and product properties — one
- * resource per namespace, over the Admin API the dashboard itself uses.
+ * collections, assets, storefront visibility, product properties, product
+ * recommendations and product reviews — one resource per namespace, over the Admin API the
+ * dashboard itself uses.
  *
  * **Per-resource, not per-intent.** Saving a product form is several calls
  * here (the product, its variants, its properties, its collections), and they
@@ -70,6 +73,10 @@ export interface CatalogModule {
     assets: AssetsModule;
     visibility: VisibilityModule;
     properties: PropertiesModule;
+    /** Recommendation groups, their rules and the products picked per product (W10-13). */
+    recommendations: RecommendationsModule;
+    /** Product reviews: moderation, the store's replies, statistics, review attributes (W10-117). */
+    reviews: ReviewsModule;
     /**
      * "Sync filter values" for one filterable `content_item` or `product` property, done by the
      * engine (headless spec §7 `catalog.syncContentFacets`, by property, the unit the merchant syncs).

package/dist/catalog/index.js

@@ -4,6 +4,8 @@ import { createFacetsModule } from './facets.js';
 import { createOptionsModule } from './options.js';
 import { createProductsModule } from './products.js';
 import { createPropertiesModule, syncContentFacets, } from './properties.js';
+import { createRecommendationsModule } from './recommendations.js';
+import { createReviewsModule } from './reviews.js';
 import { createVariantsModule } from './variants.js';
 import { createVisibilityModule } from './visibility.js';
 export function createCatalogModule(transport) {
@@ -16,6 +18,8 @@ export function createCatalogModule(transport) {
         assets: createAssetsModule(transport),
         visibility: createVisibilityModule(transport),
         properties: createPropertiesModule(transport),
+        recommendations: createRecommendationsModule(transport),
+        reviews: createReviewsModule(transport),
         syncContentFacets: (propertyId, options) => syncContentFacets(transport, propertyId, options),
     };
 }

package/dist/catalog/products.d.ts

@@ -2,8 +2,8 @@ import { type Page, type Transport } from '@sixtyninecommerce/core';
 import type { JobHandle } from '../jobs/index.js';
 import type { Call, ListOptions } from '../types.js';
 import { type ProductBulkInput, type ProductBulkRun } from './products-bulk.js';
-import { type AssetRef, type Availability, type AvailabilityInput, type CatalogueOwnership, type FacetValueRef, type LanguageCode, type PriceBasis, type ProductAvailabilityState, type TranslationInput, type VariantAvailabilityState } from './types.js';
-import { type ParcelPacking, type VariantBackorderPolicy, type VariantPriceInput } from './variants.js';
+import { type AssetRef, type Availability, type AvailabilityInput, type CatalogueOwnership, type FacetValueRef, type LanguageCode, type PriceBasis, type ProductAvailabilityState, type TranslationInput, type VariantAvailabilityState, type WireAssetRef } from './types.js';
+import { type ParcelPacking, type VariantBackorderPolicy, type VariantPriceInput, type VariantStorePrice } from './variants.js';
 export interface ProductOptionRef {
     id: string;
     code: string;
@@ -13,7 +13,18 @@ export interface ProductOptionGroupRef {
     id: string;
     code: string;
     name: string;
+    /**
+     * The group is offered for reuse on the store's other products (the option-group editor's
+     * "shared" switch); false for a group made for this product alone.
+     */
+    isShared: boolean;
     options: ProductOptionRef[];
+    /** The group's name in each language it has one in. */
+    translations: Array<{
+        id: string;
+        languageCode: LanguageCode;
+        name: string;
+    }>;
 }
 export interface ProductTranslation {
     id: string;
@@ -51,6 +62,27 @@ export interface Product extends Availability<ProductAvailabilityState> {
      * product and in an organization's workspace.
      */
     excludedFromStore: boolean;
+    /** The brand feeds name; null when none is set. */
+    brand: string | null;
+    /**
+     * The condition feeds state; null when none is set. A string on the wire: a stored value
+     * outside {@link ProductCondition} is answered as it is.
+     */
+    condition: ProductCondition | (string & {}) | null;
+}
+/** A collection a product is in, as {@link ProductsModule.get} names it. */
+export interface ProductCollectionRef {
+    id: string;
+    name: string;
+    slug: string;
+}
+/** A product as {@link ProductsModule.get} reads it: the {@link Product} and its collections. */
+export interface ProductDetail extends Product {
+    /**
+     * Every collection of the store the product is in, by hand or through a collection's other
+     * filters, in the language the call asked for.
+     */
+    collections: ProductCollectionRef[];
 }
 export interface ProductTranslationInput extends TranslationInput {
     name?: string;
@@ -102,6 +134,24 @@ export interface ProductListOptions extends ListOptions {
 }
 /** The engine's bound on one `exclude` or `include` call (`STORE_EXCLUSION_BATCH_LIMIT`). */
 export declare const MAX_STORE_EXCLUSION_PRODUCTS = 500;
+/** At most this many distinct products per {@link ProductsModule.storePriceRanges} call. */
+export declare const MAX_STORE_PRICE_RANGE_PRODUCTS = 100;
+/**
+ * The cheapest and the dearest of a product's variants in the ACTIVE store and the request's
+ * currency, as `ProductVariant.storePrice` prices them (stored prices and prices converted at the
+ * store's rate, compared). `price` is net and `priceWithTax` gross, as on `storePrice`.
+ */
+export interface ProductStorePriceRange {
+    min: VariantStorePrice;
+    max: VariantStorePrice;
+    /** At least one variant the store holds has no price in it; it is left out of min and max, never counted as 0. */
+    someVariantsUnpriced: boolean;
+}
+export interface ProductStorePriceRangeEntry {
+    productId: string;
+    /** Null when the store prices none of the product's variants it holds. */
+    range: ProductStorePriceRange | null;
+}
 /**
  * The engine's bounds on one `setAvailabilityInStores` or `availabilityInStores` call
  * (`AVAILABILITY_*_LIMIT`).
@@ -320,14 +370,66 @@ export interface SaveProductResult {
  * refuses".
  */
 export interface ProductsModule {
+    /** @effect read */
     list(options?: ProductListOptions): Promise<Page<Product>>;
-    /** Null for an id this store does not have — the same answer another tenant's product gets. */
-    get(id: string, options?: Call): Promise<Product | null>;
+    /**
+     * One product with the collections it is in; null for an id this store does not have — the
+     * same answer another tenant's product gets. Its variants are not part of it, however few: read
+     * them a page at a time with `catalog.variants.list(productId)` (a product can have 100,000).
+     *
+     * @effect read
+     */
+    get(id: string, options?: Call): Promise<ProductDetail | null>;
+    /**
+     * Create a product, without variants (`catalog.variants.create` adds them). Needs
+     * `CreateCatalog` or `CreateProduct`.
+     *
+     * A new translation needs a name; its slug, when left out, is made from the name in that
+     * language, and its description is `''` (multi-region decision 106).
+     *
+     * Refusals (nothing is written):
+     * - `INVALID_PRODUCT_INPUT` → `ValidationError` (400): no translation; refused before sending.
+     * - `TRANSLATION_INPUT_INVALID` → `ValidationError` (400): a translation without a name, or
+     *   with a name no slug can be made from (`!!!`) and no slug. One `details` entry per refused
+     *   field, each message naming the language and the field; the entries carry no `field`
+     *   pointer (the engine refuses below the call's arguments).
+     * - `TRANSLATION_LANGUAGE_NOT_OFFERED` → `BusinessRuleError` (422): a translation in a
+     *   language the store does not offer. `details[].field` points at the translation entry
+     *   (`/input/translations/<i>`); `message` names the language and the ones the store offers.
+     * - `FEED_IDENTIFIER_INVALID` → `ValidationError` (400): a brand over 70 characters.
+     * - `INVALID_DATETIME` → `ValidationError` (400): an `availableFrom` without an offset;
+     *   refused before sending.
+     *
+     * @effect write
+     */
     create(input: CreateProductInput, options?: Call): Promise<Product>;
+    /**
+     * A PATCH of the product's own fields. A translation for a language the product has no row in
+     * is a NEW row, judged as on {@link create}; an existing row keeps what the input leaves out,
+     * and setting its name or slug to null is refused `TRANSLATION_INPUT_INVALID`. The other
+     * refusals are {@link create}'s, plus `FIELD_GROUP_LOCKED` and `MANAGED_BY_ORGANIZATION`
+     * (see above).
+     *
+     * @effect write
+     */
     update(input: UpdateProductInput, options?: Call): Promise<Product>;
     /**
-     * Soft-deletes the product and its variants. `PRODUCT_NOT_DELETED`
-     * (`ConflictError`) carries the engine's own reason when it refuses.
+     * Soft-deletes the product and its variants: they are no longer listed, and orders keep the
+     * lines that name them. Nothing in this SDK restores it. Needs `DeleteCatalog` or
+     * `DeleteProduct`.
+     *
+     * Refusals (nothing is deleted):
+     * - `PRODUCT_NOT_DELETED` → `ConflictError` (409): the engine declined, in its own words.
+     * - `ENTITY_NOT_FOUND` → `NotFoundError` (404): a product this store does not hold.
+     * - `SHARED_PRODUCT_NOT_ALLOWED` → `PermissionDeniedError` (403): another store also holds it,
+     *   and you may not delete there.
+     * - `MANAGED_BY_ORGANIZATION` → `BusinessRuleError` (422): a product of the store's
+     *   organization.
+     * - `FIELD_GROUP_LOCKED` → `BusinessRuleError` (422): an app or API token owns a field group of
+     *   the product or its variants.
+     * - `EXTERNAL_LINE_CARRIER_PROTECTED` → `BusinessRuleError` (422): the platform's carrier.
+     *
+     * @effect destructive
      */
     delete(id: string, options?: Call): Promise<void>;
     /**
@@ -428,6 +530,23 @@ export interface ProductsModule {
      *   store that is not a member.
      */
     availabilityInStores(input: AvailabilityInStoresInput, options?: Call): Promise<OrganizationProductStoreAvailability[]>;
+    /**
+     * Each product's price range in the ACTIVE store and the request's currency
+     * (`Product.storePriceRange`), for a page of products in ONE request: the engine ranks only the
+     * variants the store holds, by the store's own prices. Use it rather than the first and last
+     * variant of a price-sorted variant list, which cannot compare stored prices with converted ones
+     * nor say that some variants are unpriced. One entry per distinct product, in the order named;
+     * a product the store does not hold is left out, the same answer another tenant's product gets.
+     * No ids answers none, without a request. Needs `ReadCatalog`.
+     *
+     * Refusals:
+     * - `PRODUCT_STORE_PRICE_RANGE_INPUT_INVALID` → `ValidationError` (400): more than
+     *   {@link MAX_STORE_PRICE_RANGE_PRODUCTS} distinct ids; refused before sending.
+     * - An engine without `Product.storePriceRange` (vendure-server before #1580) refuses the
+     *   document before running it: `ValidationError`, `GRAPHQL_VALIDATION_FAILED` (or
+     *   `BAD_REQUEST`), never an empty answer.
+     */
+    storePriceRanges(productIds: string[], options?: Call): Promise<ProductStorePriceRangeEntry[]>;
     /**
      * Make the ACTIVE member store's own copy of a product its organization shares with it, and
      * stop offering the shared one, in one step (a local copy, or detach; spec §7.2.8). The copy
@@ -617,28 +736,46 @@ export interface ProductsModule {
      */
     bulkRun(runId: string, options?: Call): Promise<ProductBulkRun>;
 }
-export declare const PRODUCT_FIELDS = "\n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n }\n  assets { \n  id\n  name\n  preview\n  source\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    options {\n      id\n      code\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n  }\n";
-export declare const PRODUCTS_QUERY = "\n  query CatalogProducts($options: ProductListOptions) {\n    products(options: $options) {\n      items { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n }\n  assets { \n  id\n  name\n  preview\n  source\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    options {\n      id\n      code\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n  }\n }\n      totalItems\n    }\n  }\n";
-export declare const PRODUCT_QUERY = "\n  query CatalogProduct($id: ID!) {\n    product(id: $id) { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n }\n  assets { \n  id\n  name\n  preview\n  source\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    options {\n      id\n      code\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n  }\n }\n  }\n";
-export declare const CREATE_PRODUCT_MUTATION = "\n  mutation CatalogCreateProduct($input: CreateProductInput!) {\n    createProduct(input: $input) { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n }\n  assets { \n  id\n  name\n  preview\n  source\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    options {\n      id\n      code\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n  }\n }\n  }\n";
-export declare const UPDATE_PRODUCT_MUTATION = "\n  mutation CatalogUpdateProduct($input: UpdateProductInput!) {\n    updateProduct(input: $input) { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n }\n  assets { \n  id\n  name\n  preview\n  source\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    options {\n      id\n      code\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n  }\n }\n  }\n";
+export declare const PRODUCT_FIELDS = "\n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  assets { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    customFields {\n      isShared\n    }\n    options {\n      id\n      code\n      name\n    }\n    translations {\n      id\n      languageCode\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n    brand\n    condition\n  }\n";
+export declare const PRODUCTS_QUERY = "\n  query CatalogProducts($options: ProductListOptions) {\n    products(options: $options) {\n      items { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  assets { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    customFields {\n      isShared\n    }\n    options {\n      id\n      code\n      name\n    }\n    translations {\n      id\n      languageCode\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n    brand\n    condition\n  }\n }\n      totalItems\n    }\n  }\n";
+export declare const PRODUCT_STORE_PRICE_RANGES_QUERY = "\n  query CatalogProductStorePriceRanges($options: ProductListOptions) {\n    products(options: $options) {\n      items {\n        id\n        storePriceRange {\n          min { price priceWithTax currencyCode }\n          max { price priceWithTax currencyCode }\n          someVariantsUnpriced\n        }\n      }\n    }\n  }\n";
+/**
+ * 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 declare const PRODUCT_QUERY = "\n  query CatalogProduct($id: ID!) {\n    product(id: $id) {\n      \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  assets { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    customFields {\n      isShared\n    }\n    options {\n      id\n      code\n      name\n    }\n    translations {\n      id\n      languageCode\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n    brand\n    condition\n  }\n\n      collections {\n        id\n        name\n        slug\n      }\n    }\n  }\n";
+export declare const CREATE_PRODUCT_MUTATION = "\n  mutation CatalogCreateProduct($input: CreateProductInput!) {\n    createProduct(input: $input) { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  assets { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    customFields {\n      isShared\n    }\n    options {\n      id\n      code\n      name\n    }\n    translations {\n      id\n      languageCode\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n    brand\n    condition\n  }\n }\n  }\n";
+export declare const UPDATE_PRODUCT_MUTATION = "\n  mutation CatalogUpdateProduct($input: UpdateProductInput!) {\n    updateProduct(input: $input) { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  assets { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    customFields {\n      isShared\n    }\n    options {\n      id\n      code\n      name\n    }\n    translations {\n      id\n      languageCode\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n    brand\n    condition\n  }\n }\n  }\n";
 export declare const DELETE_PRODUCT_MUTATION = "\n  mutation CatalogDeleteProduct($id: ID!) {\n    deleteProduct(id: $id) { \n  result\n  message\n }\n  }\n";
 export declare const CLONE_PRODUCT_MUTATION = "\n  mutation CatalogCloneProduct($id: ID!) {\n    cloneProduct(id: $id)\n  }\n";
-export declare const ADD_OPTION_GROUP_MUTATION = "\n  mutation CatalogAddOptionGroup($productId: ID!, $optionGroupId: ID!) {\n    addOptionGroupToProduct(productId: $productId, optionGroupId: $optionGroupId) { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n }\n  assets { \n  id\n  name\n  preview\n  source\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    options {\n      id\n      code\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n  }\n }\n  }\n";
-export declare const REMOVE_OPTION_GROUP_MUTATION = "\n  mutation CatalogRemoveOptionGroup($productId: ID!, $optionGroupId: ID!, $force: Boolean) {\n    removeOptionGroupFromProduct(productId: $productId, optionGroupId: $optionGroupId, force: $force) {\n      ... on Product { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n }\n  assets { \n  id\n  name\n  preview\n  source\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    options {\n      id\n      code\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n  }\n }\n      ... on ErrorResult {\n        errorCode\n        message\n      }\n    }\n  }\n";
-export declare const EXCLUDE_PRODUCTS_FROM_STORE_MUTATION = "\n  mutation CatalogExcludeProductsFromStore($productIds: [ID!]!) {\n    excludeProductsFromStore(productIds: $productIds) { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n }\n  assets { \n  id\n  name\n  preview\n  source\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    options {\n      id\n      code\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n  }\n }\n  }\n";
-export declare const INCLUDE_PRODUCTS_IN_STORE_MUTATION = "\n  mutation CatalogIncludeProductsInStore($productIds: [ID!]!) {\n    includeProductsInStore(productIds: $productIds) { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n }\n  assets { \n  id\n  name\n  preview\n  source\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    options {\n      id\n      code\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n  }\n }\n  }\n";
+export declare const ADD_OPTION_GROUP_MUTATION = "\n  mutation CatalogAddOptionGroup($productId: ID!, $optionGroupId: ID!) {\n    addOptionGroupToProduct(productId: $productId, optionGroupId: $optionGroupId) { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  assets { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    customFields {\n      isShared\n    }\n    options {\n      id\n      code\n      name\n    }\n    translations {\n      id\n      languageCode\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n    brand\n    condition\n  }\n }\n  }\n";
+export declare const REMOVE_OPTION_GROUP_MUTATION = "\n  mutation CatalogRemoveOptionGroup($productId: ID!, $optionGroupId: ID!, $force: Boolean) {\n    removeOptionGroupFromProduct(productId: $productId, optionGroupId: $optionGroupId, force: $force) {\n      ... on Product { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  assets { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    customFields {\n      isShared\n    }\n    options {\n      id\n      code\n      name\n    }\n    translations {\n      id\n      languageCode\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n    brand\n    condition\n  }\n }\n      ... on ErrorResult {\n        errorCode\n        message\n      }\n    }\n  }\n";
+export declare const EXCLUDE_PRODUCTS_FROM_STORE_MUTATION = "\n  mutation CatalogExcludeProductsFromStore($productIds: [ID!]!) {\n    excludeProductsFromStore(productIds: $productIds) { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  assets { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    customFields {\n      isShared\n    }\n    options {\n      id\n      code\n      name\n    }\n    translations {\n      id\n      languageCode\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n    brand\n    condition\n  }\n }\n  }\n";
+export declare const INCLUDE_PRODUCTS_IN_STORE_MUTATION = "\n  mutation CatalogIncludeProductsInStore($productIds: [ID!]!) {\n    includeProductsInStore(productIds: $productIds) { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  assets { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    customFields {\n      isShared\n    }\n    options {\n      id\n      code\n      name\n    }\n    translations {\n      id\n      languageCode\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n    brand\n    condition\n  }\n }\n  }\n";
 export declare const SET_ORGANIZATION_PRODUCT_AVAILABILITY_MUTATION = "\n  mutation CatalogSetOrganizationProductAvailability(\n    $productIds: [ID!]!\n    $channelIds: [ID!]!\n    $available: Boolean!\n  ) {\n    setOrganizationProductAvailability(\n      productIds: $productIds\n      channelIds: $channelIds\n      available: $available\n    ) {\n      productId\n      channelId\n      action\n    }\n  }\n";
 export declare const ORGANIZATION_PRODUCT_AVAILABILITY_QUERY = "\n  query CatalogOrganizationProductAvailability($productIds: [ID!]!, $channelIds: [ID!]!) {\n    organizationProductAvailability(productIds: $productIds, channelIds: $channelIds) {\n      productId\n      channelId\n      state\n      localCopyId\n    }\n  }\n";
-export declare const MAKE_LOCAL_COPY_MUTATION = "\n  mutation CatalogMakeLocalCopy($productId: ID!, $skus: [LocalCopySkuInput!]) {\n    makeLocalCopy(productId: $productId, skus: $skus) {\n      product { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n }\n  assets { \n  id\n  name\n  preview\n  source\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    options {\n      id\n      code\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n  }\n }\n      originalProductId\n      original\n      droppedOrganizationPropertyCount\n    }\n  }\n";
+export declare const MAKE_LOCAL_COPY_MUTATION = "\n  mutation CatalogMakeLocalCopy($productId: ID!, $skus: [LocalCopySkuInput!]) {\n    makeLocalCopy(productId: $productId, skus: $skus) {\n      product { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  assets { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    customFields {\n      isShared\n    }\n    options {\n      id\n      code\n      name\n    }\n    translations {\n      id\n      languageCode\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n    brand\n    condition\n  }\n }\n      originalProductId\n      original\n      droppedOrganizationPropertyCount\n    }\n  }\n";
 export declare const SET_PRODUCT_COLLECTIONS_MUTATION = "\n  mutation CatalogSetProductCollections(\n    $productId: ID!\n    $collectionIds: [ID!]!\n    $fromCollectionIds: [ID!]\n  ) {\n    setProductCollections(\n      productId: $productId\n      collectionIds: $collectionIds\n      fromCollectionIds: $fromCollectionIds\n    ) {\n      added\n      removed\n      unchanged\n      notRemoved {\n        collectionId\n        reason\n      }\n    }\n  }\n";
-export declare const SAVE_PRODUCT_MUTATION = "\n  mutation CatalogSaveProduct($input: SaveProductInput!, $idempotencyKey: String) {\n    saveProduct(input: $input, idempotencyKey: $idempotencyKey) {\n      product { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n }\n  assets { \n  id\n  name\n  preview\n  source\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    options {\n      id\n      code\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n  }\n }\n      collections {\n        added\n        removed\n        unchanged\n        notRemoved {\n          collectionId\n          reason\n        }\n      }\n      warnings {\n        code\n        message\n        propertyIds\n      }\n    }\n  }\n";
+export declare const SAVE_PRODUCT_MUTATION = "\n  mutation CatalogSaveProduct($input: SaveProductInput!, $idempotencyKey: String) {\n    saveProduct(input: $input, idempotencyKey: $idempotencyKey) {\n      product { \n  id\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n  createdAt\n  updatedAt\n  languageCode\n  name\n  slug\n  description\n  enabled\n  featuredAsset { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  assets { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n  customFields {\n    altText\n  }\n }\n  facetValues { \n  id\n  code\n  name\n  facet {\n    id\n    code\n    name\n  }\n }\n  optionGroups {\n    id\n    code\n    name\n    customFields {\n      isShared\n    }\n    options {\n      id\n      code\n      name\n    }\n    translations {\n      id\n      languageCode\n      name\n    }\n  }\n  translations {\n    id\n    languageCode\n    name\n    slug\n    description\n  }\n  excludedFromStore\n  variantList(options: { take: 1 }) {\n    totalItems\n  }\n  customFields {\n    availabilityState\n    availableFrom\n    preorderLimit\n    brand\n    condition\n  }\n }\n      collections {\n        added\n        removed\n        unchanged\n        notRemoved {\n          collectionId\n          reason\n        }\n      }\n      warnings {\n        code\n        message\n        propertyIds\n      }\n    }\n  }\n";
+/** An option group as the Admin API answers it inside a product, before `toProduct`. */
+interface WireProductOptionGroup extends Omit<ProductOptionGroupRef, 'isShared'> {
+    customFields: {
+        isShared?: boolean | null;
+    } | null;
+}
 /** The product as the Admin API answers it, before `toProduct`. */
-export interface WireProduct extends Omit<Product, keyof Availability<string> | 'variantCount'> {
+export interface WireProduct extends Omit<Product, keyof Availability<string> | 'variantCount' | 'featuredAsset' | 'assets' | 'optionGroups' | 'brand' | 'condition'> {
+    featuredAsset: WireAssetRef | null;
+    assets: WireAssetRef[];
+    optionGroups: WireProductOptionGroup[];
     variantList: {
         totalItems: number;
     };
-    customFields: Partial<Availability<ProductAvailabilityState>> | null;
+    customFields: (Partial<Availability<ProductAvailabilityState>> & {
+        brand?: string | null;
+        condition?: string | null;
+    }) | null;
 }
 /**
  * Lift the availability custom fields to first-class fields. A server older
@@ -647,4 +784,7 @@ export interface WireProduct extends Omit<Product, keyof Availability<string> |
  */
 export declare function toProduct(wire: WireProduct): Product;
 export declare function productFilter(filter: ProductListFilter | undefined): Record<string, unknown>;
+/** The engine's `ProductListOptions` for one page of {@link ProductListOptions}. */
+export declare function productListOptions(options: ProductListOptions | undefined, skip: number, take: number): Record<string, unknown>;
 export declare function createProductsModule(transport: Transport): ProductsModule;
+export {};