@instruments/materialgraph 0.38.0 → 0.40.0

package/associations-client.js

@@ -17,7 +17,10 @@ import { resolveOperation } from "./operations.js";
  *
  * @param variantId The PRODUCT variant. Opaque — pass back exactly what you were given.
  */
-export const declaredFinishes = async (transport, variantId, options, signal) => await transport.requestJson(resolveOperation("list_associated_finishes"), { query: { variantId, ...options }, signal });
+export const declaredFinishes = async (transport, variantId, options, signal) => await transport.requestJson(resolveOperation("list_associated_finishes"), {
+    query: { variantId, ...options },
+    signal,
+});
 /**
  * THE QUESTION: "what furniture takes THIS fabric?" — the products the
  * BRAND declares a finish variant is available on (GET
@@ -32,6 +35,12 @@ export const declaredFinishes = async (transport, variantId, options, signal) =>
  *
  * @param variantId The FINISH variant. Opaque — pass back exactly what you were given.
  */
-export const declaredProducts = async (transport, variantId, options, signal) => await transport.requestJson(resolveOperation("list_associated_products"), { query: { variantId, ...options }, signal });
+export const declaredProducts = async (transport, variantId, options, signal) => await transport.requestJson(resolveOperation("list_associated_products"), {
+    query: { variantId, ...options },
+    signal,
+});
 /** Read brand-declared applicability without collapsing Product/Variant default attribute level. */
-export const applicability = async (transport, options, signal) => await transport.requestJson(resolveOperation("get_applicability"), { query: options, signal });
+export const applicability = async (transport, options, signal) => await transport.requestJson(resolveOperation("get_applicability"), {
+    query: options,
+    signal,
+});

package/by-spec-types.d.ts

