@sixtyninecommerce/admin 0.10.0 → 0.12.0

package/dist/catalog/index.js

@@ -1,9 +1,13 @@
 import { createAssetsModule } from './assets.js';
 import { createCollectionsModule } from './collections.js';
+import { createProductDocumentsModule } from './documents.js';
 import { createFacetsModule } from './facets.js';
+import { createProductMetadataModule } from './metadata.js';
 import { createOptionsModule } from './options.js';
 import { createProductsModule } from './products.js';
-import { createPropertiesModule, syncContentFacets, } from './properties.js';
+import { createPropertiesModule, syncContentFacets, syncContentItemFacets, } 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) {
@@ -15,7 +19,12 @@ export function createCatalogModule(transport) {
         collections: createCollectionsModule(transport),
         assets: createAssetsModule(transport),
         visibility: createVisibilityModule(transport),
+        documents: createProductDocumentsModule(transport),
+        metadata: createProductMetadataModule(transport),
         properties: createPropertiesModule(transport),
+        recommendations: createRecommendationsModule(transport),
+        reviews: createReviewsModule(transport),
         syncContentFacets: (propertyId, options) => syncContentFacets(transport, propertyId, options),
+        syncContentItemFacets: (contentItemIds, options) => syncContentItemFacets(transport, contentItemIds, options),
     };
 }

package/dist/catalog/metadata.d.ts

