@purveyors/sdk 0.32.0 → 0.33.0

package/dist/index.d.ts

@@ -2275,6 +2275,121 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/catalog/map": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Map projection over the caller-visible catalog
+         * @description Returns deterministic lightweight clusters and place features after applying the canonical catalog visibility, filters, and entitlement policy. Global unique/unplaced totals remain separate from viewport placement totals; multi-origin placement counts are intentionally non-additive. Public/demo callers receive country/region-safe features, while canonical place navigation, bounding boxes, and elevation profiles require member or paid API access. These catalog routes require a Supabase session JWT or Parchment API key. For entitlement-gated params, strict callers (non-demo API keys, bearer-session JWTs) receive a 401/403; lenient callers (first-party cookie-session and the configured public-demo API key) 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: {
+                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;
+                    scoreValueMin?: number | null;
+                    scoreValueMax?: number | null;
+                    pricePerLbMin?: number | null;
+                    pricePerLbMax?: number | null;
+                    elevationMinMasl?: number | null;
+                    elevationMaxMasl?: 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;
+                    place_id?: string;
+                    bbox?: string;
+                    zoom?: number;
+                    lens?: "catalog" | "elevation";
+                };
+                header?: {
+                    Prefer?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Authorized catalog map projection and elevation profile */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogMapResponse"];
+                    };
+                };
+                /** @description Malformed map geometry, zoom, place id, or elevation range */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @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"];
+                    };
+                };
+                /** @description Canonical catalog map schema is not deployed or the bounded map capacity is exceeded */
+                503: {
+                    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;
@@ -5334,6 +5449,114 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/roasts/batches": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create an owner roast batch
+         * @description Create every roast profile in one named batch atomically. The Idempotency-Key is required and payload-bound: same-key/same-payload retries replay, while changed payloads conflict. Requires an authenticated session, or an owner-bound API key carrying the exact roast:write scope.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    "idempotency-key": string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["RoastBatchCreateRequest"];
+                };
+            };
+            responses: {
+                /** @description The complete created roast batch */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RoastBatchMutationResponse"];
+                    };
+                };
+                /** @description Invalid query parameter */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @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"];
+                    };
+                };
+                /** @description No such coffee lot owned by the caller */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Write conflict: an If-Match precondition failed */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Per-user mutation throttle exceeded; retry after a short wait */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Roast writes are not enabled in this environment */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/roasts/{id}": {
         parameters: {
             query?: never;
@@ -5587,7 +5810,7 @@ interface paths {
         };
         trace?: never;
     };
