@instruments/materialgraph 3.4.0 → 3.6.0

package/client.d.ts

@@ -16,6 +16,7 @@ import type { ListEnumValuesOptions, ListEnumValuesResult } from "./list-enum-va
 import type { ListSampledTogetherPairsInput, ListSampledTogetherPairsOutput } from "./list-sampled-together-pairs-types.js";
 import type { ListVariantFacetsInput, ListVariantFacetsOutput } from "./list-variant-facets-types.js";
 import type { ListVariantsInput, ListVariantsOutput } from "./list-variants-types.js";
+import type { MatchPhotoEvent, MatchPhotoInput } from "./match-photo-types.js";
 import type { ListVariantAssetsOptions, MaterialDocumentPageOptions, VariantAssetPage } from "./material-asset-types.js";
 import type { ResolveVariantInput, ResolveVariantOutput } from "./resolve-variant-types.js";
 import type { SchemaResource, SchemaResourceResponse } from "./schema-resource-types.js";
@@ -261,6 +262,21 @@ export declare class MaterialGraphClient {
      * its vector kept, so a repeat image-only query on it spends nothing.
      */
     findVariantsByVector(input: FindVariantsByVectorInput, signal?: AbortSignal): Promise<FindVariantsByVectorOutput>;
+    /**
+     * THE QUESTION: "what are the surfaces in this room, and what matches each?"
+     * (POST `/api/v1/match`). Reads the photo's surfaces and streams, for each,
+     * its `finish` (label, product-type reading, palette and boxes), its crop
+     * `colors`, a provisional color list and the final color-and-look list of up
+     * to 24 variants, then `done`. Send the photo's bytes or one image reference
+     * as {@link MaterialGraphClient.findVariantsByVector} takes. Spends the key's
+     * `embed` limit: one for the photo and one per surface. About 10 to 15 s.
+     *
+     * @example
+     * for await (const event of mg.matchPhoto({ image: file })) {
+     *   if (event.type === "matches" && event.final) show(event.finishId, event.matches);
+     * }
+     */
+    matchPhoto(input: MatchPhotoInput, signal?: AbortSignal): AsyncGenerator<MatchPhotoEvent>;
     /** Resolve a color name to its hex, and the named paint's catalog variant. */
     resolveColor(name: string, signal?: AbortSignal, options?: ResolveColorOptions): Promise<ResolveColorResponse>;
     /**

package/client.js

@@ -6,6 +6,7 @@ import { listAttributes as listAttributesCall, listBaselines as listBaselinesCal
 import { ColorsClient } from "./colors-client.js";
 import { MaterialGraphError } from "./errors.js";
 import { HttpTransport } from "./http-transport.js";
+import { matchPhoto } from "./match-photo.js";
 import { listVariantAssets as listVariantAssetsCall, materialBlocks as materialBlocksCall, materialDocuments as materialDocumentsCall, } from "./material-resources-client.js";
 // Aliased to `operation` — the local name every call site here already used.
 import { resolveOperation as operation } from "./operations.js";
@@ -406,6 +407,23 @@ export class MaterialGraphClient {
     async findVariantsByVector(input, signal) {
         return await this.#post("find_variants_by_vector", input, signal);
     }
+    /**
+     * THE QUESTION: "what are the surfaces in this room, and what matches each?"
+     * (POST `/api/v1/match`). Reads the photo's surfaces and streams, for each,
+     * its `finish` (label, product-type reading, palette and boxes), its crop
+     * `colors`, a provisional color list and the final color-and-look list of up
+     * to 24 variants, then `done`. Send the photo's bytes or one image reference
+     * as {@link MaterialGraphClient.findVariantsByVector} takes. Spends the key's
+     * `embed` limit: one for the photo and one per surface. About 10 to 15 s.
+     *
+     * @example
+     * for await (const event of mg.matchPhoto({ image: file })) {
+     *   if (event.type === "matches" && event.final) show(event.finishId, event.matches);
+     * }
+     */
+    matchPhoto(input, signal) {
+        return matchPhoto(this.#transport, input, signal);
+    }
     /** Resolve a color name to its hex, and the named paint's catalog variant. */
     async resolveColor(name, signal, options) {
         return await resolveColorCall(this.#transport, name, signal, options);

package/http-transport.d.ts

@@ -22,8 +22,8 @@ interface SendInput {
     method: string;
     url: string;
     headers: Record<string, string>;
-    /** The only bodies the SDK sends: a JSON string or a multipart `FormData`. */
-    body?: string | FormData;
+    /** The bodies the SDK sends: a JSON string, a multipart `FormData`, or an image `Blob`. */
+    body?: string | FormData | Blob;
     signal?: AbortSignal;
 }
 export interface HttpTransportOptions {
@@ -50,9 +50,15 @@ export declare class HttpTransport {
      * Send one request, capture rate limits, read the body, and map a non-2xx or
      * transport failure to a {@link MaterialGraphError}. The parsed JSON body (or
      * raw text when unparseable) is returned on success. Not for streaming reads —
-     * it consumes the whole body via `response.text()`.
+     * it consumes the whole body via `response.text()`; see {@link stream}.
      */
     send(input: SendInput): Promise<SentResponse>;
+    /**
+     * Send one request whose 2xx body is read as it arrives. A non-2xx or
+     * transport failure is the same {@link MaterialGraphError} {@link send}
+     * throws; a 2xx response is returned with its body unread.
+     */
+    stream(input: SendInput): Promise<Response>;
     /** Execute a registered JSON operation and return its typed body. */
     requestJson<K extends JsonOperationId>(sdkOperation: SdkOperation<K>, options?: RequestOptions): Promise<OperationResponses[K]>;
 }

package/http-transport.js

@@ -9,6 +9,18 @@ import { MaterialGraphError } from "./errors.js";
 import { parseJson } from "./json.js";
 import { operationPath } from "./operations.js";
 import { parseOperationResponse } from "./parse-operation-response.js";
+/** The body as JSON, its raw text when unparseable, or undefined when empty. */
+const parseBody = (text) => {
+    if (text.length === 0) {
+        return undefined;
+    }
+    try {
+        return parseJson(text);
+    }
+    catch {
+        return text;
+    }
+};
 const parseNumberOrNull = (value) => {
     if (value === null || value.trim() === "") {
         return null;
@@ -83,13 +95,8 @@ export class HttpTransport {
         }
         return url.toString();
     }
-    /**
-     * Send one request, capture rate limits, read the body, and map a non-2xx or
-     * transport failure to a {@link MaterialGraphError}. The parsed JSON body (or
-     * raw text when unparseable) is returned on success. Not for streaming reads —
-     * it consumes the whole body via `response.text()`.
-     */
-    async send(input) {
+    /** Fetch, capture rate limits, and map a transport failure; the body is unread. */
+    async #open(input) {
         const requestUrl = new URL(input.url);
         const metadata = {
             method: input.method,
@@ -116,39 +123,58 @@ export class HttpTransport {
         }
         const rateLimit = parseRateLimit(response.headers);
         this.#lastRateLimit = rateLimit;
-        let text;
-        try {
-            text = await response.text();
-        }
-        catch (error) {
-            throw MaterialGraphError.fromTransport({
-                ...metadata,
-                callerSignal: signal,
-                cause: error,
-            });
-        }
-        let parsed;
-        if (text.length > 0) {
+        const readText = async () => {
             try {
-                parsed = parseJson(text);
+                return await response.text();
             }
-            catch {
-                parsed = text;
+            catch (error) {
+                throw MaterialGraphError.fromTransport({
+                    ...metadata,
+                    callerSignal: signal,
+                    cause: error,
+                });
             }
-        }
+        };
+        /** The {@link MaterialGraphError} for a non-2xx response. */
+        const failure = (text, parsed) => MaterialGraphError.fromResponse({
+            ...metadata,
+            apiKey: this.apiKey,
+            body: parsed,
+            queryValues: [...requestUrl.searchParams.values()],
+            rateLimit,
+            responseText: text,
+            status: response.status,
+        });
+        return { failure, readText, response };
+    }
+    /**
+     * Send one request, capture rate limits, read the body, and map a non-2xx or
+     * transport failure to a {@link MaterialGraphError}. The parsed JSON body (or
+     * raw text when unparseable) is returned on success. Not for streaming reads —
+     * it consumes the whole body via `response.text()`; see {@link stream}.
+     */
+    async send(input) {
+        const { failure, readText, response } = await this.#open(input);
+        const text = await readText();
+        const parsed = parseBody(text);
         if (!response.ok) {
-            throw MaterialGraphError.fromResponse({
-                ...metadata,
-                apiKey: this.apiKey,
-                body: parsed,
-                queryValues: [...requestUrl.searchParams.values()],
-                rateLimit,
-                responseText: text,
-                status: response.status,
-            });
+            throw failure(text, parsed);
         }
         return { parsed, response, text };
     }
+    /**
+     * Send one request whose 2xx body is read as it arrives. A non-2xx or
+     * transport failure is the same {@link MaterialGraphError} {@link send}
+     * throws; a 2xx response is returned with its body unread.
+     */
+    async stream(input) {
+        const { failure, readText, response } = await this.#open(input);
+        if (response.ok) {
+            return response;
+        }
+        const text = await readText();
+        throw failure(text, parseBody(text));
+    }
     /** Execute a registered JSON operation and return its typed body. */
     async requestJson(sdkOperation, options = {}) {
         const url = this.buildUrl(operationPath(sdkOperation, options.pathParams), options.query);

package/index.d.ts

@@ -1,7 +1,7 @@
 export type { DiscoveryReference, DiscoveryTerms, InterpretDiscoveryTermsInput, ColorlessVariantsResult, VariantSibling, } from "./discovery-context-types.js";
 export { MaterialGraphClient, DEFAULT_BASE_URL } from "./client.js";
 export type { MaterialGraphClientOptions } from "./client.js";
-export type { FilterOp, FilterTermCondition, FilterNumericCondition, FilterPresenceCondition, FilterAnyFieldCondition, FilterCondition, FilterGroups, OptionalFilterGroups, OrderByEntry, ListVariantsInclude, ListVariantsCollapse, ColorRegion, ColorRangeCondition, ListVariantsInput, ListVariantsPreference, ListVariantsSpecifications, ListVariantsNotApplicable, SampleSizeObservation, VariantObservations, SampleSubject, ListVariantsItem, ListVariantsOutput, VariantCard, } from "./list-variants-types.js";
+export type { FilterOp, FilterTermCondition, FilterNumericCondition, FilterPresenceCondition, FilterAnyFieldCondition, FilterCondition, FilterGroups, OptionalFilterGroups, OrderByEntry, ListVariantsInclude, ListVariantsCollapse, ColorRegion, ColorRangeCondition, ListVariantsInput, ListVariantsPreference, ListVariantsSpecifications, ListVariantsNotApplicable, SampleSizeObservation, VariantObservations, SampleSubject, ListVariantsItem, Market, ListVariantsOutput, VariantCard, } from "./list-variants-types.js";
 export type { ListVariantFacetsInput, VariantFacetValue, CategoricalVariantFacet, BooleanVariantFacet, NumericVariantFacet, VariantFacet, ListVariantFacetsOutput, } from "./list-variant-facets-types.js";
 export type { SearchVariantsSelection, SearchVariantsInput, SearchVariantsUnderstood, SearchVariantsReading, SearchVariantsSuggestion, SearchVariantsChoice, SearchVariantsOutput, } from "./search-variants-types.js";
 export type { Baseline, BaselineResult, BaselineSource, BaselineStrength, BaselineWayToMeet, CheckBaselinesInput, CheckBaselinesResult, ListBaselinesOptions, ListBaselinesResult, } from "./baseline-types.js";
@@ -13,6 +13,7 @@ export type { GetVariantDemandInput, GetVariantDemandOutput, DemandTrend, Varian
 export type { ListSampledTogetherPairsInput, ListSampledTogetherPairsOutput, SampledTogetherPair, } from "./list-sampled-together-pairs-types.js";
 export type { FindVariantsByColorMode, ColorConditionInput, FindVariantsByColorInput, ColorConditionReceipt, PaintCatalogVariant, ResolvedColor, ColorAlternative, UnresolvedColor, ColorVariantMatch, ColorPageInfo, FindVariantsByColorContainsResult, FindVariantsByColorPaletteResult, ColorRankedSeed, ColorRankMatch, ResolvedColorReference, CompareColorSimilarityReference, FindVariantsByColorRerankResult, FindVariantsByColorOutput, } from "./find-variants-by-color-types.js";
 export { FIND_VARIANTS_BY_VECTOR_MODES } from "./find-variants-by-vector-types.js";
+export type { MatchPhotoEvent, MatchPhotoInput, MatchPhotoMatch, MatchPhotoRegion, MatchPhotoSurface, } from "./match-photo-types.js";
 export type { FindVariantsByVectorMode, FindVariantsByVectorQuery, FindVariantsByVectorInput, FindVariantsByVectorItem, FindVariantsByVectorReference, FindVariantsByVectorScan, FindVariantsByVectorTimings, FindVariantsByVectorOutput, } from "./find-variants-by-vector-types.js";
 export { MATERIALGRAPH_API_VERSION, SDK_OPERATIONS } from "./operations.js";
 export type { SdkOperation, SdkOperationId } from "./operations.js";

package/list-variants-types.d.ts

@@ -93,7 +93,7 @@ export interface OptionalFilterGroups {
 }
 export interface OrderByEntry {
     direction: "asc" | "desc";
-    /** A numeric attribute id. */
+    /** A single-valued numeric attribute id (`getAttribute` says orderable), or `color_lightness` or `color_chroma`: the lightness and chroma of the variant's dominant measured color. */
     field: string;
 }
 export type ListVariantsInclude = "image" | "url";
@@ -196,6 +196,8 @@ export interface ListVariantsNotApplicable {
 }
 /** What a sample represents, independently of its specification type. */
 export type SampleSubject = "material" | "paint_color_sample" | "unknown" | "conflict";
+/** A Material Bank market: North America or Europe. */
+export type Market = "na" | "eu";
 /**
  * One list item: the compact identity needed to pick a variant, with image
  * and brand page only when requested (`include`) and selected attributes
@@ -234,6 +236,8 @@ export interface ListVariantsItem {
     };
     /** The variant's Material Bank SKU. Absent means none is recorded. */
     materialBankId?: string;
+    /** The Material Bank markets it is orderable in: `na`, `eu`, both or neither. The `market` filter field takes them. */
+    markets: Market[];
     name: string;
     /** The trimmed source variant label; null when unknown or for a paint color sample, whose own name identifies its color. Separate from surface finish, color family and derived color names. */
     variantLabel: string | null;

package/match-photo-types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @module match-photo-types
+ * @description `match_photo` (POST `/api/v1/match`): the stream of a room
+ * photo's surfaces and their matches, one {@link MatchPhotoEvent} a line.
+ */
+import type { ImageReferenceInput } from "./image-reference-types.js";
+/** The photo: its bytes, or one image reference as `findVariantsByVector` takes. */
+export type MatchPhotoInput = {
+    /** The photo's bytes, at most 8 MB (4.5 MB is the platform's body limit). */
+    readonly image: Blob | Uint8Array | ArrayBuffer;
+    /** The image's media type, such as `image/jpeg`; a `Blob`'s own type when omitted. */
+    readonly contentType?: string;
+} | {
+    readonly reference: ImageReferenceInput;
+};
+/** A box in the photo, as fractions of its width and height (0 to 1). */
+export interface MatchPhotoRegion {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/** One surface seen in the photo: its material and color reading, and where it sits. */
+export interface MatchPhotoSurface {
+    readonly id: string;
+    /** The surface, in the model's words: "Back wall". */
+    readonly label: string;
+    readonly description: string;
+    /** Product types, most likely first. */
+    readonly categories: readonly {
+        readonly id: string;
+        readonly name: string;
+    }[];
+    readonly palette: readonly {
+        readonly hex: string;
+        readonly weight: number;
+    }[];
+    /** Where it sits; the first is the largest. */
+    readonly regions: readonly MatchPhotoRegion[];
+}
+/** One variant offered for a surface. */
+export interface MatchPhotoMatch {
+    readonly variantId: string;
+    readonly productName: string;
+    readonly variantName: string | null;
+    readonly brandName: string;
+    readonly imageUrl: string | null;
+    /** The combined match, 0 to 100: color and look, or color alone when `basis` is `"color"`. */
+    readonly percent: number;
+    /** The variant's own category when it is a look-alike from another; null when it is the surface's own. */
+    readonly lookalikeType: string | null;
+    /** Other colorways of the same product that also matched, not listed. */
+    readonly otherColorways: number;
+}
+export type MatchPhotoEvent = {
+    readonly type: "query-interpretation";
+} | {
+    readonly type: "finish";
+    readonly finish: MatchPhotoSurface;
+} | {
+    readonly type: "colors";
+    readonly finishId: string;
+    readonly cropColors: readonly {
+        readonly hex: string;
+        readonly share: number;
+    }[];
+}
+/** A later `matches` replaces the list; `final: true` completes it. */
+ | {
+    readonly type: "matches";
+    readonly finishId: string;
+    readonly basis: "color" | "color-and-look";
+    readonly final: boolean;
+    readonly matches: readonly MatchPhotoMatch[];
+}
+/** This surface could not be matched; the others carry on. */
+ | {
+    readonly type: "failed";
+    readonly finishId: string;
+    readonly message: string;
+}
+/** The run failed: nothing more arrives. */
+ | {
+    readonly type: "error";
+    readonly message: string;
+} | {
+    readonly type: "done";
+};

package/match-photo-types.js

@@ -0,0 +1 @@
+export {};

package/match-photo.d.ts

@@ -0,0 +1,9 @@
+import type { HttpTransport } from "./http-transport.js";
+import type { MatchPhotoEvent, MatchPhotoInput } from "./match-photo-types.js";
+/**
+ * The room photo's events, in the order the server sends them, ending with
+ * `done` or `error`. Breaking out of the loop cancels the request.
+ *
+ * @yields {MatchPhotoEvent} One event a line.
+ */
+export declare const matchPhoto: (transport: HttpTransport, input: MatchPhotoInput, signal?: AbortSignal) => AsyncGenerator<MatchPhotoEvent>;

package/match-photo.js

@@ -0,0 +1,90 @@
+/**
+ * `match_photo` over the shared {@link HttpTransport}: the photo goes up as
+ * raw bytes or a JSON reference, and the NDJSON stream comes back one event at
+ * a time. `MaterialGraphClient.matchPhoto` is a thin wrapper over it.
+ */
+import { MaterialGraphError } from "./errors.js";
+import { parseJson } from "./json.js";
+import { operationPath, resolveOperation } from "./operations.js";
+const bodyOf = (input) => {
+    if ("reference" in input) {
+        return {
+            body: JSON.stringify({ image: input.reference }),
+            contentType: "application/json",
+        };
+    }
+    const { image } = input;
+    const blob = image instanceof Blob
+        ? image
+        : new Blob([
+            image instanceof ArrayBuffer ? image : new Uint8Array(image),
+        ]);
+    const contentType = input.contentType ?? blob.type;
+    if (!contentType.startsWith("image/")) {
+        throw MaterialGraphError.unexpected("matchPhoto needs the image's media type, such as image/jpeg: pass contentType.");
+    }
+    return { body: blob, contentType };
+};
+const EVENT_TYPES = new Set([
+    "colors",
+    "done",
+    "error",
+    "failed",
+    "finish",
+    "matches",
+    "query-interpretation",
+]);
+/** A line the server wrote from its MatchEvent contract, told apart by `type`. */
+const isMatchPhotoEvent = (value) => typeof value === "object" &&
+    value !== null &&
+    "type" in value &&
+    typeof value.type === "string" &&
+    EVENT_TYPES.has(value.type);
+/**
+ * Each complete line of a byte stream, as it arrives.
+ *
+ * @yields {string} One line, without its newline.
+ */
+const linesOf = async function* linesOf(body) {
+    const decoder = new TextDecoder();
+    let buffered = "";
+    for await (const chunk of body) {
+        buffered += decoder.decode(chunk, { stream: true });
+        const lines = buffered.split("\n");
+        buffered = lines.pop() ?? "";
+        yield* lines.filter((line) => line !== "");
+    }
+    buffered += decoder.decode();
+    if (buffered !== "") {
+        yield buffered;
+    }
+};
+/**
+ * The room photo's events, in the order the server sends them, ending with
+ * `done` or `error`. Breaking out of the loop cancels the request.
+ *
+ * @yields {MatchPhotoEvent} One event a line.
+ */
+export const matchPhoto = async function* matchPhoto(transport, input, signal) {
+    const { body, contentType } = bodyOf(input);
+    const response = await transport.stream({
+        body,
+        headers: transport.authHeaders({
+            Accept: "application/x-ndjson",
+            "Content-Type": contentType,
+        }),
+        method: "POST",
+        signal,
+        url: transport.buildUrl(operationPath(resolveOperation("match_photo"))),
+    });
+    if (response.body === null) {
+        throw MaterialGraphError.unexpected("match_photo answered with no body.");
+    }
+    for await (const line of linesOf(response.body)) {
+        const event = parseJson(line);
+        if (!isMatchPhotoEvent(event)) {
+            throw MaterialGraphError.unexpected(`match_photo sent a line that is not an event: ${line.slice(0, 200)}`);
+        }
+        yield event;
+    }
+};

package/operations.generated.d.ts

@@ -1,5 +1,5 @@
 export declare const MATERIALGRAPH_API_VERSION = "0.8.0";
-declare const OPERATION_DEFINITIONS: readonly [readonly ["discoveryReference", "GET", "/api/v1/catalog/discovery-reference", "get_discovery_reference"], readonly ["interpretDiscoveryTerms", "POST", "/api/v1/catalog/interpret-terms", "interpret_discovery_terms"], readonly ["colorlessVariants", "POST", "/api/v1/variants/colorless", "find_colorless_variants"], readonly ["variantSiblings", "GET", "/api/v1/variants/{variantId}/siblings", "list_variant_siblings"], readonly ["colors.nearestPaints", "GET", "/api/v1/colors/nearest-paints", "find_nearest_paints"], readonly ["getCatalogGeneration", "GET", "/api/v1/catalog/generation", "get_catalog_generation"], readonly ["materialBlocks", "GET", "/api/v1/materials/{variantId}/blocks", "list_material_blocks"], readonly ["listVariantAssets", "GET", "/api/v1/variants/{variantId}/assets", "list_variant_assets"], readonly ["materialDocuments", "GET", "/api/v1/materials/{variantId}/documents", "list_material_documents"], readonly ["schema", "GET", "/api/v1/schema/value-dictionaries", "list_schema_value_dictionaries"], readonly ["pairings", "GET", "/api/v1/materials/{variantId}/pairings", "get_material_pairings"], readonly ["associatedFinishes", "GET", "/api/v1/associated/finishes", "list_associated_finishes"], readonly ["associatedProducts", "GET", "/api/v1/associated/products", "list_associated_products"], readonly ["applicability", "GET", "/api/v1/applicability", "get_applicability"], readonly ["listVariants", "GET", "/api/v1/variants", "list_variants"], readonly ["listVariantFacets", "POST", "/api/v1/variants/facets", "list_variant_facets"], readonly ["searchVariants", "POST", "/api/v1/variants/search", "search_variants"], readonly ["findVariantsByColor", "GET", "/api/v1/variants/by-color", "find_variants_by_color"], readonly ["findVariantsByVector", "POST", "/api/v1/variants/by-vector", "find_variants_by_vector"], readonly ["findSampledTogether", "GET", "/api/v1/variants/sampled-together", "find_sampled_together"], readonly ["listSampledTogetherPairs", "GET", "/api/v1/variants/sampled-together/pairs", "list_sampled_together_pairs"], readonly ["getVariantDemand", "POST", "/api/v1/demand", "get_variant_demand"], readonly ["listRisingVariants", "GET", "/api/v1/demand/rising", "list_rising_variants"], readonly ["resolveVariant", "POST", "/api/v1/variants/resolve", "resolve_variant"], readonly ["getVariant", "GET", "/api/v1/variants/{variantId}", "get_variant"], readonly ["resolveColor", "GET", "/api/v1/search/colors/resolve", "resolve_color_name"], readonly ["listAttributes", "GET", "/api/v1/catalog/attributes", "catalog_list_attributes"], readonly ["listEnumValues", "GET", "/api/v1/catalog/enum-values", "catalog_list_enum_values"], readonly ["listBaselines", "GET", "/api/v1/baselines", "list_baselines"], readonly ["checkBaselines", "POST", "/api/v1/baselines/check", "check_baselines"], readonly ["categories.list", "GET", "/api/v1/categories", "list_categories"], readonly ["categories.get", "GET", "/api/v1/categories/{id}", "get_category"], readonly ["whoami", "GET", "/api/v1/whoami", "whoami"], readonly ["colors.profiles", "GET", "/api/v1/colors/profiles", "get_category_color_profiles"], readonly ["extractPalette", "POST", "/api/v1/search/palettes/extract", "extract_image_palette"], readonly ["brands", "GET", "/api/v1/brands", "list_brands"], readonly ["uploadSourceMaterial", "POST", "/api/v1/source-material", "upload_source_material"]];
+declare const OPERATION_DEFINITIONS: readonly [readonly ["discoveryReference", "GET", "/api/v1/catalog/discovery-reference", "get_discovery_reference"], readonly ["interpretDiscoveryTerms", "POST", "/api/v1/catalog/interpret-terms", "interpret_discovery_terms"], readonly ["colorlessVariants", "POST", "/api/v1/variants/colorless", "find_colorless_variants"], readonly ["variantSiblings", "GET", "/api/v1/variants/{variantId}/siblings", "list_variant_siblings"], readonly ["colors.nearestPaints", "GET", "/api/v1/colors/nearest-paints", "find_nearest_paints"], readonly ["getCatalogGeneration", "GET", "/api/v1/catalog/generation", "get_catalog_generation"], readonly ["materialBlocks", "GET", "/api/v1/materials/{variantId}/blocks", "list_material_blocks"], readonly ["listVariantAssets", "GET", "/api/v1/variants/{variantId}/assets", "list_variant_assets"], readonly ["materialDocuments", "GET", "/api/v1/materials/{variantId}/documents", "list_material_documents"], readonly ["schema", "GET", "/api/v1/schema/value-dictionaries", "list_schema_value_dictionaries"], readonly ["pairings", "GET", "/api/v1/materials/{variantId}/pairings", "get_material_pairings"], readonly ["associatedFinishes", "GET", "/api/v1/associated/finishes", "list_associated_finishes"], readonly ["associatedProducts", "GET", "/api/v1/associated/products", "list_associated_products"], readonly ["applicability", "GET", "/api/v1/applicability", "get_applicability"], readonly ["listVariants", "GET", "/api/v1/variants", "list_variants"], readonly ["listVariantFacets", "POST", "/api/v1/variants/facets", "list_variant_facets"], readonly ["searchVariants", "POST", "/api/v1/variants/search", "search_variants"], readonly ["findVariantsByColor", "GET", "/api/v1/variants/by-color", "find_variants_by_color"], readonly ["findVariantsByVector", "POST", "/api/v1/variants/by-vector", "find_variants_by_vector"], readonly ["matchPhoto", "POST", "/api/v1/match", "match_photo"], readonly ["findSampledTogether", "GET", "/api/v1/variants/sampled-together", "find_sampled_together"], readonly ["listSampledTogetherPairs", "GET", "/api/v1/variants/sampled-together/pairs", "list_sampled_together_pairs"], readonly ["getVariantDemand", "POST", "/api/v1/demand", "get_variant_demand"], readonly ["listRisingVariants", "GET", "/api/v1/demand/rising", "list_rising_variants"], readonly ["resolveVariant", "POST", "/api/v1/variants/resolve", "resolve_variant"], readonly ["getVariant", "GET", "/api/v1/variants/{variantId}", "get_variant"], readonly ["resolveColor", "GET", "/api/v1/search/colors/resolve", "resolve_color_name"], readonly ["listAttributes", "GET", "/api/v1/catalog/attributes", "catalog_list_attributes"], readonly ["listEnumValues", "GET", "/api/v1/catalog/enum-values", "catalog_list_enum_values"], readonly ["listBaselines", "GET", "/api/v1/baselines", "list_baselines"], readonly ["checkBaselines", "POST", "/api/v1/baselines/check", "check_baselines"], readonly ["categories.list", "GET", "/api/v1/categories", "list_categories"], readonly ["categories.get", "GET", "/api/v1/categories/{id}", "get_category"], readonly ["whoami", "GET", "/api/v1/whoami", "whoami"], readonly ["colors.profiles", "GET", "/api/v1/colors/profiles", "get_category_color_profiles"], readonly ["extractPalette", "POST", "/api/v1/search/palettes/extract", "extract_image_palette"], readonly ["brands", "GET", "/api/v1/brands", "list_brands"], readonly ["uploadSourceMaterial", "POST", "/api/v1/source-material", "upload_source_material"]];
 export type SdkOperationId = (typeof OPERATION_DEFINITIONS)[number][3];
 export type SdkOperation<K extends SdkOperationId = SdkOperationId> = Readonly<{
     clientMethod: (typeof OPERATION_DEFINITIONS)[number][0];

package/operations.generated.js

@@ -100,6 +100,7 @@ const OPERATION_DEFINITIONS = [
         "/api/v1/variants/by-vector",
         "find_variants_by_vector",
     ],
+    ["matchPhoto", "POST", "/api/v1/match", "match_photo"],
     [
         "findSampledTogether",
         "GET",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instruments/materialgraph",
-  "version": "3.4.0",
+  "version": "3.6.0",
   "type": "module",
   "exports": {
     ".": {