@@ -0,0 +1,244 @@
+/**
+ * A product's SEO, social and AI-agent metadata (headless spec §9.2 `catalog`: "metadata";
+ * W10-10): what the storefront puts in a product page's `<head>`, its share cards and its
+ * structured data. One record per product and store; its texts are per language.
+ *
+ * - **Partial writes.** `upsert` changes only the fields it names. A translation is written per
+ *   language: a language not sent keeps its values, and a field not sent in a sent language keeps
+ *   its value (send `null` to clear one).
+ * - **Coverage.** `coverage` lists the store's products with their own meta title and description
+ *   in one language, optionally only those missing one, filtered by the engine BEFORE the page is
+ *   cut: every page is full and `totalItems` counts the filter.
+ * - **Bulk.** `bulkUpsert` writes many products, each through `upsert`'s rules in a transaction
+ *   of its own and reported on its own (ruling G117).
+ *
+ * Every record is the store's own: a product of another store is never answered and never
+ * written.
+ *
+ * Permissions: `get` and `coverage` need `ReadCatalog`, the writes `UpdateCatalog`.
+ *
+ * Refusals, GraphQL errors mapped by `core`:
+ * - `PRODUCT_METADATA_INPUT_INVALID` → `ValidationError` (400): an input that breaks a rule (a
+ *   length, an allowed value, an `https://` URL, an instant without an offset, a language sent
+ *   twice). `details` names each failure (`field` an RFC 6901 pointer such as
+ *   `/input/translations/0/seoTitle`, `code` the rule such as `INVALID_FIELD_LENGTH`). Nothing is
+ *   written.
+ * - `ENTITY_NOT_FOUND` → `NotFoundError` (404): `upsert` of a product the store does not hold.
+ * - `TRANSLATION_LANGUAGE_NOT_OFFERED` → `ValidationError` (400): a new translation in a language
+ *   the store does not offer.
+ * - `BULK_ACTION_INPUT_INVALID` → `ValidationError` (400): a `bulkUpsert` of no product, more than
+ *   {@link MAX_BULK_METADATA_EDITS} or one product twice, refused before anything is sent.
+ * - `INVALID_DATETIME` → `ValidationError` (400): `metaRobotsUnavailableAfter` without an offset,
+ *   refused before anything is sent.
+ * - `FORBIDDEN` → `PermissionDeniedError` (403) without the permission.
+ *
+ * Release: `coverage` and `bulkUpsert` need a platform release with `productMetadataCoverage` and
+ * `bulkUpsertProductMetadata` (deploy vendure-server first: an older one refuses the document as
+ * `GRAPHQL_VALIDATION_FAILED`); on such a release `upsert` also answers a validation failure as an
+ * uncoded `INTERNAL_SERVER_ERROR` and writes a row for a product the store does not hold. `get`
+ * and `delete` are served by every release this SDK supports. No method deduplicates on
+ * `idempotencyKey`; every write is naturally repeatable.
+ */
+import { type Page, type Transport } from '@sixtyninecommerce/core';
+import type { Call, ListOptions } from '../types.js';
+import { type LanguageCode } from './types.js';
+/** How many products one `bulkUpsert` call may name. */
+export declare const MAX_BULK_METADATA_EDITS = 200;
+/** An image the metadata names (the share image, the X/Twitter override). */
+export interface ProductMetadataImage {
+    id: string;
+    name: string;
+    preview: string;
+    source: string;
+    /** A string on the wire: a newer engine may add a type. */
+    type: 'IMAGE' | 'VIDEO' | 'BINARY' | (string & {});
+    mimeType: string;
+}
+/**
+ * One language's texts. The four JSON fields are read as the engine stores them; every write
+ * checks them (`breadcrumbOverride` `{ label, url }[]` of at most 5, `focusKeywords` up to 10
+ * distinct strings, `qaPairs` `{ question, answer }[]` of at most 20), but read them defensively.
+ */
+export interface ProductMetadataTranslation {
+    id: string;
+    languageCode: LanguageCode;
+    seoTitle: string | null;
+    seoDescription: string | null;
+    canonicalUrl: string | null;
+    breadcrumbOverride: unknown;
+    focusKeywords: unknown;
+    socialTitle: string | null;
+    socialDescription: string | null;
+    socialImageAlt: string | null;
+    twitterTitleOverride: string | null;
+    twitterDescriptionOverride: string | null;
+    aiSummary: string | null;
+    qaPairs: unknown;
+}
+export interface ProductMetadata {
+    id: string;
+    productId: string;
+    channelId: string;
+    /** `index` or `noindex`. */
+    metaRobotsIndex: string;
+    /** `follow` or `nofollow`. */
+    metaRobotsFollow: string;
+    metaRobotsNoarchive: boolean;
+    metaRobotsNosnippet: boolean;
+    metaRobotsNoimageindex: boolean;
+    /** `none`, `standard` or `large`. */
+    metaRobotsMaxImagePreview: string;
+    metaRobotsMaxSnippet: number | null;
+    metaRobotsMaxVideoPreview: number | null;
+    /** ISO-8601 UTC instant after which search engines should drop the page; null when none. */
+    metaRobotsUnavailableAfter: string | null;
+    socialImageId: string | null;
+    socialImage: ProductMetadataImage | null;
+    twitterImageOverrideId: string | null;
+    twitterImageOverride: ProductMetadataImage | null;
+    twitterCardType: string;
+    socialOgType: string;
+    seoIncludeReviewsInJsonld: boolean;
+    aiSummaryAudience: string;
+    /** The product's own `{ [botKey]: 'allow' | 'deny' }`; null when it has none. */
+    aiBotOverrides: Record<string, unknown> | null;
+    qaEmitFaqpageJsonld: boolean;
+    hreflangOverrides: unknown;
+    /** The product's overrides on top of the store's defaults, as the storefront applies them. */
+    resolvedBotDirectives: Record<string, unknown>;
+    translations: ProductMetadataTranslation[];
+}
+export interface ProductMetadataTranslationInput {
+    languageCode: LanguageCode;
+    seoTitle?: string | null;
+    seoDescription?: string | null;
+    /** An absolute `https://` URL. */
+    canonicalUrl?: string | null;
+    breadcrumbOverride?: Array<{
+        label: string;
+        url: string;
+    }> | null;
+    focusKeywords?: string[] | null;
+    socialTitle?: string | null;
+    socialDescription?: string | null;
+    socialImageAlt?: string | null;
+    twitterTitleOverride?: string | null;
+    twitterDescriptionOverride?: string | null;
+    aiSummary?: string | null;
+    qaPairs?: Array<{
+        question: string;
+        answer: string;
+    }> | null;
+}
+/** Only the fields named change. */
+export interface ProductMetadataInput {
+    metaRobotsIndex?: 'index' | 'noindex';
+    metaRobotsFollow?: 'follow' | 'nofollow';
+    metaRobotsNoarchive?: boolean;
+    metaRobotsNosnippet?: boolean;
+    metaRobotsNoimageindex?: boolean;
+    metaRobotsMaxImagePreview?: 'none' | 'standard' | 'large';
+    metaRobotsMaxSnippet?: number | null;
+    metaRobotsMaxVideoPreview?: number | null;
+    /**
+     * An ISO-8601 instant WITH an explicit offset (`Z` or `±HH:mm`). One without is refused before
+     * the request leaves (`INVALID_DATETIME`).
+     */
+    metaRobotsUnavailableAfter?: string | null;
+    socialImageId?: string | null;
+    twitterImageOverrideId?: string | null;
+    twitterCardType?: 'summary' | 'summary_large_image';
+    socialOgType?: 'product' | 'website';
+    seoIncludeReviewsInJsonld?: boolean;
+    aiSummaryAudience?: 'customers' | 'developers' | 'both';
+    aiBotOverrides?: Record<string, 'allow' | 'deny'> | null;
+    qaEmitFaqpageJsonld?: boolean;
+    hreflangOverrides?: Array<{
+        language: string;
+        country?: string;
+        url: string;
+    }> | null;
+    translations?: ProductMetadataTranslationInput[];
+}
+export type ProductMetadataCoverageFilter = 'ALL' | 'MISSING_TITLE' | 'MISSING_DESCRIPTION';
+export interface ProductMetadataCoverageQuery extends ListOptions {
+    /** The language whose meta each row shows, and which the filter judges. */
+    languageCode: LanguageCode;
+    /** Defaults to `ALL`. A value is missing when it is null or empty. */
+    filter?: ProductMetadataCoverageFilter;
+    /** Matches the product's name. */
+    term?: string;
+}
+/** One product of the coverage list. */
+export interface ProductMetadataCoverageRow {
+    productId: string;
+    /** The product's name in the request's language. */
+    name: string;
+    slug: string;
+    enabled: boolean;
+    /** The product's own meta title in the query's language; null when it has none. */
+    seoTitle: string | null;
+    /** The product's own meta description in the query's language; null when it has none. */
+    seoDescription: string | null;
+}
+export interface ProductMetadataBulkEdit {
+    productId: string;
+    input: ProductMetadataInput;
+}
+/** One product's outcome in a `bulkUpsert` call. */
+export interface ProductMetadataBulkOutcome {
+    productId: string;
+    /** `OK`, or `FAILED` (a string on the wire: read anything else as not done). */
+    status: 'OK' | 'FAILED' | (string & {});
+    /**
+     * When FAILED: the single door's own code (`ENTITY_NOT_FOUND`,
+     * `PRODUCT_METADATA_INPUT_INVALID`, …); `INTERNAL_SERVER_ERROR` for a fault the engine logged.
+     */
+    code: string | null;
+    /** When FAILED: the door's sentence. */
+    message: string | null;
+}
+export interface ProductMetadataModule {
+    /**
+     * The product's metadata; null when it has none yet. `NotFoundError` (`PRODUCT_NOT_FOUND`) for
+     * a product the store does not hold.
+     *
+     * @effect read
+     */
+    get(productId: string, options?: Call): Promise<ProductMetadata | null>;
+    /**
+     * Creates the product's metadata or changes the fields named, and answers the whole record.
+     *
+     * @effect write
+     */
+    upsert(productId: string, input: ProductMetadataInput, options?: Call): Promise<ProductMetadata>;
+    /**
+     * Removes the product's metadata in this store: the storefront falls back to the product's own
+     * name and description. Resolves the same way whether or not there was any.
+     *
+     * @effect destructive
+     */
+    delete(productId: string, options?: Call): Promise<void>;
+    /**
+     * The store's products, name first, each with its own meta in `languageCode`; with a `filter`,
+     * only those missing a title (or a description) there. Filtered before paging: pages are full
+     * and `totalItems` counts the filter and the term. Never answers a deleted product.
+     *
+     * @effect read
+     */
+    coverage(query: ProductMetadataCoverageQuery): Promise<Page<ProductMetadataCoverageRow>>;
+    /**
+     * Upserts 1 to {@link MAX_BULK_METADATA_EDITS} products, each through `upsert`'s rules in a
+     * transaction of its own, and answers one outcome per product in the order named: a refused
+     * product changes nothing and the others still go through. Not keyed: a repeat writes again.
+     *
+     * @effect write
+     */
+    bulkUpsert(edits: readonly ProductMetadataBulkEdit[], options?: Call): Promise<ProductMetadataBulkOutcome[]>;
+}
+export declare const PRODUCT_METADATA_QUERY = "\n  query CatalogProductMetadata($productId: ID!) {\n    product(id: $productId) {\n      id\n      metadata { \n  id\n  productId\n  channelId\n  metaRobotsIndex\n  metaRobotsFollow\n  metaRobotsNoarchive\n  metaRobotsNosnippet\n  metaRobotsNoimageindex\n  metaRobotsMaxImagePreview\n  metaRobotsMaxSnippet\n  metaRobotsMaxVideoPreview\n  metaRobotsUnavailableAfter\n  socialImageId\n  socialImage { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n }\n  twitterImageOverrideId\n  twitterImageOverride { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n }\n  twitterCardType\n  socialOgType\n  seoIncludeReviewsInJsonld\n  aiSummaryAudience\n  aiBotOverrides\n  qaEmitFaqpageJsonld\n  hreflangOverrides\n  resolvedBotDirectives\n  translations {\n    id\n    languageCode\n    seoTitle\n    seoDescription\n    canonicalUrl\n    breadcrumbOverride\n    focusKeywords\n    socialTitle\n    socialDescription\n    socialImageAlt\n    twitterTitleOverride\n    twitterDescriptionOverride\n    aiSummary\n    qaPairs\n  }\n }\n    }\n  }\n";
+export declare const UPSERT_PRODUCT_METADATA_MUTATION = "\n  mutation CatalogUpsertProductMetadata($productId: ID!, $input: ProductMetadataInput!) {\n    upsertProductMetadata(productId: $productId, input: $input) { \n  id\n  productId\n  channelId\n  metaRobotsIndex\n  metaRobotsFollow\n  metaRobotsNoarchive\n  metaRobotsNosnippet\n  metaRobotsNoimageindex\n  metaRobotsMaxImagePreview\n  metaRobotsMaxSnippet\n  metaRobotsMaxVideoPreview\n  metaRobotsUnavailableAfter\n  socialImageId\n  socialImage { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n }\n  twitterImageOverrideId\n  twitterImageOverride { \n  id\n  name\n  preview\n  source\n  type\n  mimeType\n }\n  twitterCardType\n  socialOgType\n  seoIncludeReviewsInJsonld\n  aiSummaryAudience\n  aiBotOverrides\n  qaEmitFaqpageJsonld\n  hreflangOverrides\n  resolvedBotDirectives\n  translations {\n    id\n    languageCode\n    seoTitle\n    seoDescription\n    canonicalUrl\n    breadcrumbOverride\n    focusKeywords\n    socialTitle\n    socialDescription\n    socialImageAlt\n    twitterTitleOverride\n    twitterDescriptionOverride\n    aiSummary\n    qaPairs\n  }\n }\n  }\n";
+export declare const DELETE_PRODUCT_METADATA_MUTATION = "\n  mutation CatalogDeleteProductMetadata($productId: ID!) {\n    deleteProductMetadata(productId: $productId) { \n  result\n  message\n }\n  }\n";
+export declare const PRODUCT_METADATA_COVERAGE_QUERY = "\n  query CatalogProductMetadataCoverage(\n    $languageCode: LanguageCode!\n    $filter: ProductMetadataCoverageFilter\n    $term: String\n    $options: ProductMetadataCoverageListOptions\n  ) {\n    productMetadataCoverage(\n      languageCode: $languageCode\n      filter: $filter\n      term: $term\n      options: $options\n    ) {\n      items {\n        productId\n        name\n        slug\n        enabled\n        seoTitle\n        seoDescription\n      }\n      totalItems\n    }\n  }\n";
+export declare const BULK_UPSERT_PRODUCT_METADATA_MUTATION = "\n  mutation CatalogBulkUpsertProductMetadata($edits: [ProductMetadataBulkEdit!]!) {\n    bulkUpsertProductMetadata(edits: $edits) {\n      items {\n        productId\n        status\n        code\n        message\n      }\n    }\n  }\n";
+export declare function createProductMetadataModule(transport: Transport): ProductMetadataModule;