-    "/v1/roasts/imports": {
+    "/v1/roasts/{id}/live-curve": {
         parameters: {
             query?: never;
             header?: never;
@@ -5595,33 +5818,34 @@ interface paths {
             cookie?: never;
         };
         get?: never;
-        put?: never;
         /**
-         * Create a roast from an Artisan file
-         * @description Parse an Artisan `.alog` file, create a roast profile owned by the caller against one of their green-coffee lots, and persist the imported temperature curve, event markers, and an artisan_import_log entry atomically. Requires an authenticated session, or an owner-bound API key carrying the exact roast:write scope.
+         * Replace an owner roast live curve
+         * @description Atomically replace live temperature samples and all event markers, derive milestone and phase fields upstream, and preserve non-live temperature samples. Optional If-Match protects against lost updates.
          */
-        post: {
+        put: {
             parameters: {
                 query?: never;
                 header?: {
-                    "idempotency-key"?: string;
+                    "if-match"?: string;
+                };
+                path: {
+                    id: number;
                 };
-                path?: never;
                 cookie?: never;
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["RoastImportCreateRequest"];
+                    "application/json": components["schemas"]["RoastLiveCurveRequest"];
                 };
             };
             responses: {
-                /** @description The created roast profile plus import summary */
-                201: {
+                /** @description The roast with its replaced live curve */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RoastImportResponse"];
+                        "application/json": components["schemas"]["RoastDetailResponse"];
                     };
                 };
                 /** @description Invalid query parameter */
@@ -5651,7 +5875,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description No such coffee lot owned by the caller */
+                /** @description No such roast profile owned by the caller */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -5689,13 +5913,14 @@ interface paths {
                 };
             };
         };
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/roasts/{id}/artisan-import": {
+    "/v1/roasts/batches/{batchName}": {
         parameters: {
             query?: never;
             header?: never;
@@ -5703,34 +5928,30 @@ interface paths {
             cookie?: never;
         };
         get?: never;
+        put?: never;
+        post?: never;
         /**
-         * Replace a roast's Artisan import
-         * @description Re-derive one of the caller's existing roasts from an Artisan `.alog` file: replace its temperature curve, event markers, milestones, chart bounds, and computed metrics, and write an artisan_import_log entry atomically. The roast's identity (coffee, batch name, roast date, weights, and user notes) is preserved. Optional `If-Match: <last_updated>` enables optimistic concurrency (409 on mismatch). Requires an authenticated session, or an owner-bound API key carrying the exact roast:write scope.
+         * Delete an owner roast batch
+         * @description Delete every roast profile carrying the exact batch name, plus nested temperature and event rows, in one transaction. This existing UI-level bulk action is restricted to authenticated sessions; API keys cannot call it.
          */
-        put: {
+        delete: {
             parameters: {
                 query?: never;
-                header?: {
-                    "if-match"?: string;
-                };
+                header?: never;
                 path: {
-                    id: number;
+                    batchName: string;
                 };
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["RoastArtisanImportReplaceRequest"];
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description The updated roast profile plus import summary */
+                /** @description The roast batch was deleted */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RoastImportResponse"];
+                        "application/json": components["schemas"]["RoastBatchDeleteResponse"];
                     };
                 };
                 /** @description Invalid query parameter */
@@ -5769,15 +5990,222 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Write conflict: an If-Match precondition failed */
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
+                /** @description Per-user mutation throttle exceeded; retry after a short wait */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Roast writes are not enabled in this environment */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/roasts/imports": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create a roast from an Artisan file
+         * @description Parse an Artisan `.alog` file, create a roast profile owned by the caller against one of their green-coffee lots, and persist the imported temperature curve, event markers, and an artisan_import_log entry atomically. Requires an authenticated session, or an owner-bound API key carrying the exact roast:write scope.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: {
+                    "idempotency-key"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["RoastImportCreateRequest"];
+                };
+            };
+            responses: {
+                /** @description The created roast profile plus import summary */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RoastImportResponse"];
+                    };
+                };
+                /** @description Invalid query parameter */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @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"];
+                    };
+                };
+                /** @description No such coffee lot owned by the caller */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Write conflict: an If-Match precondition failed */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Per-user mutation throttle exceeded; retry after a short wait */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Roast writes are not enabled in this environment */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/roasts/{id}/artisan-import": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Replace a roast's Artisan import
+         * @description Re-derive one of the caller's existing roasts from an Artisan `.alog` file: replace its temperature curve, event markers, milestones, chart bounds, and computed metrics, and write an artisan_import_log entry atomically. The roast's identity (coffee, batch name, roast date, weights, and user notes) is preserved. Optional `If-Match: <last_updated>` enables optimistic concurrency (409 on mismatch). Requires an authenticated session, or an owner-bound API key carrying the exact roast:write scope.
+         */
+        put: {
+            parameters: {
+                query?: never;
+                header?: {
+                    "if-match"?: string;
+                };
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["RoastArtisanImportReplaceRequest"];
+                };
+            };
+            responses: {
+                /** @description The updated roast profile plus import summary */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RoastImportResponse"];
+                    };
+                };
+                /** @description Invalid query parameter */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @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"];
+                    };
+                };
+                /** @description No such roast profile owned by the caller */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Write conflict: an If-Match precondition failed */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
                 /** @description Per-user mutation throttle exceeded; retry after a short wait */
                 429: {
                     headers: {
@@ -7037,35 +7465,164 @@ interface components {
                 }[];
             };
         };
