@purveyors/sdk 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -141,6 +141,24 @@ interface paths {
                         "application/json": components["schemas"]["CatalogAccessResponse"];
                     };
                 };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
             };
         };
         put?: never;
@@ -160,7 +178,7 @@ interface paths {
         };
         /**
          * List public catalog coffees
-         * @description Public catalog listing. Excludes wholesale-restricted rows and returns only public fields. API-key callers are capped to their plan's per-call row limit.
+         * @description Public catalog listing. Excludes wholesale-restricted rows and returns only public fields. API-key callers are capped to their plan's per-call row limit. Requesting entitlement-gated params (price/score ranges, process facets, advanced sorts) you are not entitled to is handled per PADR-0013 §7: strict callers (API keys, bearer-session JWTs) receive a 401/403; lenient callers (anonymous, first-party web) get the params stripped with a `meta.notices` entry. Send `Prefer: handling=strict` to opt into strict enforcement; `Prefer: handling=lenient` is honored only for callers already lenient-eligible and cannot downgrade a strict caller's enforcement.
          */
         get: {
             parameters: {
@@ -170,8 +188,40 @@ interface paths {
                     stocked?: "true" | "false" | "all";
                     sort?: string;
                     order?: "asc" | "desc";
+                    showWholesale?: "true" | "false";
+                    wholesaleOnly?: "true" | "false";
+                    origin?: string;
+                    continent?: string;
+                    country?: string | string[];
+                    region?: string;
+                    source?: string | string[];
+                    name?: string;
+                    processing?: string;
+                    variety?: string;
+                    type?: string;
+                    grade?: string;
+                    appearance?: string;
+                    supplier?: string;
+                    dryingMethod?: string;
+                    flavorKeywords?: string | string[];
+                    arrivalDate?: string;
+                    stockedDate?: string;
+                    stockedDays?: number;
+                    coffeeIds?: string;
+                    scoreValueMin?: number | null;
+                    scoreValueMax?: number | null;
+                    pricePerLbMin?: number | null;
+                    pricePerLbMax?: number | null;
+                    processing_base_method?: string;
+                    fermentation_type?: string;
+                    process_additive?: string;
+                    has_additives?: "true" | "false";
+                    processing_disclosure_level?: string;
+                    processing_confidence_min?: number | null;
+                };
+                header?: {
+                    Prefer?: string;
                 };
-                header?: never;
                 path?: never;
                 cookie?: never;
             };
@@ -186,6 +236,175 @@ interface paths {
                         "application/json": components["schemas"]["CatalogListResponse"];
                     };
                 };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/catalog/facets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Catalog filter metadata and counted facets
+         * @description Returns access-aware catalog filter metadata. Values are computed after visibility and entitled content filters are applied; premium process metadata is included only for member sessions and paid API tiers. Requesting entitlement-gated filters you are not entitled to is handled per PADR-0013 §7: strict callers (API keys, bearer-session JWTs) receive a 401/403; lenient callers (anonymous, first-party web) get the filters stripped with a `meta.notices` entry. Send `Prefer: handling=strict` to opt into strict enforcement; `Prefer: handling=lenient` is honored only for callers already lenient-eligible and cannot downgrade a strict caller's enforcement.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    stocked?: "true" | "false" | "all";
+                    showWholesale?: "true" | "false";
+                    wholesaleOnly?: "true" | "false";
+                    origin?: string;
+                    continent?: string;
+                    country?: string | string[];
+                    region?: string;
+                    source?: string | string[];
+                    name?: string;
+                    processing?: string;
+                    variety?: string;
+                    type?: string;
+                    grade?: string;
+                    appearance?: string;
+                    supplier?: string;
+                    dryingMethod?: string;
+                    flavorKeywords?: string | string[];
+                    arrivalDate?: string;
+                    stockedDate?: string;
+                    stockedDays?: number;
+                    coffeeIds?: string | string[];
+                    scoreValueMin?: number | null;
+                    scoreValueMax?: number | null;
+                    pricePerLbMin?: number | null;
+                    pricePerLbMax?: number | null;
+                    processing_base_method?: string;
+                    fermentation_type?: string;
+                    process_additive?: string;
+                    has_additives?: "true" | "false";
+                    processing_disclosure_level?: string;
+                    processing_confidence_min?: number | null;
+                };
+                header?: {
+                    Prefer?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Access-aware catalog filter metadata */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogFacetsResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/catalog/origin-price-stats": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Live catalog price context by origin
+         * @description Returns per-origin live catalog price percentiles over the caller-visible stocked catalog. Used by first-party surfaces to compare a lot's visible display price against origin peers.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    showWholesale?: "true" | "false";
+                    wholesaleOnly?: "true" | "false";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Per-origin price context for caller-visible catalog rows */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogOriginPriceStatsResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
             };
         };
         put?: never;
