@purveyors/sdk 0.31.0 → 0.33.0

package/dist/index.d.ts

@@ -2221,6 +2221,8 @@ interface paths {
                     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;
@@ -2273,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;
@@ -2282,7 +2399,7 @@ interface paths {
         };
         /**
          * Catalog filter metadata and counted facets
-         * @description Returns access-aware catalog filter metadata. Values are computed after visibility and entitled content filters are applied; importer, elevation, appearance, and premium process metadata are included only for member sessions and paid API tiers. 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.
+         * @description Returns access-aware catalog filter metadata. Values are computed after visibility and entitled content filters are applied; importer, legacy elevation/grade, appearance, and premium process metadata are included only for member sessions and paid API tiers. Raw fine-grained geography remains display-only until canonical place-ID filtering lands. 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: {
@@ -2312,6 +2429,8 @@ interface paths {
                     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;
@@ -4123,6 +4242,168 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/inventory/share-grants": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create or replay an inventory share grant
+         * @description Create a time-bounded bearer capability for all current owner inventory or one owned inventory row. Only entitled session principals may create grants; anonymous callers and API keys are rejected. The raw token appears only in the create response or an operation replay.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["InventoryShareGrantCreateRequest"];
+                };
+            };
+            responses: {
+                /** @description The created grant, or the original same-operation replay */
+                201: {
+                    headers: {
+                        /** @description Prevents caching of the raw bearer capability. */
+                        "Cache-Control"?: "no-store";
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["InventoryShareGrantCreateResponse"];
+                    };
+                };
+                /** @description Invalid grant request */
+                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 The requested inventory row is not owned by the caller */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Operation is in flight or bound to another payload */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Inventory mutation rate limit exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Replay state could not be completed */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inventory/share-grants/redeem": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Redeem an inventory share capability
+         * @description Redeem a bearer capability without a user session. Every invalid, malformed, expired, inactive, unauthorized, deleted-owner, or entitlement-failure case returns the same empty response.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["InventoryShareGrantRedeemRequest"];
+                };
+            };
+            responses: {
+                /** @description The shared inventory projection, or the indistinguishable empty result for an invalid capability */
+                200: {
+                    headers: {
+                        /** @description Capability redemption responses are never cacheable. */
+                        "Cache-Control"?: "no-store";
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["InventoryShareGrantRedeemResponse"];
+                    };
+                };
+                /** @description Anonymous redemption rate limit exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/inventory/manual-batches": {
         parameters: {
             query?: never;
@@ -5168,24 +5449,132 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/roasts/{id}": {
+    "/v1/roasts/batches": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Get an owner roast
-         * @description Fetch one of the authenticated principal's roast profiles by id, optionally with its temperature curve and event markers. Requires an authenticated session, or an owner-bound API key carrying the roast:read scope.
+         * 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.
          */
-        get: {
+        post: {
             parameters: {
-                query?: {
-                    includeTemps?: boolean | null;
-                    includeEvents?: boolean | null;
+                query?: never;
+                header: {
+                    "idempotency-key": string;
                 };
-                header?: never;
+                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;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get an owner roast
+         * @description Fetch one of the authenticated principal's roast profiles by id, optionally with its temperature curve and event markers. Requires an authenticated session, or an owner-bound API key carrying the roast:read scope.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    includeTemps?: boolean | null;
+                    includeEvents?: boolean | null;
+                };
+                header?: never;
                 path: {
                     id: string;
                 };
@@ -5421,7 +5810,7 @@ interface paths {
         };
         trace?: never;
     };
-    "/v1/roasts/imports": {
+    "/v1/roasts/{id}/live-curve": {
         parameters: {
             query?: never;
             header?: never;
@@ -5429,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 */
@@ -5485,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;
@@ -5523,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;
@@ -5537,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 */
@@ -5603,15 +5990,6 @@ 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: {
@@ -5632,29 +6010,55 @@ interface paths {
                 };
             };
         };
-        post?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/roasts/imports": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
         /**
-         * Clear a roast's Artisan import
-         * @description Remove import-derived temperature samples, event markers, and artisan_import_log rows from one of the caller's existing roasts without deleting the roast profile. Import-derived profile metrics are reset to manual/null values. Requires an authenticated session, or an owner-bound API key carrying the exact roast:write scope.
+         * 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.
          */
-        delete: {
+        post: {
             parameters: {
                 query?: never;
-                header?: never;
-                path: {
-                    id: number;
+                header?: {
+                    "idempotency-key"?: string;
                 };
+                path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["RoastImportCreateRequest"];
+                };
+            };
             responses: {
-                /** @description The cleared roast id plus deleted row counts */
-                200: {
+                /** @description The created roast profile plus import summary */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RoastArtisanImportClearResponse"];
+                        "application/json": components["schemas"]["RoastImportResponse"];
+                    };
+                };
+                /** @description Invalid query parameter */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
                 /** @description Authentication required */
@@ -5675,7 +6079,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description No such roast profile owned by the caller */
+                /** @description No such coffee lot owned by the caller */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -5684,6 +6088,15 @@ 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: {
@@ -5704,12 +6117,13 @@ interface paths {
                 };
             };
         };
+        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/roasts/classify": {
+    "/v1/roasts/{id}/artisan-import": {
         parameters: {
             query?: never;
             header?: never;
@@ -5717,34 +6131,37 @@ interface paths {
             cookie?: never;
         };
         get?: never;
-        put?: never;
         /**
-         * Classify an imported roast
-         * @description Match Artisan roast metadata to one of the supplied owner inventory rows. Requires member entitlement and either an authenticated session or an owner-bound API key carrying the exact roast:read scope.
+         * 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.
          */
-        post: {
+        put: {
             parameters: {
                 query?: never;
-                header?: never;
-                path?: never;
+                header?: {
+                    "if-match"?: string;
+                };
+                path: {
+                    id: number;
+                };
                 cookie?: never;
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["RoastClassificationRequest"];
+                    "application/json": components["schemas"]["RoastArtisanImportReplaceRequest"];
                 };
             };
             responses: {
-                /** @description Best inventory match, or null when no reasonable match exists */
+                /** @description The updated roast profile plus import summary */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RoastClassificationResponse"];
+                        "application/json": components["schemas"]["RoastImportResponse"];
                     };
                 };
-                /** @description Invalid request body or input cap exceeded */
+                /** @description Invalid query parameter */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -5771,8 +6188,8 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description API or upstream classification rate limit exceeded */
-                429: {
+                /** @description No such roast profile owned by the caller */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -5780,8 +6197,8 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Classification provider is unavailable or not configured */
-                503: {
+                /** @description Write conflict: an If-Match precondition failed */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -5789,15 +6206,192 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/roasts/{id}/chart-data": {
+                /** @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"];
+                    };
+                };
+            };
+        };
+        post?: never;
+        /**
+         * Clear a roast's Artisan import
+         * @description Remove import-derived temperature samples, event markers, and artisan_import_log rows from one of the caller's existing roasts without deleting the roast profile. Import-derived profile metrics are reset to manual/null values. Requires an authenticated session, or an owner-bound API key carrying the exact roast:write scope.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The cleared roast id plus deleted row counts */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RoastArtisanImportClearResponse"];
+                    };
+                };
+                /** @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 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/classify": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Classify an imported roast
+         * @description Match Artisan roast metadata to one of the supplied owner inventory rows. Requires member entitlement and either an authenticated session or an owner-bound API key carrying the exact roast:read scope.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["RoastClassificationRequest"];
+                };
+            };
+            responses: {
+                /** @description Best inventory match, or null when no reasonable match exists */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RoastClassificationResponse"];
+                    };
+                };
+                /** @description Invalid request body or input cap exceeded */
+                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 API or upstream classification rate limit exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Classification provider is unavailable or not configured */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/roasts/{id}/chart-data": {
         parameters: {
             query?: never;
             header?: never;
@@ -6765,6 +7359,16 @@ interface components {
             continent?: string | null;
             country?: string | null;
             region?: string | null;
+            /** @description Raw source geography for display; not a canonical place identity or filter value */
+            subregion?: string | null;
+            /** @description Raw source geography for display; not a canonical place identity or filter value */
+            locality?: string | null;
+            /** @description Raw cultivation-site label for display; not a canonical place identity or filter value */
+            site?: string | null;
+            /** @description Reported minimum elevation in meters above sea level (member sessions and paid API tiers only) */
+            elevation_min_masl?: number | null;
+            /** @description Reported maximum elevation in meters above sea level (member sessions and paid API tiers only) */
+            elevation_max_masl?: number | null;
             processing?: string | null;
             cultivar_detail?: string | null;
             type?: string | null;
@@ -6861,6 +7465,135 @@ interface components {
                 }[];
             };
         };
+        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;
+                }[];
+            } | 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: {
@@ -8432,14 +9165,121 @@ interface components {
                 };
             };
         };
-        ManualInventoryBatchResult: {
-            /** Format: uuid */
-            batchId: string;
-            items: {
-                /** Format: uuid */
-                rowId: string;
-                resource: components["schemas"]["InventoryResource"];
-            }[];
+        InventoryShareGrantScope: {
+            /** @enum {string} */
+            type: "all";
+        } | {
+            /** @enum {string} */
+            type: "inventory";
+            inventoryId: number;
+        };
+        InventoryShareGrant: {
+            /** Format: uuid */
+            id: string;
+            /** @description 256-bit bearer capability returned only when the grant is created or replayed with the same operation and payload. */
+            token: string;
+            scope: components["schemas"]["InventoryShareGrantScope"];
+            /** Format: date-time */
+            expiresAt: string;
+        };
+        InventoryShareGrantCreateResponse: {
+            data: components["schemas"]["InventoryShareGrant"];
+            meta: {
+                /** @enum {string} */
+                resource: "inventory-share-grant";
+                /** @enum {string} */
+                namespace: "/v1/inventory/share-grants";
+                /** @enum {string} */
+                version: "v1";
+            };
+        };
+        InventoryShareGrantCreateRequest: {
+            /**
+             * Format: uuid
+             * @description Stable owner-scoped operation identity. Reusing it with the same normalized request replays the original grant and token; changing the request conflicts.
+             */
+            operationId: string;
+            scope: components["schemas"]["InventoryShareGrantScope"];
+            /** @description Grant lifetime in whole days (default 7, maximum 30). */
+            expiresInDays?: number;
+        };
+        InventoryShareCatalog: {
+            name: string | null;
+            score_value: number | null;
+            arrival_date: string | null;
+            continent: string | null;
+            country: string | null;
+            region: string | null;
+            processing: string | null;
+            drying_method: string | null;
+            lot_size: string | null;
+            bag_size: string | null;
+            packaging: string | null;
+            cultivar_detail: string | null;
+            grade: string | null;
+            appearance: string | null;
+            roast_recs: string | null;
+            type: string | null;
+            description_short: string | null;
+            description_long: string | null;
+            farm_notes: string | null;
+            link: string | null;
+            cost_lb: number | null;
+            price_per_lb: number | null;
+            source: string | null;
+            stocked: boolean | null;
+            cupping_notes: string | null;
+            stocked_date: string | null;
+            unstocked_date: string | null;
+            ai_description: string | null;
+            ai_tasting_notes: string | null;
+            public_coffee: boolean | null;
+            wholesale: boolean | null;
+            price_tiers: {
+                min_lbs: number;
+                price: number;
+            }[] | null;
+        } | null;
+        InventoryShareRoastSummary: {
+            oz_in: number | null;
+            oz_out: number | null;
+            weight_loss_percent: number | null;
+            roast_id: number;
+            batch_name: string | null;
+            roast_date: string | null;
+        };
+        InventoryShareInventory: {
+            id: number;
+            rank: number | null;
+            notes: string | null;
+            cupping_notes: string | number | boolean | unknown[] | {
+                [key: string]: unknown;
+            } | null;
+            purchase_date: string | null;
+            purchased_qty_lbs: number | null;
+            bean_cost: number | null;
+            tax_ship_cost: number | null;
+            last_updated: string | null;
+            catalog_id: number | null;
+            stocked: boolean | null;
+            ai_tasting_notes: string | null;
+            coffee_catalog: components["schemas"]["InventoryShareCatalog"];
+            roast_profiles: components["schemas"]["InventoryShareRoastSummary"][];
+        };
+        InventoryShareGrantRedeemResponse: {
+            data: components["schemas"]["InventoryShareInventory"][];
+        };
+        InventoryShareGrantRedeemRequest: {
+            token: string;
+        };
+        ManualInventoryBatchResult: {
+            /** Format: uuid */
+            batchId: string;
+            items: {
+                /** Format: uuid */
+                rowId: string;
+                resource: components["schemas"]["InventoryResource"];
+            }[];
         };
         ManualInventoryBatchResponse: {
             data: components["schemas"]["ManualInventoryBatchResult"];
@@ -8863,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;
@@ -8901,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;
@@ -8924,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;
@@ -9430,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}. */
@@ -9480,6 +10389,18 @@ type TrackedLotMutation = components["schemas"]["TrackedLotMutationResponse"];
 type InventoryListQuery = NonNullable<paths["/v1/inventory"]["get"]["parameters"]["query"]>;
 /** Request body for {@link ParchmentClient.inventory.create}. */
 type InventoryCreateRequest = NonNullable<paths["/v1/inventory"]["post"]["requestBody"]>["content"]["application/json"];
+/** Stable-operation request for {@link ParchmentClient.inventory.shareGrants.create}. */
+type InventoryShareGrantCreateRequest = NonNullable<paths["/v1/inventory/share-grants"]["post"]["requestBody"]>["content"]["application/json"];
+/** The one-time raw-token grant returned by create or same-operation replay. */
+type InventoryShareGrant = components["schemas"]["InventoryShareGrant"];
+/** Anonymous capability body for {@link ParchmentClient.inventory.shareGrants.redeem}. */
+type InventoryShareGrantRedeemRequest = NonNullable<paths["/v1/inventory/share-grants/redeem"]["post"]["requestBody"]>["content"]["application/json"];
+/** Safe legacy-oriented inventory row returned by capability redemption. */
+type InventoryShareInventory = components["schemas"]["InventoryShareInventory"];
+/** Catalog allowlist nested in a shared inventory row. */
+type InventoryShareCatalog = components["schemas"]["InventoryShareCatalog"];
+/** Six-field roast summary nested in member/admin shares. */
+type InventoryShareRoastSummary = components["schemas"]["InventoryShareRoastSummary"];
 type CatalogInventoryCreateRequest = components["schemas"]["CatalogInventoryCreateRequest"];
 type ManualInventoryCreateRequest = components["schemas"]["ManualInventoryCreateRequest"];
 /** Request body for {@link ParchmentClient.inventory.createManualBatch}. */
@@ -9504,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}. */
@@ -10327,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;
             };
@@ -10654,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: {
@@ -10710,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: {
@@ -11484,6 +12411,8 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     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;
@@ -11557,12 +12486,151 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     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;
+                } | undefined;
+                header: {
+                    Prefer?: string;
+                } | 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;
@@ -11601,6 +12669,8 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     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;
@@ -11669,6 +12739,8 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     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;
@@ -13269,9 +14341,142 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 } | undefined;
             };
         }, `${string}/${string}`>>;