-        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;
+        CatalogMapResponse: {
+            data: ({
+                /** @enum {string} */
+                type: "cluster";
+                id: string;
+                longitude: number;
+                latitude: number;
+                bounds: {
+                    west: number;
+                    south: number;
+                    east: number;
+                    north: number;
+                    crossesAntimeridian: boolean;
+                };
+                placement_count: number;
+                unique_coffee_count: number;
+                catalog_ids: number[];
+            } | {
+                /** @enum {string} */
+                type: "place";
+                id: string;
+                catalog_id: number;
+                /** Format: uuid */
+                place_id: string | null;
+                canonical_name: string;
+                /** @enum {string} */
+                place_type: "continent" | "country" | "region" | "subregion" | "locality" | "site";
+                longitude: number;
+                latitude: number;
+                /** @enum {string} */
+                geographic_precision: "none" | "continent" | "country" | "region" | "subregion" | "locality" | "site" | "exact_site";
+                /** @enum {string} */
+                coordinate_kind: "none" | "centroid" | "exact_point";
+                /** @enum {string} */
+                place_provenance: "reference_dataset" | "source_evidence" | "deterministic_resolution" | "manual_review";
+                /** @enum {string} */
+                assignment_role: "primary" | "additional";
+                /** @enum {string} */
+                assignment_provenance: "reference_dataset" | "source_evidence" | "deterministic_resolution" | "manual_review";
+                assignment_confidence: number;
+                elevation_min_masl: number | null;
+                elevation_max_masl: number | null;
+            })[];
+            elevation_profile: {
+                /** @enum {string} */
+                scope: "query" | "viewport";
+                row_count: number;
+                evidence_count: number;
+                complete_bound_count: number;
+                partial_bound_count: number;
+                unknown_count: number;
+                statistic_sample_count: number;
+                median_masl: number | null;
+                min_known_masl: number | null;
+                max_known_masl: number | null;
+                bands: {
+                    /** @enum {string} */
+                    key: "below_1000" | "1000_to_1399" | "1400_to_1799" | "1800_to_2199" | "2200_and_above";
+                    min_masl: number | null;
+                    max_masl_exclusive: number | null;
                     count: number;
                 }[];
-                continents?: {
-                    value: string;
-                    count: number;
+            } | null;
+            meta: {
+                /** @enum {string} */
+                resource: "catalog-map";
+                /** @enum {string} */
+                namespace: "/v1/catalog/map";
+                /** @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;
+                    rowLimit: number | null;
+                    limited: boolean;
+                    totalAvailable: number;
+                    fineGrainedPlaces: boolean;
+                    viewportSearch: boolean;
+                    elevationProfile: boolean;
+                };
+                effective: {
+                    zoom: number;
+                    /** @enum {string} */
+                    lens: "catalog" | "elevation";
+                    /** Format: uuid */
+                    place_id: string | null;
+                    bbox: {
+                        west: number;
+                        south: number;
+                        east: number;
+                        north: number;
+                        crossesAntimeridian: boolean;
+                    } | null;
+                };
+                totals: {
+                    unique_coffee_count: number;
+                    placed_unique_coffee_count: number;
+                    unplaced_unique_coffee_count: number;
+                    placement_count: number;
+                    mappable_placement_count: number;
+                    viewport_placed_unique_coffee_count: number;
+                    viewport_placement_count: number;
+                };
+                notices?: {
+                    status: 401 | 403;
+                    /** @enum {string} */
+                    code: "auth_required" | "entitlement_required";
+                    message: string;
+                    deniedParams: string[];
+                }[];
+                /** @description Freshness contract. `generatedAt` (ISO 8601) is the authoritative time this body was generated. `cacheStatus`/`ttlSeconds` are the resolved cache policy (ttl 0 for private/no-store); ttl is policy, not a promise — stale-while-revalidate may serve an older body, so trust `generatedAt` for actual age. */
+                freshness: {
+                    /** Format: date-time */
+                    generatedAt: string;
+                    /** @enum {string} */
+                    cacheStatus: "public" | "private";
+                    ttlSeconds: number;
+                };
+            };
+        };
+        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;
@@ -9146,6 +9703,41 @@ interface components {
             temperatures?: components["schemas"]["RoastTemperatureInput"][];
             events?: components["schemas"]["RoastEventInput"][];
         };