@@ -225,6 +444,24 @@ interface paths {
                         "application/json": components["schemas"]["CatalogProofCoverageResponse"];
                     };
                 };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
             };
         };
         put?: never;
@@ -697,6 +934,12 @@ interface components {
                 canExport: boolean;
             };
         };
+        ErrorResponse: {
+            error: {
+                code: string;
+                message: string;
+            };
+        };
         CatalogItem: {
             id: number;
             name?: string | null;
@@ -712,9 +955,41 @@ interface components {
             score_value?: number | null;
             cost_lb?: number | null;
             price_per_lb?: number | null;
+            price_tiers?: unknown;
             arrival_date?: string | null;
             stocked_date?: string | null;
             stocked?: boolean | null;
+            wholesale?: boolean | null;
+            public_coffee?: boolean | null;
+            purveyor_score?: number | null;
+            purveyor_score_confidence?: number | null;
+            purveyor_score_tier?: string | null;
+            purveyor_score_factors?: unknown;
+            purveyor_score_version?: string | null;
+            purveyor_score_updated_at?: string | null;
+            processing_base_method?: string | null;
+            fermentation_type?: string | null;
+            process_additives?: unknown;
+            process_additive_detail?: string | null;
+            fermentation_duration_hours?: number | null;
+            processing_notes?: string | null;
+            processing_disclosure_level?: string | null;
+            processing_confidence?: number | null;
+            processing_evidence_available?: boolean | null;
+            drying_method?: string | null;
+            farm_notes?: string | null;
+            description_short?: string | null;
+            description_long?: string | null;
+            cupping_notes?: string | null;
+            roast_recs?: string | null;
+            lot_size?: string | null;
+            bag_size?: string | null;
+            packaging?: string | null;
+            link?: string | null;
+            last_updated?: string | null;
+            unstocked_date?: string | null;
+            ai_description?: string | null;
+            ai_tasting_notes?: unknown;
         };
         CatalogListResponse: {
             data: components["schemas"]["CatalogItem"][];
@@ -743,10 +1018,174 @@ interface components {
                 };
                 access: {
                     publicOnly: boolean;
+                    showWholesale: boolean;
+                    wholesaleOnly: boolean;
                     rowLimit: number | null;
                     limited: boolean;
                     totalAvailable: number;
                 };
+                /** @description Present only when requested filters/sorts were stripped because the caller lacked the capability. The request still returns 200 with the entitled subset applied. */
+                notices?: {
+                    status: 401 | 403;
+                    /** @enum {string} */
+                    code: "auth_required" | "entitlement_required";
+                    message: string;
+                    deniedParams: string[];
+                }[];
+            };
+        };
+        CatalogFacetsResponse: {
+            /** @description Compatibility-friendly unique values for dropdown filters. Keys with no values are omitted. */
+            values: {
+                sources?: string[];
+                continents?: string[];
+                countries?: string[];
+                regions?: string[];
+                processing?: string[];
+                cultivar_detail?: string[];
+                type?: string[];
+                grade?: string[];
+                appearance?: string[];
+                arrivalDates?: string[];
+                drying_method?: string[];
+                wholesale?: string[];
+                processing_base_method?: string[];
+                fermentation_type?: string[];
+                process_additives?: string[];
+                processing_disclosure_level?: string[];
+            };
+            /** @description Counted facet values for CLI/agent use. Counts are computed after visibility and entitled query filters are applied. */
+            facets: {
+                sources?: {
+                    value: string;
+                    count: number;
+                }[];
+                continents?: {
+                    value: string;
+                    count: number;
+                }[];
+                countries?: {
+                    value: string;
+                    count: number;
+                }[];
+                regions?: {
+                    value: string;
+                    count: number;
+                }[];
+                processing?: {
+                    value: string;
+                    count: number;
+                }[];
+                cultivar_detail?: {
+                    value: string;
+                    count: number;
+                }[];
+                type?: {
+                    value: string;
+                    count: number;
+                }[];
+                grade?: {
+                    value: string;
+                    count: number;
+                }[];
+                appearance?: {
+                    value: string;
+                    count: number;
+                }[];
+                arrivalDates?: {
+                    value: string;
+                    count: number;
+                }[];
+                drying_method?: {
+                    value: string;
+                    count: number;
+                }[];
+                wholesale?: {
+                    value: string;
+                    count: number;
+                }[];
+                processing_base_method?: {
+                    value: string;
+                    count: number;
+                }[];
+                fermentation_type?: {
+                    value: string;
+                    count: number;
+                }[];
+                process_additives?: {
+                    value: string;
+                    count: number;
+                }[];
+                processing_disclosure_level?: {
+                    value: string;
+                    count: number;
+                }[];
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "catalog-facets";
+                /** @enum {string} */
+                namespace: "/v1/catalog/facets";
+                /** @enum {string} */
+                version: "v1";
+                auth: {
+                    /** @enum {string} */
+                    kind: "session" | "api-key";
+                    /** @enum {string|null} */
+                    role: "viewer" | "member" | "admin" | null;
+                    /** @enum {string|null} */
+                    apiPlan: "viewer" | "member" | "enterprise" | null;
+                };
+                access: {
+                    publicOnly: boolean;
+                    showWholesale: boolean;
+                    wholesaleOnly: boolean;
+                    stocked: boolean | null;
+                    premiumMetadata: boolean;
+                };
+                notices?: {
+                    status: 401 | 403;
+                    /** @enum {string} */
+                    code: "auth_required" | "entitlement_required";
+                    message: string;
+                    deniedParams: string[];
+                }[];
+            };
+        };
+        CatalogOriginPriceStatsResponse: {
+            originPriceStats: {
+                origin: string;
+                median: number;
+                q1: number;
+                q3: number;
+                min: number;
+                max: number;
+                sample_size: number;
+                supplier_count: number;
+            }[];
+            meta: {
+                /** @enum {string} */
+                resource: "catalog-origin-price-stats";
+                /** @enum {string} */
+                namespace: "/v1/catalog/origin-price-stats";
+                /** @enum {string} */
+                version: "v1";
+                auth: {
+                    /** @enum {string} */
+                    kind: "anonymous" | "session" | "api-key";
+                    /** @enum {string|null} */
+                    role: "viewer" | "member" | "admin" | null;
+                    /** @enum {string|null} */
+                    apiPlan: "viewer" | "member" | "enterprise" | null;
+                };
+                access: {
+                    publicOnly: boolean;
+                    showWholesale: boolean;
+                    wholesaleOnly: boolean;
+                    /** @enum {string} */
+                    scope: "retail" | "wholesale" | "all";
+                    totalAvailable: number;
+                };
             };
         };
         CatalogProofCoverageResponse: {
@@ -866,12 +1305,6 @@ interface components {
                 };
             };
         };