-        /**
-         * Create an owner inventory lot. Requires a session or an owner-bound API
-         * key carrying the exact `inventory:write` scope. Manual coffee creates
+        shareGrants: {
+            /**
+             * Mint or replay a bounded cross-principal inventory capability. The
+             * operation UUID is payload-bound and the raw token is returned only
+             * by this response.
+             */
+            create: (body: InventoryShareGrantCreateRequest) => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query?: never;
+                    header?: never;
+                    path?: never;
+                    cookie?: never;
+                };
+                requestBody: {
+                    content: {
+                        "application/json": components["schemas"]["InventoryShareGrantCreateRequest"];
+                    };
+                };
+                responses: {
+                    201: {
+                        headers: {
+                            "Cache-Control"?: "no-store";
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["InventoryShareGrantCreateResponse"];
+                        };
+                    };
+                    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: {
+                    operationId: string;
+                    scope: components["schemas"]["InventoryShareGrantScope"];
+                    expiresInDays?: number;
+                };
+            }, `${string}/${string}`>>;
+            /**
+             * Redeem a capability supplied in JSON (never in a URL). This helper
+             * does not require the client to be configured with a bearer token.
+             */
+            redeem: (body: InventoryShareGrantRedeemRequest) => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query?: never;
+                    header?: never;
+                    path?: never;
+                    cookie?: never;
+                };
+                requestBody: {
+                    content: {
+                        "application/json": components["schemas"]["InventoryShareGrantRedeemRequest"];
+                    };
+                };
+                responses: {
+                    200: {
+                        headers: {
+                            "Cache-Control"?: "no-store";
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["InventoryShareGrantRedeemResponse"];
+                        };
+                    };
+                    429: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                };
+            }, {
+                body: {
+                    token: string;
+                };
+            }, `${string}/${string}`>>;
+        };
+        /**
+         * Create an owner inventory lot. Requires a session or an owner-bound API
+         * key carrying the exact `inventory:write` scope. Manual coffee creates
          * require `idempotencyKey`; catalog-backed creates accept it optionally.
          * The same key and payload replay the original result.
          */
@@ -14663,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).
@@ -14874,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
@@ -15703,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 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 };