+        RoastBatchMutationResponse: {
+            data: {
+                batchName: string;
+                profiles: components["schemas"]["RoastDetailResource"][];
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "roast-batches";
+                /** @enum {string} */
+                namespace: "/v1/roasts/batches";
+                /** @enum {string} */
+                version: "v1";
+                auth: {
+                    /** @enum {string} */
+                    kind: "session" | "api-key";
+                    /** @enum {string|null} */
+                    role: "admin" | "member" | "viewer" | null;
+                    /** @enum {string|null} */
+                    apiPlan: "viewer" | "member" | "enterprise" | null;
+                };
+            };
+        };
+        RoastBatchItem: {
+            coffeeId: number;
+            coffeeName?: string;
+            ozIn?: number;
+            ozOut?: number;
+        };
+        RoastBatchCreateRequest: {
+            batchName: string;
+            roastDate?: string;
+            notes?: string;
+            targets?: string;
+            items: components["schemas"]["RoastBatchItem"][];
+        };
         RoastUpdateRequest: {
             coffeeName?: string;
             batchName?: string;
@@ -9184,6 +9776,10 @@ interface components {
             temperatures?: components["schemas"]["RoastTemperatureInput"][];
             events?: components["schemas"]["RoastEventInput"][];
         };
+        RoastLiveCurveRequest: {
+            temperatures: components["schemas"]["RoastTemperatureInput"][];
+            events: components["schemas"]["RoastEventInput"][];
+        };
         RoastDeleteResponse: {
             data: {
                 id: number;
@@ -9207,6 +9803,30 @@ interface components {
                 };
             };
         };
+        RoastBatchDeleteResponse: {
+            data: {
+                batchName: string;
+                ids: number[];
+                /** @enum {boolean} */
+                deleted: true;
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "roast-batches";
+                /** @enum {string} */
+                namespace: "/v1/roasts/batches";
+                /** @enum {string} */
+                version: "v1";
+                auth: {
+                    /** @enum {string} */
+                    kind: "session" | "api-key";
+                    /** @enum {string|null} */
+                    role: "admin" | "member" | "viewer" | null;
+                    /** @enum {string|null} */
+                    apiPlan: "viewer" | "member" | "enterprise" | null;
+                };
+            };
+        };
         ArtisanImportSummary: {
             fileName: string;
             fileSize: number;
@@ -9713,6 +10333,12 @@ type CatalogFacetsQuery = NonNullable<paths["/v1/catalog/facets"]["get"]["parame
  * into strip-with-notice degradation instead of a 401/403 hard-deny.
  */
 type CatalogListHeaders = NonNullable<paths["/v1/catalog"]["get"]["parameters"]["header"]>;
+/** Query parameters for {@link ParchmentClient.catalog.map}. */
+type CatalogMapQuery = NonNullable<paths["/v1/catalog/map"]["get"]["parameters"]["query"]>;
+/** Optional handling headers for {@link ParchmentClient.catalog.map}. */
+type CatalogMapHeaders = NonNullable<paths["/v1/catalog/map"]["get"]["parameters"]["header"]>;
+/** Lightweight map projection over the caller-visible catalog. */
+type CatalogMapResponse = components["schemas"]["CatalogMapResponse"];
 /** 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}. */
@@ -9799,8 +10425,12 @@ type RoastChartDataQuery = NonNullable<paths["/v1/roasts/{id}/chart-data"]["get"
 type RoastClassificationRequest = NonNullable<paths["/v1/roasts/classify"]["post"]["requestBody"]>["content"]["application/json"];
 /** Request body for {@link ParchmentClient.roasts.create}. */
 type RoastCreateRequest = NonNullable<paths["/v1/roasts"]["post"]["requestBody"]>["content"]["application/json"];
+/** Atomic named-batch body for {@link ParchmentClient.roasts.createBatch}. */
+type RoastBatchCreateRequest = NonNullable<paths["/v1/roasts/batches"]["post"]["requestBody"]>["content"]["application/json"];
 /** Request body for {@link ParchmentClient.roasts.update}. */
 type RoastUpdateRequest = NonNullable<paths["/v1/roasts/{id}"]["patch"]["requestBody"]>["content"]["application/json"];
+/** Source-aware live curve body for {@link ParchmentClient.roasts.replaceLiveCurve}. */
+type RoastLiveCurveRequest = NonNullable<paths["/v1/roasts/{id}/live-curve"]["put"]["requestBody"]>["content"]["application/json"];
 /** Request body for {@link ParchmentClient.roasts.import}. */
 type RoastImportRequest = NonNullable<paths["/v1/roasts/imports"]["post"]["requestBody"]>["content"]["application/json"];
 /** Request body for {@link ParchmentClient.roasts.replaceArtisanImport}. */
@@ -10622,7 +11252,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
         request: (body: AccountDeletionRequest) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
-                header?: never;
+                header
+                /** Optional headers for ranking endpoints; see {@link CatalogListHeaders}. */
+                ? /** Optional headers for ranking endpoints; see {@link CatalogListHeaders}. */: never;
                 path?: never;
                 cookie?: never;
             };
@@ -10949,7 +11581,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                             [name: string]: unknown;
                         };
                         content: {
-                            "application/json": components["schemas"]["ErrorResponse"];
+                            "application/json": components["schemas"] /** Actionable market value signals. */["ErrorResponse"];
                         };
                     };
                     503: {
@@ -11005,7 +11637,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                             [name: string]: unknown;
                         };
                         content: {
-                            "application/json": components["schemas"]["ErrorResponse"];
+                            "application/json": components["schemas"] /** Actionable market value signals. */["ErrorResponse"];
                         };
                     };
                     503: {
@@ -11276,11 +11908,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"] /**
-                         * Update one of the caller's own sales. The sales table carries no
-                         * `last_updated` column, so no If-Match optimistic concurrency is
-                         * offered.
-                         */["ErrorResponse"];
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
             };