@@ -50,7 +50,7 @@ export type BySpecVerdictCell = {
     /** Trust in `value`, 0–1. Null = unrecorded, which is weaker than a low score. */
     confidence: number | null;
     /** Where `value` came from (`tested` > `declared` > `catalog_feed` > `derived`). */
-    valueOrigin: string | null;
+    valueSource: string | null;
     /**
      * Why an `unverified` cell missed the bar; null otherwise.
      *  - `below_confidence` — the value is real but scored under the floor.

package/catalogue-types.d.ts

@@ -1,5 +1,5 @@
 /** A verified product location in a specific immutable brand publication. */
-export interface CatalogueReference {
+export type CatalogueReference = {
     anchor: {
         coordinateSpace: "normalized_0_1000";
         /** Page carrying the printed code; defaults to page.documentPage. Do not draw it on another page. */
@@ -56,7 +56,7 @@ export interface CatalogueReference {
     };
     status: "verified";
     isPrimary: boolean;
-}
+};
 /**
  * Why a known variant has no verified reference. None of these says the
  * product is missing from the printed book; nobody records how many of a
@@ -114,7 +114,7 @@ export type CatalogueReferenceResult = {
     variantId: string;
     status: "upstream_failure";
 };
-export interface CatalogueReferenceBatchResponse {
+export type CatalogueReferenceBatchResponse = {
     results: CatalogueReferenceResult[];
     coverage: {
         requested: number;
@@ -124,25 +124,23 @@ export interface CatalogueReferenceBatchResponse {
         unavailable: number;
         upstreamFailure: number;
     };
-}
+};
 /** Bounds for the flat catalogue-channel collection shelf. */
-export interface CatalogueCollectionsOptions {
+export type CatalogueCollectionsOptions = {
     limit?: number;
     offset?: number;
     sampleLimit?: number;
-}
+};
 /** One representative product image carried by a catalogue collection. */
-export interface CatalogueCollectionSampleProduct {
-    assetId: string;
+export type CatalogueCollectionSampleProduct = {
     imageUrl: string;
-    sourceImageUrl: string;
     productId: string;
     productName: string;
     variantId: string;
     variantName: string | null;
-}
+};
 /** A product collection whose variants have governed catalogue membership. */
-export interface CatalogueChannelCollection {
+export type CatalogueChannelCollection = {
     id: string;
     slug: string;
     name: string;
@@ -150,9 +148,9 @@ export interface CatalogueChannelCollection {
     productCount: number;
     variantCount: number;
     sampleProducts: CatalogueCollectionSampleProduct[];
-}
+};
 /** The flat, paginated catalogue-channel collection read model. */
-export interface CatalogueChannelCollectionsResponse {
+export type CatalogueChannelCollectionsResponse = {
     collections: CatalogueChannelCollection[];
     channel: {
         token: "catalogue";
@@ -168,14 +166,14 @@ export interface CatalogueChannelCollectionsResponse {
         offset: number;
         hasMore: boolean;
     };
-}
-export interface CatalogueDocumentAccess {
+};
+export type CatalogueDocumentAccess = {
     documentId: string;
     contentType: "application/pdf";
     readerUrl: string;
     originalUrl: string;
     byteRanges: "supported" | "unknown";
-}
+};
 export type CatalogueDocumentAccessResult = {
     documentId: string;
     status: "available";
@@ -193,7 +191,7 @@ export type CatalogueDocumentAccessResult = {
     documentId: string;
     status: "upstream_failure";
 };
-export interface CatalogDocument {
+export type CatalogDocument = {
     availability: "available";
     brand: {
         id: string;
@@ -211,13 +209,13 @@ export interface CatalogDocument {
     productStatus: "partial" | "not_processed";
     receipt: CatalogAvailableReceipt;
     title: string;
-}
-export interface CatalogEdition {
+};
+export type CatalogEdition = {
     id: string;
     label: string;
     title: string;
-}
-export interface CatalogAvailableReceipt {
+};
+export type CatalogAvailableReceipt = {
     extraction: {
         references: number;
         status: "partial" | "not_processed";
@@ -240,17 +238,17 @@ export interface CatalogAvailableReceipt {
             algorithm: "sha256";
             value: string;
         };
-        valueOrigin: "brand_supplied";
+        valueSource: "brand_supplied";
         retainedUrl: string;
         status: "retained";
     };
-}
-export interface CatalogFailureReceipt {
+};
+export type CatalogFailureReceipt = {
     count: number;
     reason: string;
     stage: "source" | "render" | "extraction";
-}
-export interface UnavailableCatalogDocument {
+};
+export type UnavailableCatalogDocument = {
     availability: "source_unavailable";
     brand: {
         id: string;
@@ -282,13 +280,13 @@ export interface UnavailableCatalogDocument {
         };
     };
     title: string;
-}
+};
 export type CatalogPublication = CatalogDocument | UnavailableCatalogDocument;
-export interface CatalogDocumentList {
+export type CatalogDocumentList = {
     catalogs: CatalogPublication[];
     source: "verified-source-material-registry";
-}
-export interface CatalogProductReferenceList {
+};
+export type CatalogProductReferenceList = {
     catalog: CatalogDocument;
     coverage: {
         documentPages: {
@@ -313,22 +311,23 @@ export interface CatalogProductReferenceList {
     references: CatalogueReference[];
     source: "verified-source-material-registry";
     status: "available";
-}
-export interface CatalogProductReferenceUnavailable {
+};
+export type CatalogProductReferenceUnavailable = {
     catalog: UnavailableCatalogDocument;
     reason: "retained_source_not_found";
     status: "source_unavailable";
-}
+};
 export type CatalogProductReferenceReadResult = CatalogProductReferenceList | CatalogProductReferenceUnavailable;
-export interface CataloguePageRequiredArtifact {
+export type CataloguePageRequiredArtifact = {
     mediaType: "image/webp";
     version: "catalogue-page-webp-v1";
-}
-export interface CataloguePageAvailableArtifact extends Omit<CataloguePageRequiredArtifact, "version"> {
+};
+export type CataloguePageAvailableArtifact = {
     bucket: "materialgraph";
     key: string;
     url: string;
-}
+    mediaType: CataloguePageRequiredArtifact["mediaType"];
+};
 export type CataloguePage = {
     catalogId: string;
     documentId: string;

package/categories-client.d.ts

@@ -17,10 +17,10 @@
  */
 import type { CategoriesGetResult, CategoriesListInput, CategoriesListResult } from "./category-types.js";
 import type { QueryParams } from "./http-transport.js";
-import type { SdkOperationId } from "./operations.js";
+import type { JsonOperationId, OperationResponses } from "./operation-responses.js";
 /** The client's own request primitive, handed down so this file owns no transport. */
 export type CategoriesTransport = {
-    get<T>(operationId: SdkOperationId, query?: QueryParams, signal?: AbortSignal, pathParams?: Readonly<Record<string, string>>): Promise<T>;
+    get<K extends JsonOperationId>(operationId: K, query?: QueryParams, signal?: AbortSignal, pathParams?: Readonly<Record<string, string>>): Promise<OperationResponses[K]>;
 };
 export declare class CategoriesClient {
     #private;

package/client-response-schema.d.ts

@@ -0,0 +1,3 @@
+import type { JsonSchema } from "./response-schemas.js";
+/** Adapt a fresh producer schema to the SDK's existing open string enums. */
+export declare const openClientResponseEnums: (schema: JsonSchema) => void;

package/client-response-schema.js

@@ -0,0 +1,79 @@
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+// Only the fields declared as OpenEnum in the SDK are open here. Union
+// discriminants stay closed so their associated object shapes remain true.
+const openStrings = new Set([
+    "CategoryColorProfilesResponse.profiles.level",
+    "FindVariantsByColorResponse.searchCatalogueSubset.scope",
+    "GetCategoryResponse.kind",
+    "ListAttributesResponse.items.match.method",
+    "ListCategoriesResponse.items.match.method",
+    "ListEnumValuesResponse.items.match.method",
+    "MaterialBlockProjection.blocks.status",
+    "MaterialBlockProjection.blocks.fields.status",
+    "MaterialTile.availability",
+    "MaterialTile.imageSource",
+    "PairingItem.availability",
+    "PairingItem.imageSource",
+    "PairingItem.demand.momentum.state",
+    "PairingItem.ranking.basis",
+    "PairingOrdering.anchorColorBasis",
+    "PairingOrdering.applied",
+    "PairingOrdering.colorSpace",
+    "PairingOrdering.direction",
+    "PairingOrdering.missingValues",
+    "PairingOrdering.requested",
+    "PairingOrdering.tieBreak",
+    "ProductDocumentPage.coverage.productUnion.state",
+    "ProductDocumentPage.coverage.requestedVariant.state",
+    "ProductDocumentPage.coverage.sources.state",
+    "ProductDocumentPage.documents.declarations.status",
+    "ProductDocumentPage.documents.documentTypes",
+    "ProductDocumentPage.documents.status",
+    "PublicRun.status",
+    "ResolveColorResponse.match.libraryType",
+    "ResolveColorResponse.match.variant.reason",
+    "SchemaValueDictionariesResponse.items.lifecycle.status",
+    "SchemaValueDictionariesResponse.items.terms.lifecycle.status",
+    "SchemaValueDictionariesResponse.items.terms.externalMappings.mappingType",
+    "SchemaValueDictionariesResponse.items.terms.externalMappings.matchStrength",
+    "SchemaValueDictionariesResponse.items.terms.externalMappings.target",
+    "SourceMaterialBatchReceipt.sources.role",
+    "VariantAssetPage.documentCoverage",
+    "VariantAssetPage.items.availability",
+    "VariantAssetPage.items.documentTypes",
+    "VariantAssetPage.items.imageRole",
+    "VariantAssetPage.items.kind",
+    "VariantAssetPage.items.presentation",
+]);
+/** Adapt a fresh producer schema to the SDK's existing open string enums. */
+export const openClientResponseEnums = (schema) => {
+    const visit = (node, path) => {
+        if (!isRecord(node)) {
+            return;
+        }
+        if (node.type === "string" && openStrings.has(path)) {
+            delete node.enum;
+            delete node.const;
+        }
+        if (isRecord(node.$defs)) {
+            for (const [name, definition] of Object.entries(node.$defs)) {
+                visit(definition, name);
+            }
+        }
+        if (isRecord(node.properties)) {
+            for (const [name, property] of Object.entries(node.properties)) {
+                visit(property, `${path}.${name}`);
+            }
+        }
+        visit(node.items, path);
+        for (const keyword of ["anyOf", "allOf", "oneOf", "prefixItems"]) {
+            const children = node[keyword];
+            if (Array.isArray(children)) {
+                for (const child of children) {
+                    visit(child, path);
+                }
+            }
+        }
+    };
+    visit(schema, "");
+};

package/client.d.ts

@@ -19,7 +19,8 @@ import type { SchemaResource, SchemaResourceResponse } from "./schema-resource-t
 import type { SearchVariantsInput, SearchVariantsOutput } from "./search-variants-types.js";
 import type { ExtractPaletteInput, ExtractPaletteResponse, ListAttributesOptions, ListAttributesResult, PairingsOptions, PairingsResponse, ResolveColorOptions, ResolveColorResponse, WhoamiResponse } from "./types.js";
 import { WorkflowsClient } from "./workflows-client.js";
-export * from "./client-config.js";
+export { DEFAULT_BASE_URL } from "./client-config.js";
+export type { MaterialGraphClientOptions } from "./client-config.js";
 /**
  * The MaterialGraph client — every lens on the graph, on one object.
  *
@@ -83,7 +84,7 @@ export declare class MaterialGraphClient extends CatalogueClient {
      * Color is usually derived from product imagery, which is visual likeness,
      * not a color specification. A brand's declared color, such as a paint's
      * published hex, wins where MaterialGraph holds one, and each value's
-     * value origin says which.
+     * Value Source says which.
      */
     readonly colors: ColorsClient;
     /**
@@ -96,6 +97,10 @@ export declare class MaterialGraphClient extends CatalogueClient {
     readonly workflows: WorkflowsClient;
     constructor(options: MaterialGraphClientOptions);
     get lastRateLimit(): RateLimit | null;
+    /** Current catalogue generation; authenticated, no SQL and no rate-limit charge. */
+    getCatalogueGeneration(signal?: AbortSignal): Promise<{
+        generation: number;
+    }>;
     /**
      * THE QUESTION: "tell me about THIS variant" (GET
      * `/api/v1/variants/{variantId}`, `get_variant`).
@@ -191,7 +196,7 @@ export declare class MaterialGraphClient extends CatalogueClient {
     searchVariants(input: SearchVariantsInput, signal?: AbortSignal): Promise<SearchVariantsOutput>;
     /**
      * THE QUESTION: "which variants hold, resemble, or can be ranked by, this
-     * color?" (POST `/api/v1/variants/by-color`, MG-2217/MG-2230/MG-2247).
+     * color?" (GET `/api/v1/variants/by-color`, MG-2217/MG-2230/MG-2247).
      * One required `mode`: `contains` (a swatch for every required `colors[]`
      * condition), `palette` (whole-palette closeness to `colors[]`, an
      * image's extracted palette, or `targetVariantId`'s own palette) or
@@ -199,7 +204,7 @@ export declare class MaterialGraphClient extends CatalogueClient {
      */
     findVariantsByColor(input: FindVariantsByColorInput, signal?: AbortSignal): Promise<FindVariantsByColorOutput>;
     /**
-     * THE QUESTION: "what did designers sample together with these?" (POST
+     * THE QUESTION: "what did designers sample together with these?" (GET
      * `/api/v1/variants/sampled-together`, MG-2332). Give `variantIds` and/or
      * `materials` (free-text names, one variant each, at most twelve together);
      * the materials come back other brands first, then the most projects, each

package/client.js

@@ -1,4 +1,4 @@
-import * as assoc from "./associations-client.js";
+import { applicability, declaredFinishes, declaredProducts, } from "./associations-client.js";
 import { listBrands } from "./brands-client.js";
 import { CatalogueClient } from "./catalogue-client.js";
 import { CategoriesClient } from "./categories-client.js";
@@ -14,7 +14,7 @@ import { uploadSourceMaterial } from "./runs.js";
 import { SCHEMA_RESOURCE_OPERATION_IDS } from "./schema-resource-types.js";
 import { WorkflowsClient } from "./workflows-client.js";
 // Re-exported whole so `index.ts` and every existing importer keep their path.
-export * from "./client-config.js";
+export { DEFAULT_BASE_URL } from "./client-config.js";
 /**
  * The MaterialGraph client — every lens on the graph, on one object.
  *
@@ -77,7 +77,7 @@ export class MaterialGraphClient extends CatalogueClient {
      * Color is usually derived from product imagery, which is visual likeness,
      * not a color specification. A brand's declared color, such as a paint's
      * published hex, wins where MaterialGraph holds one, and each value's
-     * value origin says which.
+     * Value Source says which.
      */
     colors;
     /**
@@ -126,6 +126,10 @@ export class MaterialGraphClient extends CatalogueClient {
             signal,
         });
     }
+    /** Current catalogue generation; authenticated, no SQL and no rate-limit charge. */
+    async getCatalogueGeneration(signal) {
+        return await this.#get("get_catalogue_generation", undefined, signal);
+    }
     // ── Materials ──────────────────────────────────────────────────────────────
     /**
      * THE QUESTION: "tell me about THIS variant" (GET
@@ -146,10 +150,12 @@ export class MaterialGraphClient extends CatalogueClient {
      */
     async getVariant(variantId, options, signal) {
         return await this.#get("get_variant", {
-            attributes: options?.attributes?.length
+            attributes: options?.attributes !== undefined && options.attributes.length > 0
                 ? options.attributes.join(",")
                 : undefined,
-            blocks: options?.blocks?.length ? options.blocks.join(",") : undefined,
+            blocks: options?.blocks !== undefined && options.blocks.length > 0
+                ? options.blocks.join(",")
+                : undefined,
         }, signal, { variantId });
     }
     async materialBlocks(variantId, signal) {
@@ -168,7 +174,8 @@ export class MaterialGraphClient extends CatalogueClient {
      * what the corpus actually holds.
      */
     async schema(resource, signal) {
-        return await this.#get(SCHEMA_RESOURCE_OPERATION_IDS[resource], undefined, signal);
+        const response = await this.#get(SCHEMA_RESOURCE_OPERATION_IDS[resource], undefined, signal);
+        return { ...response, kind: resource };
     }
     /**
      * THE QUESTION: "what goes WITH this material?" — the companionship rail, hung
@@ -190,14 +197,14 @@ export class MaterialGraphClient extends CatalogueClient {
     }
     /** "What finishes does the brand declare for THIS product?" - {@link declaredFinishes}. */
     async associatedFinishes(variantId, options, signal) {
-        return await assoc.declaredFinishes(this.#transport, variantId, options, signal);
+        return await declaredFinishes(this.#transport, variantId, options, signal);
     }
     /** "What products does the brand declare THIS finish for?" - {@link declaredProducts}. */
     async associatedProducts(variantId, options, signal) {
-        return await assoc.declaredProducts(this.#transport, variantId, options, signal);
+        return await declaredProducts(this.#transport, variantId, options, signal);
     }
     async applicability(options, signal) {
-        return await assoc.applicability(this.#transport, options, signal);
+        return await applicability(this.#transport, options, signal);
     }
     /**
      * THE QUESTION: "eligible variants matching these hard filters, ranked and
@@ -221,24 +228,30 @@ export class MaterialGraphClient extends CatalogueClient {
      */
     async listVariants(input, signal) {
         return await this.#get("list_variants", {
-            attributes: input.attributes?.length
+            attributes: input.attributes !== undefined && input.attributes.length > 0
                 ? input.attributes.join(",")
                 : undefined,
             collapse: input.collapse,
-            colors: input.colors?.length ? JSON.stringify(input.colors) : undefined,
+            colors: input.colors !== undefined && input.colors.length > 0
+                ? JSON.stringify(input.colors)
+                : undefined,
             searchCatalogueSubset: input.searchCatalogueSubset,
             cursor: input.cursor,
             filters: input.filters ? JSON.stringify(input.filters) : undefined,
-            include: input.include?.length ? input.include.join(",") : undefined,
+            include: input.include !== undefined && input.include.length > 0
+                ? input.include.join(",")
+                : undefined,
             limit: input.limit,
             name: input.name,
             optionalFilters: input.optionalFilters
                 ? JSON.stringify(input.optionalFilters)
                 : undefined,
-            orderBy: input.orderBy?.length
+            orderBy: input.orderBy !== undefined && input.orderBy.length > 0
                 ? JSON.stringify(input.orderBy)
                 : undefined,
-            words: input.words?.length ? input.words.join(",") : undefined,
+            words: input.words !== undefined && input.words.length > 0
+                ? input.words.join(",")
+                : undefined,
         }, signal);
     }
     /**
@@ -272,17 +285,32 @@ export class MaterialGraphClient extends CatalogueClient {
     }
     /**
      * THE QUESTION: "which variants hold, resemble, or can be ranked by, this
-     * color?" (POST `/api/v1/variants/by-color`, MG-2217/MG-2230/MG-2247).
+     * color?" (GET `/api/v1/variants/by-color`, MG-2217/MG-2230/MG-2247).
      * One required `mode`: `contains` (a swatch for every required `colors[]`
      * condition), `palette` (whole-palette closeness to `colors[]`, an
      * image's extracted palette, or `targetVariantId`'s own palette) or
      * `rerank` (reorder a held `variantIds` set by color closeness).
      */
     async findVariantsByColor(input, signal) {
-        return await this.#post("find_variants_by_color", input, signal);
+        const { colors, image, ...rest } = input;
+        const query = { ...rest };
+        for (const [index, entry] of (colors ?? []).entries()) {
+            query[`color${index}`] = entry.color;
+            query[`color${index}.share`] = entry.share;
+            query[`color${index}.shareMax`] = entry.shareMax;
+            query[`color${index}.dominant`] = entry.dominant;
+            query[`color${index}.role`] = entry.role;
+        }
+        if (image) {
+            query.imageAssetId = image.assetId;
+            query.imageSourceId = image.sourceId;
+            query.imageUrl = image.url;
+            query.imageVariantId = image.variantId;
+        }
+        return await this.#get("find_variants_by_color", query, signal);
     }
     /**
-     * THE QUESTION: "what did designers sample together with these?" (POST
+     * THE QUESTION: "what did designers sample together with these?" (GET
      * `/api/v1/variants/sampled-together`, MG-2332). Give `variantIds` and/or
      * `materials` (free-text names, one variant each, at most twelve together);
      * the materials come back other brands first, then the most projects, each
@@ -292,7 +320,7 @@ export class MaterialGraphClient extends CatalogueClient {
      * before presenting: a scheme of four that resolved two is a different claim.
      */
     async findSampledTogether(input, signal) {
-        return await this.#post("find_sampled_together", input, signal);
+        return await this.#get("find_sampled_together", { ...input }, signal);
     }
     /**
      * THE QUESTION: "what looks or feels like this?" (POST

package/colors-client.d.ts

@@ -1,6 +1,7 @@
 import type { CategoryColorProfilesResponse, ColorProfilesParams } from "./color-profiles-types.js";
 import type { QueryParams } from "./http-transport.js";
-import type { SdkOperationId } from "./operations.js";
+import type { NearestPaintsParams, NearestPaintsOutput } from "./nearest-paints-types.js";
+import type { JsonOperationId, OperationResponses } from "./operation-responses.js";
 /**
  * The color surface, namespaced as `mg.colors` - `profiles`, the colors a
  * category comes in.
@@ -29,11 +30,13 @@ import type { SdkOperationId } from "./operations.js";
  */
 /** The client's own request primitives, handed down so this file owns no transport. */
 export type ColorsTransport = {
-    get<T>(operationId: SdkOperationId, query?: QueryParams, signal?: AbortSignal): Promise<T>;
+    get<K extends JsonOperationId>(operationId: K, query?: QueryParams, signal?: AbortSignal): Promise<OperationResponses[K]>;
 };
 export declare class ColorsClient {
     #private;
     constructor(transport: ColorsTransport);
+    /** Nearest Samplize catalogue paints for up to twelve hexes, deduplicated in input order. */
+    nearestPaints(params: NearestPaintsParams, signal?: AbortSignal): Promise<NearestPaintsOutput>;
     /**
      * THE QUESTION: "what colors does this CATEGORY come in?" - the
      * representative palette of 1 to 8 categories in ONE call (GET

package/colors-client.js

@@ -3,6 +3,10 @@ export class ColorsClient {
     constructor(transport) {
         this.#transport = transport;
     }
+    /** Nearest Samplize catalogue paints for up to twelve hexes, deduplicated in input order. */
+    async nearestPaints(params, signal) {
+        return await this.#transport.get("find_nearest_paints", { hex: params.hexes, limit: params.limit }, signal);
+    }
     /**
      * THE QUESTION: "what colors does this CATEGORY come in?" - the
      * representative palette of 1 to 8 categories in ONE call (GET

package/errors.d.ts

@@ -6,7 +6,7 @@ export type SanitizedIssue = {
     [key: string]: SanitizedErrorValue;
 };
 /** Normalized RFC 7807 body. Unknown response fields are intentionally discarded. */
-export interface ProblemDetail {
+export type ProblemDetail = {
     type: string;
     title: string;
     status: number;
@@ -23,7 +23,7 @@ export interface ProblemDetail {
      * not carry them. See {@link MATERIALGRAPH_PROBLEM_EXTENSIONS}.
      */
     readonly [extension: string]: unknown;
-}
+};
 /** Normalized residual `{ error }` body. Unknown response fields are discarded. */
 export type SimpleErrorBody = {
     error: string;
@@ -41,7 +41,7 @@ export type MaterialGraphRequestMetadata = {
     origin: string;
     path: string;
 };
-export interface MaterialGraphErrorInit {
+export type MaterialGraphErrorInit = {
     kind: MaterialGraphErrorKind;
     status?: number;
     retriable: boolean;
@@ -54,7 +54,7 @@ export interface MaterialGraphErrorInit {
     path?: string;
     /** Accepted for compatibility but deliberately never retained on the public error. */
     cause?: unknown;
-}
+};
 type ResponseErrorInput = {
     status: number;
     body: unknown;

package/errors.js

@@ -47,12 +47,15 @@ const MAX_EXTENSION_DEPTH = 8;
 const MAX_EXTENSION_ITEMS = 100;
 const MAX_EXTENSION_STRING = 1024;
 const isRecord = (value) => typeof value === "object" && value !== null;
-const redact = (text, secrets) => secrets.reduce((sanitized, secret) => {
-    if (secret.length === 0) {
-        return sanitized;
+const redact = (text, secrets) => {
+    let sanitized = text;
+    for (const secret of secrets) {
+        if (secret.length > 0) {
+            sanitized = sanitized.split(secret).join("[REDACTED]");
+        }
     }
-    return sanitized.split(secret).join("[REDACTED]");
-}, text);
+    return sanitized;
+};
 const safeString = (text, secrets) => redact(text, secrets).slice(0, MAX_EXTENSION_STRING);
 const secretVariants = (apiKey, queryValues) => [
     apiKey,
@@ -65,7 +68,7 @@ const requestMetadata = (input) => ({
     origin: input.origin,
     path: input.path,
 });
-function sanitizeValue(value, secrets, depth = 0) {
+const sanitizeValue = (value, secrets, depth = 0) => {
     if (depth >= MAX_EXTENSION_DEPTH) {
         return undefined;
     }
@@ -88,8 +91,8 @@ function sanitizeValue(value, secrets, depth = 0) {
         return undefined;
     }
     return sanitizeRecord(value, secrets, depth);
-}
-function sanitizeRecord(value, secrets, depth) {
+};
+const sanitizeRecord = (value, secrets, depth) => {
     const entries = Object.entries(value)
         .slice(0, MAX_EXTENSION_ITEMS)
         .flatMap(([key, item]) => {
@@ -99,7 +102,7 @@ function sanitizeRecord(value, secrets, depth) {
             : [[safeString(key, secrets), sanitized]];
     });
     return Object.fromEntries(entries);
-}
+};
 const sanitizeIssues = (value, secrets) => {
     if (!Array.isArray(value)) {
         return undefined;
@@ -111,7 +114,7 @@ const sanitizeIssues = (value, secrets) => {
 };
 const sanitizeSuggestions = (value, secrets) => {
     if (!Array.isArray(value) ||
-        value.some((suggestion) => typeof suggestion !== "string")) {
+        !value.every((suggestion) => typeof suggestion === "string")) {
         return undefined;
     }
     return value