-        ErrorResponse: {
-            error: {
-                code: string;
-                message: string;
-            };
-        };
         CatalogSimilarityTarget: {
             id: number;
             name: string;
@@ -1241,12 +1674,36 @@ interface ParchmentClientOptions {
     /** Override the fetch implementation (useful for tests or custom runtimes). */
     fetch?: ClientOptions["fetch"];
 }
+/** Query parameters for {@link ParchmentClient.catalog.list}. */
+type CatalogListQuery = NonNullable<paths["/v1/catalog"]["get"]["parameters"]["query"]>;
+/** Query parameters for {@link ParchmentClient.catalog.facets}. */
+type CatalogFacetsQuery = NonNullable<paths["/v1/catalog/facets"]["get"]["parameters"]["query"]>;
+/**
+ * Optional headers for {@link ParchmentClient.catalog.list}, notably the
+ * RFC 7240 `Prefer: handling=lenient|strict` override (PADR-0013 §7). Sending
+ * `handling=lenient` opts a strict caller (API key or bearer-session JWT) back
+ * into strip-with-notice degradation instead of a 401/403 hard-deny.
+ */
+type CatalogListHeaders = NonNullable<paths["/v1/catalog"]["get"]["parameters"]["header"]>;
+/** Optional headers for {@link ParchmentClient.catalog.facets}; see {@link CatalogListHeaders}. */
+type CatalogFacetsHeaders = NonNullable<paths["/v1/catalog/facets"]["get"]["parameters"]["header"]>;
+/** Query parameters for {@link ParchmentClient.catalog.originPriceStats}. */
+type CatalogOriginPriceStatsQuery = NonNullable<paths["/v1/catalog/origin-price-stats"]["get"]["parameters"]["query"]>;
+/** Query parameters for {@link ParchmentClient.catalog.similar}. */
+type CatalogSimilarQuery = NonNullable<paths["/v1/catalog/{id}/similar"]["get"]["parameters"]["query"]>;
+/** Query parameters for {@link ParchmentClient.priceIndex.list}. */
+type PriceIndexQuery = NonNullable<paths["/v1/price-index"]["get"]["parameters"]["query"]>;
+/** Query parameters for {@link ParchmentClient.procurement.briefs.matches}. */
+type BriefMatchesQuery = NonNullable<paths["/v1/procurement/briefs/{id}/matches"]["get"]["parameters"]["query"]>;
+/** Request body for {@link ParchmentClient.procurement.briefs.create}. */
+type SourcingBriefCreateRequest = components["schemas"]["SourcingBriefCreateRequest"];
 /**
  * Create a typed Parchment API client.
  *
  * The generated core (openapi-fetch over the generated `paths` types) is the
- * contract truth; the small named helpers below are the hand-maintained
- * ergonomic layer and grow as endpoints land.
+ * contract truth; the named helpers below are the hand-maintained ergonomic
+ * layer and grow as endpoints land. `raw` always exposes the underlying typed
+ * client for direct path access to anything not yet wrapped.
  */
 declare function createParchmentClient(options: ParchmentClientOptions): {
     /** The underlying typed openapi-fetch client for direct path access. */
@@ -1289,7 +1746,843 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             };
         };
     }> | undefined, `${string}/${string}`>>;