@@ -11872,6 +12500,143 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 } | undefined;
             };
         }, `${string}/${string}`>>;
+        /** Deterministic clusters, canonical place features, and elevation profile. */
+        map: (query?: CatalogMapQuery, headers?: CatalogMapHeaders) => 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;
+                    scoreValueMin?: number | null;
+                    scoreValueMax?: number | null;
+                    pricePerLbMin?: number | null;
+                    pricePerLbMax?: number | null;
+                    elevationMinMasl?: number | null;
+                    elevationMaxMasl?: 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;
+                    place_id?: string;
+                    bbox?: string;
+                    zoom?: number;
+                    lens?: "catalog" | "elevation";
+                };
+                header?: {
+                    Prefer?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogMapResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+                503: {
+                    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;
+                    scoreValueMin?: number | null;
+                    scoreValueMax?: number | null;
+                    pricePerLbMin?: number | null;
+                    pricePerLbMax?: number | null;
+                    elevationMinMasl?: number | null;
+                    elevationMaxMasl?: 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;
+                    place_id?: string;
+                    bbox?: string;
+                    zoom?: number;
+                    lens?: "catalog" | "elevation";
+                } | 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}).
@@ -15103,6 +15868,104 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
             } | undefined;
         }, `${string}/${string}`>>;