package/dist/catalog/metadata.js

@@ -0,0 +1,220 @@
+/**
+ * A product's SEO, social and AI-agent metadata (headless spec §9.2 `catalog`: "metadata";
+ * W10-10): what the storefront puts in a product page's `<head>`, its share cards and its
+ * structured data. One record per product and store; its texts are per language.
+ *
+ * - **Partial writes.** `upsert` changes only the fields it names. A translation is written per
+ *   language: a language not sent keeps its values, and a field not sent in a sent language keeps
+ *   its value (send `null` to clear one).
+ * - **Coverage.** `coverage` lists the store's products with their own meta title and description
+ *   in one language, optionally only those missing one, filtered by the engine BEFORE the page is
+ *   cut: every page is full and `totalItems` counts the filter.
+ * - **Bulk.** `bulkUpsert` writes many products, each through `upsert`'s rules in a transaction
+ *   of its own and reported on its own (ruling G117).
+ *
+ * Every record is the store's own: a product of another store is never answered and never
+ * written.
+ *
+ * Permissions: `get` and `coverage` need `ReadCatalog`, the writes `UpdateCatalog`.
+ *
+ * Refusals, GraphQL errors mapped by `core`:
+ * - `PRODUCT_METADATA_INPUT_INVALID` → `ValidationError` (400): an input that breaks a rule (a
+ *   length, an allowed value, an `https://` URL, an instant without an offset, a language sent
+ *   twice). `details` names each failure (`field` an RFC 6901 pointer such as
+ *   `/input/translations/0/seoTitle`, `code` the rule such as `INVALID_FIELD_LENGTH`). Nothing is
+ *   written.
+ * - `ENTITY_NOT_FOUND` → `NotFoundError` (404): `upsert` of a product the store does not hold.
+ * - `TRANSLATION_LANGUAGE_NOT_OFFERED` → `ValidationError` (400): a new translation in a language
+ *   the store does not offer.
+ * - `BULK_ACTION_INPUT_INVALID` → `ValidationError` (400): a `bulkUpsert` of no product, more than
+ *   {@link MAX_BULK_METADATA_EDITS} or one product twice, refused before anything is sent.
+ * - `INVALID_DATETIME` → `ValidationError` (400): `metaRobotsUnavailableAfter` without an offset,
+ *   refused before anything is sent.
+ * - `FORBIDDEN` → `PermissionDeniedError` (403) without the permission.
+ *
+ * Release: `coverage` and `bulkUpsert` need a platform release with `productMetadataCoverage` and
+ * `bulkUpsertProductMetadata` (deploy vendure-server first: an older one refuses the document as
+ * `GRAPHQL_VALIDATION_FAILED`); on such a release `upsert` also answers a validation failure as an
+ * uncoded `INTERNAL_SERVER_ERROR` and writes a row for a product the store does not hold. `get`
+ * and `delete` are served by every release this SDK supports. No method deduplicates on
+ * `idempotencyKey`; every write is naturally repeatable.
+ */
+import { NotFoundError, UpstreamError, ValidationError, } from '@sixtyninecommerce/core';
+import { assertDeleted, assertInstant, DELETION_FIELDS, fieldOf, vendureListPage, } from './types.js';
+/** How many products one `bulkUpsert` call may name. */
+export const MAX_BULK_METADATA_EDITS = 200;
+const IMAGE_FIELDS = /* GraphQL */ `
+  id
+  name
+  preview
+  source
+  type
+  mimeType
+`;
+const METADATA_FIELDS = /* GraphQL */ `
+  id
+  productId
+  channelId
+  metaRobotsIndex
+  metaRobotsFollow
+  metaRobotsNoarchive
+  metaRobotsNosnippet
+  metaRobotsNoimageindex
+  metaRobotsMaxImagePreview
+  metaRobotsMaxSnippet
+  metaRobotsMaxVideoPreview
+  metaRobotsUnavailableAfter
+  socialImageId
+  socialImage { ${IMAGE_FIELDS} }
+  twitterImageOverrideId
+  twitterImageOverride { ${IMAGE_FIELDS} }
+  twitterCardType
+  socialOgType
+  seoIncludeReviewsInJsonld
+  aiSummaryAudience
+  aiBotOverrides
+  qaEmitFaqpageJsonld
+  hreflangOverrides
+  resolvedBotDirectives
+  translations {
+    id
+    languageCode
+    seoTitle
+    seoDescription
+    canonicalUrl
+    breadcrumbOverride
+    focusKeywords
+    socialTitle
+    socialDescription
+    socialImageAlt
+    twitterTitleOverride
+    twitterDescriptionOverride
+    aiSummary
+    qaPairs
+  }
+`;
+export const PRODUCT_METADATA_QUERY = /* GraphQL */ `
+  query CatalogProductMetadata($productId: ID!) {
+    product(id: $productId) {
+      id
+      metadata { ${METADATA_FIELDS} }
+    }
+  }
+`;
+export const UPSERT_PRODUCT_METADATA_MUTATION = /* GraphQL */ `
+  mutation CatalogUpsertProductMetadata($productId: ID!, $input: ProductMetadataInput!) {
+    upsertProductMetadata(productId: $productId, input: $input) { ${METADATA_FIELDS} }
+  }
+`;
+export const DELETE_PRODUCT_METADATA_MUTATION = /* GraphQL */ `
+  mutation CatalogDeleteProductMetadata($productId: ID!) {
+    deleteProductMetadata(productId: $productId) { ${DELETION_FIELDS} }
+  }
+`;
+export const PRODUCT_METADATA_COVERAGE_QUERY = /* GraphQL */ `
+  query CatalogProductMetadataCoverage(
+    $languageCode: LanguageCode!
+    $filter: ProductMetadataCoverageFilter
+    $term: String
+    $options: ProductMetadataCoverageListOptions
+  ) {
+    productMetadataCoverage(
+      languageCode: $languageCode
+      filter: $filter
+      term: $term
+      options: $options
+    ) {
+      items {
+        productId
+        name
+        slug
+        enabled
+        seoTitle
+        seoDescription
+      }
+      totalItems
+    }
+  }
+`;
+export const BULK_UPSERT_PRODUCT_METADATA_MUTATION = /* GraphQL */ `
+  mutation CatalogBulkUpsertProductMetadata($edits: [ProductMetadataBulkEdit!]!) {
+    bulkUpsertProductMetadata(edits: $edits) {
+      items {
+        productId
+        status
+        code
+        message
+      }
+    }
+  }
+`;
+function bulkInvalid(message) {
+    return new ValidationError({
+        code: 'BULK_ACTION_INPUT_INVALID',
+        message,
+        status: 400,
+        service: 'vendure',
+    });
+}
+/** The edits as sent, refused before the request leaves when the engine would refuse them. */
+function bulkEdits(edits) {
+    if (!Array.isArray(edits))
+        throw bulkInvalid('edits must be a list.');
+    if (edits.length === 0)
+        throw bulkInvalid('Name at least one product.');
+    if (edits.length > MAX_BULK_METADATA_EDITS) {
+        throw bulkInvalid(`A bulk upsert takes at most ${String(MAX_BULK_METADATA_EDITS)} products; this one names ${String(edits.length)}.`);
+    }
+    const ids = edits.map((edit) => String(edit.productId).toLowerCase());
+    if (new Set(ids).size !== ids.length)
+        throw bulkInvalid('Name each product once.');
+    for (const edit of edits) {
+        assertInstant('metaRobotsUnavailableAfter', edit.input.metaRobotsUnavailableAfter);
+    }
+    return edits.map((edit) => ({ productId: edit.productId, input: edit.input }));
+}
+export function createProductMetadataModule(transport) {
+    return {
+        async get(productId, options) {
+            const product = await fieldOf(transport, PRODUCT_METADATA_QUERY, 'product', { productId }, options);
+            if (!product) {
+                throw new NotFoundError({
+                    code: 'PRODUCT_NOT_FOUND',
+                    message: `This store has no product ${productId}.`,
+                    status: 404,
+                    service: 'vendure',
+                });
+            }
+            return product.metadata;
+        },
+        async upsert(productId, input, options) {
+            assertInstant('metaRobotsUnavailableAfter', input.metaRobotsUnavailableAfter);
+            return fieldOf(transport, UPSERT_PRODUCT_METADATA_MUTATION, 'upsertProductMetadata', { productId, input }, options);
+        },
+        async delete(productId, options) {
+            const response = await fieldOf(transport, DELETE_PRODUCT_METADATA_MUTATION, 'deleteProductMetadata', { productId }, options);
+            assertDeleted('PRODUCT_METADATA_NOT_DELETED', [response]);
+        },
+        async coverage(query) {
+            const { languageCode, filter, term, ...options } = query;
+            return vendureListPage(transport, PRODUCT_METADATA_COVERAGE_QUERY, 'productMetadataCoverage', (skip, take) => ({
+                languageCode,
+                filter: filter ?? 'ALL',
+                ...(term === undefined || term.trim() === '' ? {} : { term }),
+                options: { skip, take },
+            }), options);
+        },
+        async bulkUpsert(edits, options) {
+            const data = await fieldOf(transport, BULK_UPSERT_PRODUCT_METADATA_MUTATION, 'bulkUpsertProductMetadata', { edits: bulkEdits(edits) }, options);
+            if (data === null) {
+                throw new UpstreamError({
+                    code: 'UNEXPECTED_RESPONSE',
+                    message: 'The engine answered bulkUpsertProductMetadata with nothing.',
+                    status: 502,
+                    service: 'vendure',
+                });
+            }
+            return data.items;
+        },
+    };
+}