+    /** Resolved principal and entitlements for the caller. */
+    me: () => Promise<openapi_fetch.FetchResponse<{
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MeResponse"];
+                };
+            };
+        };
+    }, openapi_fetch.FetchOptions<{
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MeResponse"];
+                };
+            };
+        };
+    }> | undefined, `${string}/${string}`>>;
+    catalog: {
+        /** Catalog capabilities and visibility for the caller. */
+        access: () => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header? /** Catalog capabilities and visibility for the caller. */: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogAccessResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"] /** Live catalog price context by origin. */["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, openapi_fetch.FetchOptions<{
+            parameters: {
+                query?: never;
+                header? /** Catalog capabilities and visibility for the caller. */: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogAccessResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"] /** Live catalog price context by origin. */["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }> | undefined, `${string}/${string}`>>;
+        /**
+         * List public catalog coffees (paginated). Pass `headers` to send the
+         * `Prefer: handling=lenient|strict` override (see {@link CatalogListHeaders}).
+         */
+        list: (query?: CatalogListQuery, headers?: CatalogListHeaders) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    page?: number;
+                    limit?: number;
+                    stocked?: "true" | "false" | "all";
+                    sort?: string;
+                    order?: "asc" | "desc";
+                    showWholesale?: "true" | "false";
+                    wholesaleOnly?: "true" | "false";
+                    origin?: string;
+                    continent?: string;
+                    country?: string | string[];
+                    region?: string;
+                    source?: string | string[];
+                    name?: string;
+                    processing?: string;
+                    variety?: string;
+                    type?: string;
+                    grade?: string;
+                    appearance?: string;
+                    supplier?: string;
+                    dryingMethod?: string;
+                    flavorKeywords?: string | string[];
+                    arrivalDate?: string;
+                    stockedDate?: string;
+                    stockedDays?: number;
+                    coffeeIds?: string;
+                    scoreValueMin?: number | null;
+                    scoreValueMax?: number | null;
+                    pricePerLbMin?: number | null;
+                    pricePerLbMax?: number | null;
+                    processing_base_method?: string;
+                    fermentation_type?: string;
+                    process_additive?: string;
+                    has_additives?: "true" | "false";
+                    processing_disclosure_level?: string;
+                    processing_confidence_min?: number | null;
+                };
+                header?: {
+                    Prefer?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogListResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                query: {
+                    page?: number;
+                    limit?: number;
+                    stocked?: "true" | "false" | "all";
+                    sort?: string;
+                    order?: "asc" | "desc";
+                    showWholesale?: "true" | "false";
+                    wholesaleOnly?: "true" | "false";
+                    origin?: string;
+                    continent?: string;
+                    country?: string | string[];
+                    region?: string;
+                    source?: string | string[];
+                    name?: string;
+                    processing?: string;
+                    variety?: string;
+                    type?: string;
+                    grade?: string;
+                    appearance?: string;
+                    supplier?: string;
+                    dryingMethod?: string;
+                    flavorKeywords?: string | string[];
+                    arrivalDate?: string;
+                    stockedDate?: string;
+                    stockedDays?: number;
+                    coffeeIds?: string;
+                    scoreValueMin?: number | null;
+                    scoreValueMax?: number | null;
+                    pricePerLbMin?: number | null;
+                    pricePerLbMax?: number | null;
+                    processing_base_method?: string;
+                    fermentation_type?: string;
+                    process_additive?: string;
+                    has_additives?: "true" | "false";
+                    processing_disclosure_level?: string;
+                    processing_confidence_min?: number | null;
+                } | undefined;
+                header: {
+                    Prefer?: string;
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+        /**
+         * Catalog filter metadata and counted facets. Pass `headers` to send the
+         * `Prefer: handling=lenient|strict` override (see {@link CatalogFacetsHeaders}).
+         */
+        facets: (query?: CatalogFacetsQuery, headers?: CatalogFacetsHeaders) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    stocked?: "true" | "false" | "all";
+                    showWholesale?: "true" | "false";
+                    wholesaleOnly?: "true" | "false";
+                    origin?: string;
+                    continent?: string;
+                    country?: string | string[];
+                    region?: string;
+                    source?: string | string[];
+                    name?: string;
+                    processing?: string;
+                    variety?: string;
+                    type?: string;
+                    grade?: string;
+                    appearance?: string;
+                    supplier?: string;
+                    dryingMethod?: string;
+                    flavorKeywords?: string | string[];
+                    arrivalDate?: string;
+                    stockedDate?: string;
+                    stockedDays?: number;
+                    coffeeIds?: string | string[];
+                    scoreValueMin?: number | null;
+                    scoreValueMax?: number | null;
+                    pricePerLbMin?: number | null;
+                    pricePerLbMax?: number | null;
+                    processing_base_method?: string;
+                    fermentation_type?: string;
+                    process_additive?: string;
+                    has_additives?: "true" | "false";
+                    processing_disclosure_level?: string;
+                    processing_confidence_min?: number | null;
+                };
+                header?: {
+                    Prefer?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogFacetsResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                query: {
+                    stocked?: "true" | "false" | "all";
+                    showWholesale?: "true" | "false";
+                    wholesaleOnly?: "true" | "false";
+                    origin?: string;
+                    continent?: string;
+                    country?: string | string[];
+                    region?: string;
+                    source?: string | string[];
+                    name?: string;
+                    processing?: string;
+                    variety?: string;
+                    type?: string;
+                    grade?: string;
+                    appearance?: string;
+                    supplier?: string;
+                    dryingMethod?: string;
+                    flavorKeywords?: string | string[];
+                    arrivalDate?: string;
+                    stockedDate?: string;
+                    stockedDays?: number;
+                    coffeeIds?: string | string[];
+                    scoreValueMin?: number | null;
+                    scoreValueMax?: number | null;
+                    pricePerLbMin?: number | null;
+                    pricePerLbMax?: number | null;
+                    processing_base_method?: string;
+                    fermentation_type?: string;
+                    process_additive?: string;
+                    has_additives?: "true" | "false";
+                    processing_disclosure_level?: string;
+                    processing_confidence_min?: number | null;
+                } | undefined;
+                header: {
+                    Prefer?: string;
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+        /** Live catalog price context by origin. */
+        originPriceStats: (query?: CatalogOriginPriceStatsQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    showWholesale?: "true" | "false";
+                    wholesaleOnly?: "true" | "false";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogOriginPriceStatsResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                query: {
+                    showWholesale?: "true" | "false";
+                    wholesaleOnly?: "true" | "false";
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+        /** Aggregate proof-coverage over the public catalog. */
+        proofCoverage: () => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogProofCoverageResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, openapi_fetch.FetchOptions<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogProofCoverageResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }> | undefined, `${string}/${string}`>>;
+        /** Find catalog coffees similar to a target coffee. */
+        similar: (id: string, query?: CatalogSimilarQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    threshold?: string;
+                    limit?: number;
+                    stocked_only?: "true" | "false";
+                    mode?: "all" | "likely_same" | "similar_profile";
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogSimilarityResponse"];
+                    };
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                path: {
+                    id: string;
+                };
+                query: {
+                    threshold?: string;
+                    limit?: number;
+                    stocked_only?: "true" | "false";
+                    mode?: "all" | "likely_same" | "similar_profile";
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+    };
+    priceIndex: {
+        /** Parchment Price Index (aggregate snapshots). */
+        list: (query?: PriceIndexQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    page?: number;
+                    limit?: number;
+                    origin?: string;
+                    process?: string;
+                    grade?: string;
+                    from?: string;
+                    to?: string;
+                    wholesale?: "true" | "false";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["PriceIndexResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                query: {
+                    page?: number;
+                    limit?: number;
+                    origin?: string;
+                    process?: string;
+                    grade?: string;
+                    from?: string;
+                    to?: string;
+                    wholesale?: "true" | "false";
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+    };
+    procurement: {
+        briefs: {
+            /** List the caller's saved sourcing briefs. */
+            list: () => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query?: never;
+                    header?: never;
+                    path?: never;
+                    cookie?: never;
+                };
+                requestBody?: never;
+                responses: {
+                    200: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["SourcingBriefsListResponse"];
+                        };
+                    };
+                    401: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    403: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                };
+            }, openapi_fetch.FetchOptions<{
+                parameters: {
+                    query?: never;
+                    header?: never;
+                    path?: never;
+                    cookie?: never;
+                };
+                requestBody?: never;
+                responses: {
+                    200: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["SourcingBriefsListResponse"];
+                        };
+                    };
+                    401: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    403: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                };
+            }> | undefined, `${string}/${string}`>>;
+            /** Create a saved sourcing brief. */
+            create: (body: SourcingBriefCreateRequest) => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query?: never;
+                    header?: never;
+                    path?: never;
+                    cookie?: never;
+                };
+                requestBody?: {
+                    content: {
+                        "application/json": components["schemas"]["SourcingBriefCreateRequest"];
+                    };
+                };
+                responses: {
+                    201: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["SourcingBriefResponse"];
+                        };
+                    };
+                    400: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    401: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    403: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                };
+            }, {
+                body: {
+                    name: string;
+                    criteria: components["schemas"]["SourcingBriefCriteria"] & unknown;
+                    cadence?: "manual";
+                };
+            }, `${string}/${string}`>>;
+            /** Fetch one of the caller's sourcing briefs by id. */
+            get: (id: string) => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query?: never;
+                    header?: never;
+                    path: {
+                        id: string;
+                    };
+                    cookie?: never;
+                };
+                requestBody?: never;
+                responses: {
+                    200: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["SourcingBriefResponse"];
+                        };
+                    };
+                    401: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    403: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    404: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                };
+            }, {
+                params: {
+                    path: {
+                        id: string;
+                    };
+                };
+            }, `${string}/${string}`>>;
+            /** Run a saved brief against the catalog (paginated matches). */
+            matches: (id: string, query?: BriefMatchesQuery) => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query?: {
+                        page?: number;
+                        limit?: number;
+                    };
+                    header?: never;
+                    path: {
+                        id: string;
+                    };
+                    cookie?: never;
+                };
+                requestBody?: never;
+                responses: {
+                    200: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["SourcingBriefMatchesResponse"];
+                        };
+                    };
+                    400: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    401: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    403: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    404: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                };
+            }, {
+                params: {
+                    path: {
+                        id: string;
+                    };
+                    query: {
+                        page?: number;
+                        limit?: number;
+                    } | undefined;
+                };
+            }, `${string}/${string}`>>;
+        };
+    };
 };
 type ParchmentClient = ReturnType<typeof createParchmentClient>;
 
-export { type ParchmentClient, type ParchmentClientOptions, type components, createParchmentClient, type paths };
+export { type BriefMatchesQuery, type CatalogListQuery, type CatalogSimilarQuery, type ParchmentClient, type ParchmentClientOptions, type PriceIndexQuery, type SourcingBriefCreateRequest, type components, createParchmentClient, type paths };