+        /**
+         * Create every profile in one named batch atomically. The required
+         * payload-bound idempotency key makes transport retries safe.
+         */
+        createBatch: (body: RoastBatchCreateRequest, idempotencyKey: string) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header: {
+                    "idempotency-key": string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["RoastBatchCreateRequest"];
+                };
+            };
+            responses: {
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RoastBatchMutationResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            body: {
+                batchName: string;
+                roastDate?: string;
+                notes?: string;
+                targets?: string;
+                items: components["schemas"]["RoastBatchItem"][];
+            };
+            params: {
+                header: {
+                    "idempotency-key": string;
+                };
+            };
+        }, `${string}/${string}`>>;
         /**
          * Update one of the caller's own roast profiles. Pass `ifMatch` (the
          * row's `last_updated`) to enable optimistic concurrency (409 on mismatch).
@@ -15314,6 +16177,184 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
             };
         }, `${string}/${string}`>>;
+        /** Delete every owner roast carrying one exact batch name. Session-only. */
+        deleteBatch: (batchName: string) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    batchName: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RoastBatchDeleteResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                path: {
+                    batchName: string;
+                };
+            };
+        }, `${string}/${string}`>>;
+        /**
+         * Replace live temperature samples and all event markers atomically,
+         * while preserving non-live temperatures and deriving milestone fields.
+         */
+        replaceLiveCurve: (id: number, body: RoastLiveCurveRequest, options?: {
+            ifMatch?: string;
+        }) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: {
+                    "if-match"?: string;
+                };
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["RoastLiveCurveRequest"];
+                };
+            };
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RoastDetailResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                path: {
+                    id: number;
+                };
+                header: {
+                    "if-match": string;
+                } | undefined;
+            };
+            body: {
+                temperatures: components["schemas"]["RoastTemperatureInput"][];
+                events: components["schemas"]["RoastEventInput"][];
+            };
+        }, `${string}/${string}`>>;
         /**
          * Create a roast profile from an Artisan `.alog` file against one of the
          * caller's green-coffee lots, persisting the imported curve, events, and
@@ -16143,4 +17184,4 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
 };
 type ParchmentClient = ReturnType<typeof createParchmentClient>;
 
-export { type AccountDeletionOperation, type AccountDeletionRequest, type BillingCheckoutCreateRequest, type BillingCheckoutSession, type BillingManualEntitlementsRequest, type BillingSubscriptionMutationRequest, type BillingSubscriptionOperation, type BriefMatchesQuery, type CatalogInventoryBatchLifecycle, type CatalogInventoryBatchReserveRequest, type CatalogInventoryBatchResult, type CatalogItem, type CatalogListQuery, type CatalogProofSummary, type CatalogSimilarQuery, type InventoryCreateRequest, type InventoryShareCatalog, type InventoryShareGrant, type InventoryShareGrantCreateRequest, type InventoryShareGrantRedeemRequest, type InventoryShareInventory, type InventoryShareRoastSummary, type InventoryUpdateRequest, type MarketOverview, type MarketSignalsQuery, type MetadataIndexQuery, type OwnerApiUsage, type OwnerApiUsageQuery, type ParchmentClient, type ParchmentClientOptions, type PriceIndexQuery, type PriceIndexStatsQuery, type ProfitItem, type ProfitListQuery, type RoastChartDataQuery, type SalesCreateRequest, type SalesListQuery, type SalesUpdateRequest, type SourcingBriefCreateRequest, type TrackedLotMutation, type TrackedLotSummary, type TrackedLotsListQuery, type components, createParchmentClient, type paths };
+export { type AccountDeletionOperation, type AccountDeletionRequest, type BillingCheckoutCreateRequest, type BillingCheckoutSession, type BillingManualEntitlementsRequest, type BillingSubscriptionMutationRequest, type BillingSubscriptionOperation, type BriefMatchesQuery, type CatalogInventoryBatchLifecycle, type CatalogInventoryBatchReserveRequest, type CatalogInventoryBatchResult, type CatalogItem, type CatalogListQuery, type CatalogMapHeaders, type CatalogMapQuery, type CatalogMapResponse, type CatalogProofSummary, type CatalogSimilarQuery, type InventoryCreateRequest, type InventoryShareCatalog, type InventoryShareGrant, type InventoryShareGrantCreateRequest, type InventoryShareGrantRedeemRequest, type InventoryShareInventory, type InventoryShareRoastSummary, type InventoryUpdateRequest, type MarketOverview, type MarketSignalsQuery, type MetadataIndexQuery, type OwnerApiUsage, type OwnerApiUsageQuery, type ParchmentClient, type ParchmentClientOptions, type PriceIndexQuery, type PriceIndexStatsQuery, type ProfitItem, type ProfitListQuery, type RoastBatchCreateRequest, type RoastChartDataQuery, type RoastLiveCurveRequest, type SalesCreateRequest, type SalesListQuery, type SalesUpdateRequest, type SourcingBriefCreateRequest, type TrackedLotMutation, type TrackedLotSummary, type TrackedLotsListQuery, type components, createParchmentClient, type paths };