@purveyors/sdk 0.7.1 → 0.9.0

package/dist/index.d.ts

@@ -201,7 +201,7 @@ interface paths {
                 content: {
                     "application/json": {
                         name: string;
-                        scopes?: ("catalog:read" | "inventory:read" | "roast:read" | "sales:read" | "tasting:read" | "inventory:write" | "roast:write")[];
+                        scopes?: ("catalog:read" | "inventory:read" | "roast:read" | "sales:read" | "tasting:read" | "inventory:write" | "roast:write" | "sales:write" | "tasting:write")[];
                     };
                 };
             };
@@ -2942,13 +2942,274 @@ interface paths {
             };
         };
         put?: never;
-        post?: never;
+        /**
+         * Record an owner sale
+         * @description Record a sale against one of the caller's own green-coffee inventory lots. Requires an authenticated session, or an owner-bound API key carrying the exact sales:write scope.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: {
+                    "idempotency-key"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["SalesCreateRequest"];
+                };
+            };
+            responses: {
+                /** @description The created sale */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["SaleItemResponse"];
+                    };
+                };
+                /** @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 Write conflict: a request with this Idempotency-Key is already in flight */
+                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 Sales 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/sales/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete an owner sale
+         * @description Delete one of the caller's own sales. Requires an authenticated session, or an owner-bound API key carrying the exact sales:write scope.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The sale was deleted */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["SaleDeleteResponse"];
+                    };
+                };
+                /** @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 sale 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 Sales writes are not enabled in this environment */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        /**
+         * Update an owner sale
+         * @description Update fields on one of the caller's own sales. The sales table carries no last_updated column, so no If-Match optimistic concurrency is offered. Requires an authenticated session, or an owner-bound API key carrying the exact sales:write scope.
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["SalesUpdateRequest"];
+                };
+            };
+            responses: {
+                /** @description The updated sale */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["SaleItemResponse"];
+                    };
+                };
+                /** @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 sale 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 Sales writes are not enabled in this environment */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        trace?: never;
+    };
     "/v1/tasting/{catalogId}": {
         parameters: {
             query?: never;
@@ -3028,20 +3289,119 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-}
-interface components {
-    schemas: {
-        HealthResponse: {
-            /** @enum {string} */
-            status: "ok";
-            /** @enum {string} */
-            service: "parchment-api";
-            version: string;
-            /** Format: date-time */
-            timestamp: string;
-        };
-        DiscoveryResponse: {
-            /** @enum {string} */
+    "/v1/tasting/inventory/{inventoryId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Rate an owned inventory lot
+         * @description Atomically replace the caller's cupping notes for one owned green-coffee inventory lot. Session members write through RLS; owner-bound API keys require the exact tasting:write scope.
+         */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    inventoryId: number;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["TastingRateRequest"];
+                };
+            };
+            responses: {
+                /** @description Canonical inventory tasting */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["TastingRateResponse"];
+                    };
+                };
+                /** @description Invalid rating */
+                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 Inventory tasting not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Per-user mutation throttle exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Tasting writes are disabled */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+interface components {
+    schemas: {
+        HealthResponse: {
+            /** @enum {string} */
+            status: "ok";
+            /** @enum {string} */
+            service: "parchment-api";
+            version: string;
+            /** Format: date-time */
+            timestamp: string;
+        };
+        DiscoveryResponse: {
+            /** @enum {string} */
             product: "Parchment";
             namespace: string;
             health: string;
@@ -4886,6 +5246,69 @@ interface components {
                 };
             };
         };
+        SaleItemResponse: {
+            data: components["schemas"]["SaleResource"];
+            meta: {
+                /** @enum {string} */
+                resource: "sales";
+                /** @enum {string} */
+                namespace: "/v1/sales";
+                /** @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;
+                };
+            };
+        };
+        SalesCreateRequest: {
+            /** @description green_coffee_inv.id of the caller's own inventory lot this sale draws from. */
+            greenCoffeeInvId: number;
+            /** @description Ounces sold (positive). */
+            ozSold: number;
+            /** @description Sale price (non-negative). */
+            price: number;
+            /** @description Buyer name (optional). */
+            buyer?: string;
+            /** @description Batch label for the sale (optional). */
+            batchName?: string;
+            /** @description Sale date (YYYY-MM-DD); defaults to today (UTC). */
+            sellDate?: string;
+        };
+        SalesUpdateRequest: {
+            ozSold?: number;
+            price?: number;
+            buyer?: string;
+            batchName?: string;
+            sellDate?: string;
+        };
+        SaleDeleteResponse: {
+            data: {
+                id: number;
+                /** @enum {boolean} */
+                deleted: true;
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "sales";
+                /** @enum {string} */
+                namespace: "/v1/sales";
+                /** @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;
+                };
+            };
+        };
         SupplierTastingNotes: {
             /** @enum {string} */
             source: "supplier";
@@ -4932,6 +5355,47 @@ interface components {
                 };
             };
         };
+        InventoryTasting: {
+            inventoryId: number;
+            catalogId: number | null;
+            aroma: number;
+            body: number;
+            acidity: number;
+            sweetness: number;
+            aftertaste: number;
+            brewMethod: string | null;
+            notes: string | null;
+            /** Format: date-time */
+            ratedAt: string;
+        };
+        TastingRateResponse: {
+            data: components["schemas"]["InventoryTasting"];
+            meta: {
+                /** @enum {string} */
+                resource: "tasting";
+                /** @enum {string} */
+                namespace: "/v1/tasting/inventory";
+                /** @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;
+                };
+            };
+        };
+        TastingRateRequest: {
+            aroma: number;
+            body: number;
+            acidity: number;
+            sweetness: number;
+            aftertaste: number;
+            brewMethod?: string;
+            notes?: string;
+        };
     };
     responses: never;
     parameters: never;
@@ -5019,8 +5483,14 @@ type RoastImportRequest = NonNullable<paths["/v1/roasts/imports"]["post"]["reque
 type RoastArtisanImportReplaceRequest = NonNullable<paths["/v1/roasts/{id}/artisan-import"]["put"]["requestBody"]>["content"]["application/json"];
 /** Query parameters for {@link ParchmentClient.sales.list}. */
 type SalesListQuery = NonNullable<paths["/v1/sales"]["get"]["parameters"]["query"]>;
+/** Request body for {@link ParchmentClient.sales.create}. */
+type SalesCreateRequest = NonNullable<paths["/v1/sales"]["post"]["requestBody"]>["content"]["application/json"];
+/** Request body for {@link ParchmentClient.sales.update}. */
+type SalesUpdateRequest = NonNullable<paths["/v1/sales/{id}"]["patch"]["requestBody"]>["content"]["application/json"];
 /** Query parameters for {@link ParchmentClient.tasting.get}. */
 type TastingGetQuery = NonNullable<paths["/v1/tasting/{catalogId}"]["get"]["parameters"]["query"]>;
+/** Request body for {@link ParchmentClient.tasting.rate}. */
+type TastingRateRequest = NonNullable<paths["/v1/tasting/inventory/{inventoryId}"]["put"]["requestBody"]>["content"]["application/json"];
 /** Request body for {@link ParchmentClient.apiKeys.create}. */
 type ApiKeyCreateRequest = NonNullable<paths["/v1/api-keys"]["post"]["requestBody"]>["content"]["application/json"];
 /**
@@ -5241,7 +5711,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 content: {
                     "application/json": {
                         name: string;
-                        scopes?: ("catalog:read" | "inventory:read" | "roast:read" | "sales:read" | "tasting:read" | "inventory:write" | "roast:write")[];
+                        scopes?: ("catalog:read" | "inventory:read" | "roast:read" | "sales:read" | "tasting:read" | "inventory:write" | "roast:write" | "sales:write" | "tasting:write")[];
                     };
                 };
             };
@@ -5291,14 +5761,14 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"] /** Rotate an API key and return the replacement secret once. */["ErrorResponse"];
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
             };
         }, {
             body: {
                 name: string;
-                scopes?: ("catalog:read" | "inventory:read" | "roast:read" | "sales:read" | "tasting:read" | "inventory:write" | "roast:write")[];
+                scopes?: ("catalog:read" | "inventory:read" | "roast:read" | "sales:read" | "tasting:read" | "inventory:write" | "roast:write" | "sales:write" | "tasting:write")[];
             };
         }, `${string}/${string}`>>;
         /** Revoke an API key owned by the authenticated session user. */
@@ -5547,9 +6017,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     pricePerLbMax?: number | null;
                     processing_base_method?: string;
                     fermentation_type?: string;
-                    process_additive
-                    /** Fetch supplier notes plus the caller's own latest tasting notes. */
-                    ? /** Fetch supplier notes plus the caller's own latest tasting notes. */: string;
+                    process_additive?: string;
                     has_additives?: "true" | "false";
                     processing_disclosure_level?: string;
                     processing_confidence_min?: number | null;
@@ -6743,78 +7211,434 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         page?: number;
                         limit?: number;
                     };
-                    header?: never;
-                    path: {
-                        id: string;
+                    header?: never;
+                    path: {
+                        id: string;
+                    };
+                    cookie?: never;
+                };
+                requestBody?: never;
+                responses: {
+                    200: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["SourcingBriefMatchesResponse"];
+                        };
+                    };
+                    400: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    401: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    403: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    404: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                };
+            }, {
+                params: {
+                    path: {
+                        id: string;
+                    };
+                    query: {
+                        page?: number;
+                        limit?: number;
+                    } | undefined;
+                };
+            }, `${string}/${string}`>>;
+        };
+    };
+    inventory: {
+        /** List the caller's own green-coffee inventory (owner-scoped). */
+        list: (query?: InventoryListQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    stocked_only?: boolean | null;
+                    catalogId?: number;
+                    purchaseDateStart?: string;
+                    purchaseDateEnd?: string;
+                    origin?: string;
+                    limit?: number;
+                    offset?: number | null;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["InventoryListResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                query: {
+                    stocked_only?: boolean | null;
+                    catalogId?: number;
+                    purchaseDateStart?: string;
+                    purchaseDateEnd?: string;
+                    origin?: string;
+                    limit?: number;
+                    offset?: number | null;
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+        /**
+         * Create an owner inventory lot. Requires a session or an owner-bound API
+         * key carrying the exact `inventory:write` scope. Pass `idempotencyKey`
+         * to make retries safe: the same key replays the original result, and a
+         * concurrent duplicate gets 409 while the first is in flight.
+         */
+        create: (body: InventoryCreateRequest, options?: {
+            idempotencyKey?: string;
+        }) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: {
+                    "idempotency-key"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["InventoryCreateRequest"];
+                };
+            };
+            responses: {
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["InventoryItemResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+                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: {
+                catalogId: number;
+                qty: number;
+                purchaseDate?: string;
+                cost?: number;
+                taxShip?: number;
+                notes?: string;
+            };
+            params: {
+                header: {
+                    "idempotency-key": string;
+                };
+            } | undefined;
+        }, `${string}/${string}`>>;
+        /**
+         * Update one of the caller's own inventory rows. Pass `ifMatch` (the
+         * row's `last_updated`) to enable optimistic concurrency (409 on mismatch).
+         */
+        update: (id: number, body: InventoryUpdateRequest, 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"]["InventoryUpdateRequest"];
+                };
+            };
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["InventoryItemResponse"];
+                    };
+                };
+                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: {
+                qty?: number;
+                cost?: number;
+                taxShip?: number;
+                notes?: string;
+                stocked?: boolean;
+            };
+        }, `${string}/${string}`>>;
+        /**
+         * Delete one of the caller's own inventory rows. Returns 409 if dependent
+         * roast profiles or sales exist (no force-cascade).
+         */
+        delete: (id: number) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["InventoryDeleteResponse"];
+                    };
+                };
+                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"];
                     };
-                    cookie?: never;
                 };
-                requestBody?: never;
-                responses: {
-                    200: {
-                        headers: {
-                            [name: string]: unknown;
-                        };
-                        content: {
-                            "application/json": components["schemas"]["SourcingBriefMatchesResponse"];
-                        };
-                    };
-                    400: {
-                        headers: {
-                            [name: string]: unknown;
-                        };
-                        content: {
-                            "application/json": components["schemas"]["ErrorResponse"];
-                        };
+                429: {
+                    headers: {
+                        [name: string]: unknown;
                     };
-                    401: {
-                        headers: {
-                            [name: string]: unknown;
-                        };
-                        content: {
-                            "application/json": components["schemas"]["ErrorResponse"];
-                        };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
-                    403: {
-                        headers: {
-                            [name: string]: unknown;
-                        };
-                        content: {
-                            "application/json": components["schemas"]["ErrorResponse"];
-                        };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
                     };
-                    404: {
-                        headers: {
-                            [name: string]: unknown;
-                        };
-                        content: {
-                            "application/json": components["schemas"]["ErrorResponse"];
-                        };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-            }, {
-                params: {
-                    path: {
-                        id: string;
-                    };
-                    query: {
-                        page?: number;
-                        limit?: number;
-                    } | undefined;
+            };
+        }, {
+            params: {
+                path: {
+                    id: number;
                 };
-            }, `${string}/${string}`>>;
-        };
+            };
+        }, `${string}/${string}`>>;
     };
-    inventory: {
-        /** List the caller's own green-coffee inventory (owner-scoped). */
-        list: (query?: InventoryListQuery) => Promise<openapi_fetch.FetchResponse<{
+    roasts: {
+        /** List the caller's own roast profiles (owner-scoped). */
+        list: (query?: RoastListQuery) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: {
+                    coffee_id?: number;
+                    roast_id?: number;
+                    batch_name?: string;
+                    coffee_name?: string;
+                    date_start?: string;
+                    date_end?: string;
                     stocked_only?: boolean | null;
-                    catalogId?: number;
-                    purchaseDateStart?: string;
-                    purchaseDateEnd?: string;
-                    origin?: string;
+                    catalog_id?: number;
                     limit?: number;
                     offset?: number | null;
                 };
@@ -6829,7 +7653,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["InventoryListResponse"];
+                        "application/json": components["schemas"]["RoastListResponse"];
                     };
                 };
                 400: {
@@ -6860,23 +7684,95 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
         }, {
             params: {
                 query: {
+                    coffee_id?: number;
+                    roast_id?: number;
+                    batch_name?: string;
+                    coffee_name?: string;
+                    date_start?: string;
+                    date_end?: string;
                     stocked_only?: boolean | null;
-                    catalogId?: number;
-                    purchaseDateStart?: string;
-                    purchaseDateEnd?: string;
-                    origin?: string;
+                    catalog_id?: number;
                     limit?: number;
                     offset?: number | null;
                 } | undefined;
             };
         }, `${string}/${string}`>>;
         /**
-         * Create an owner inventory lot. Requires a session or an owner-bound API
-         * key carrying the exact `inventory:write` scope. Pass `idempotencyKey`
-         * to make retries safe: the same key replays the original result, and a
-         * concurrent duplicate gets 409 while the first is in flight.
+         * Fetch one of the caller's roast profiles by id, optionally with its
+         * temperature curve (`includeTemps`) and event markers (`includeEvents`).
          */
-        create: (body: InventoryCreateRequest, options?: {
+        get: (id: string, query?: RoastGetQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    includeTemps?: boolean | null;
+                    includeEvents?: boolean | null;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            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"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                path: {
+                    id: string;
+                };
+                query: {
+                    includeTemps?: boolean | null;
+                    includeEvents?: boolean | null;
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+        /**
+         * Create an owner roast profile, optionally with nested temperature/event
+         * rows. Requires a session or an owner-bound API key carrying the exact
+         * `roast:write` scope. Pass `idempotencyKey` to make retries safe.
+         */
+        create: (body: RoastCreateRequest, options?: {
             idempotencyKey?: string;
         }) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
@@ -6887,9 +7783,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: {
+            requestBody: {
                 content: {
-                    "application/json": components["schemas"]["InventoryCreateRequest"];
+                    "application/json": components["schemas"]["RoastCreateRequest"];
                 };
             };
             responses: {
@@ -6898,7 +7794,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["InventoryItemResponse"];
+                        "application/json": components["schemas"]["RoastDetailResponse"];
                     };
                 };
                 400: {
@@ -6925,6 +7821,14 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -6952,12 +7856,42 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             };
         }, {
             body: {
-                catalogId: number;
-                qty: number;
-                purchaseDate?: string;
-                cost?: number;
-                taxShip?: number;
+                coffeeId: number;
+                coffeeName?: string;
+                batchName?: string;
+                roastDate?: string;
+                ozIn?: number;
+                ozOut?: number;
+                weightLossPercent?: number;
                 notes?: string;
+                targets?: string;
+                roasterType?: string;
+                roasterSize?: string;
+                temperatureUnit?: "F" | "C";
+                totalRoastTime?: number;
+                developmentPercent?: number;
+                dataSource?: string;
+                roastUuid?: string;
+                fcStartTime?: number;
+                fcStartTemp?: number;
+                fcEndTime?: number;
+                fcEndTemp?: number;
+                dropTime?: number;
+                dropTemp?: number;
+                chargeTemp?: number;
+                chargeTime?: number;
+                tpTime?: number;
+                tpTemp?: number;
+                totalRor?: number;
+                dryPercent?: number;
+                maillardPercent?: number;
+                auc?: number;
+                dryPhaseRor?: number;
+                midPhaseRor?: number;
+                finishPhaseRor?: number;
+                dryPhaseDeltaTemp?: number;
+                temperatures?: components["schemas"]["RoastTemperatureInput"][];
+                events?: components["schemas"]["RoastEventInput"][];
             };
             params: {
                 header: {
@@ -6966,10 +7900,10 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             } | undefined;
         }, `${string}/${string}`>>;
         /**
-         * Update one of the caller's own inventory rows. Pass `ifMatch` (the
+         * Update one of the caller's own roast profiles. Pass `ifMatch` (the
          * row's `last_updated`) to enable optimistic concurrency (409 on mismatch).
          */
-        update: (id: number, body: InventoryUpdateRequest, options?: {
+        update: (id: number, body: RoastUpdateRequest, options?: {
             ifMatch?: string;
         }) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
@@ -6982,9 +7916,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
                 cookie?: never;
             };
-            requestBody?: {
+            requestBody: {
                 content: {
-                    "application/json": components["schemas"]["InventoryUpdateRequest"];
+                    "application/json": components["schemas"]["RoastUpdateRequest"];
                 };
             };
             responses: {
@@ -6993,7 +7927,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["InventoryItemResponse"];
+                        "application/json": components["schemas"]["RoastDetailResponse"];
                     };
                 };
                 400: {
@@ -7063,17 +7997,44 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 } | undefined;
             };
             body: {
-                qty?: number;
-                cost?: number;
-                taxShip?: number;
+                coffeeName?: string;
+                batchName?: string;
+                roastDate?: string;
+                ozIn?: number;
+                ozOut?: number;
+                weightLossPercent?: number;
                 notes?: string;
-                stocked?: boolean;
+                targets?: string;
+                roasterType?: string;
+                roasterSize?: string;
+                temperatureUnit?: "F" | "C";
+                totalRoastTime?: number;
+                developmentPercent?: number;
+                dataSource?: string;
+                roastUuid?: string;
+                fcStartTime?: number;
+                fcStartTemp?: number;
+                fcEndTime?: number;
+                fcEndTemp?: number;
+                dropTime?: number;
+                dropTemp?: number;
+                chargeTemp?: number;
+                chargeTime?: number;
+                tpTime?: number;
+                tpTemp?: number;
+                totalRor?: number;
+                dryPercent?: number;
+                maillardPercent?: number;
+                auc?: number;
+                dryPhaseRor?: number;
+                midPhaseRor?: number;
+                finishPhaseRor?: number;
+                dryPhaseDeltaTemp?: number;
+                temperatures?: components["schemas"]["RoastTemperatureInput"][];
+                events?: components["schemas"]["RoastEventInput"][];
             };
         }, `${string}/${string}`>>;
-        /**
-         * Delete one of the caller's own inventory rows. Returns 409 if dependent
-         * roast profiles or sales exist (no force-cascade).
-         */
+        /** Delete one of the caller's own roast profiles. */
         delete: (id: number) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
@@ -7090,7 +8051,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["InventoryDeleteResponse"];
+                        "application/json": components["schemas"]["RoastDeleteResponse"];
                     };
                 };
                 400: {
@@ -7125,14 +8086,6 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
                 429: {
                     headers: {
                         [name: string]: unknown;
@@ -7157,35 +8110,36 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
             };
         }, `${string}/${string}`>>;
-    };
-    roasts: {
-        /** List the caller's own roast profiles (owner-scoped). */
-        list: (query?: RoastListQuery) => Promise<openapi_fetch.FetchResponse<{
+        /**
+         * Create a roast profile from an Artisan `.alog` file against one of the
+         * caller's green-coffee lots, persisting the imported curve, events, and
+         * an artisan_import_log entry atomically. Requires a session or an
+         * owner-bound API key carrying the exact `roast:write` scope. Pass
+         * `idempotencyKey` to make retries safe.
+         */
+        import: (body: RoastImportRequest, options?: {
+            idempotencyKey?: string;
+        }) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
-                query?: {
-                    coffee_id?: number;
-                    roast_id?: number;
-                    batch_name?: string;
-                    coffee_name?: string;
-                    date_start?: string;
-                    date_end?: string;
-                    stocked_only?: boolean | null;
-                    catalog_id?: number;
-                    limit?: number;
-                    offset?: number | null;
+                query?: never;
+                header?: {
+                    "idempotency-key"?: string;
                 };
-                header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["RoastImportCreateRequest"];
+                };
+            };
             responses: {
-                200: {
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RoastListResponse"];
+                        "application/json": components["schemas"]["RoastImportResponse"];
                     };
                 };
                 400: {
@@ -7212,50 +8166,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-            };
-        }, {
-            params: {
-                query: {
-                    coffee_id?: number;
-                    roast_id?: number;
-                    batch_name?: string;
-                    coffee_name?: string;
-                    date_start?: string;
-                    date_end?: string;
-                    stocked_only?: boolean | null;
-                    catalog_id?: number;
-                    limit?: number;
-                    offset?: number | null;
-                } | undefined;
-            };
-        }, `${string}/${string}`>>;
-        /**
-         * Fetch one of the caller's roast profiles by id, optionally with its
-         * temperature curve (`includeTemps`) and event markers (`includeEvents`).
-         */
-        get: (id: string, query?: RoastGetQuery) => Promise<openapi_fetch.FetchResponse<{
-            parameters: {
-                query?: {
-                    includeTemps?: boolean | null;
-                    includeEvents?: boolean | null;
-                };
-                header?: never;
-                path: {
-                    id: string;
-                };
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["RoastDetailResponse"];
-                    };
-                };
-                400: {
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -7263,7 +8174,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                401: {
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -7271,7 +8182,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                403: {
+                429: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -7279,7 +8190,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                404: {
+                503: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -7289,44 +8200,53 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
             };
         }, {
+            body: {
+                fileName: string;
+                fileContent: string;
+                coffeeId: number;
+                batchName?: string;
+                ozIn?: number;
+                roastNotes?: string;
+                roastTargets?: string;
+                fileSize?: number;
+            };
             params: {
-                path: {
-                    id: string;
+                header: {
+                    "idempotency-key": string;
                 };
-                query: {
-                    includeTemps?: boolean | null;
-                    includeEvents?: boolean | null;
-                } | undefined;
-            };
+            } | undefined;
         }, `${string}/${string}`>>;
         /**
-         * Create an owner roast profile, optionally with nested temperature/event
-         * rows. Requires a session or an owner-bound API key carrying the exact
-         * `roast:write` scope. Pass `idempotencyKey` to make retries safe.
+         * Replace the Artisan import data on one of the caller's existing roasts,
+         * re-deriving its curve, events, and computed metrics while preserving the
+         * roast's identity. Pass `ifMatch` (the roast's `last_updated`) to enable
+         * optimistic concurrency (409 on mismatch).
          */
-        create: (body: RoastCreateRequest, options?: {
-            idempotencyKey?: string;
+        replaceArtisanImport: (id: number, body: RoastArtisanImportReplaceRequest, options?: {
+            ifMatch?: string;
         }) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
                 header?: {
-                    "idempotency-key"?: string;
+                    "if-match"?: string;
+                };
+                path: {
+                    id: number;
                 };
-                path?: never;
                 cookie?: never;
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["RoastCreateRequest"];
+                    "application/json": components["schemas"]["RoastArtisanImportReplaceRequest"];
                 };
             };
             responses: {
-                201: {
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RoastDetailResponse"];
+                        "application/json": components["schemas"]["RoastImportResponse"];
                     };
                 };
                 400: {
@@ -7387,87 +8307,41 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
             };
         }, {
-            body: {
-                coffeeId: number;
-                coffeeName?: string;
-                batchName?: string;
-                roastDate?: string;
-                ozIn?: number;
-                ozOut?: number;
-                weightLossPercent?: number;
-                notes?: string;
-                targets?: string;
-                roasterType?: string;
-                roasterSize?: string;
-                temperatureUnit?: "F" | "C";
-                totalRoastTime?: number;
-                developmentPercent?: number;
-                dataSource?: string;
-                roastUuid?: string;
-                fcStartTime?: number;
-                fcStartTemp?: number;
-                fcEndTime?: number;
-                fcEndTemp?: number;
-                dropTime?: number;
-                dropTemp?: number;
-                chargeTemp?: number;
-                chargeTime?: number;
-                tpTime?: number;
-                tpTemp?: number;
-                totalRor?: number;
-                dryPercent?: number;
-                maillardPercent?: number;
-                auc?: number;
-                dryPhaseRor?: number;
-                midPhaseRor?: number;
-                finishPhaseRor?: number;
-                dryPhaseDeltaTemp?: number;
-                temperatures?: components["schemas"]["RoastTemperatureInput"][];
-                events?: components["schemas"]["RoastEventInput"][];
-            };
             params: {
-                header: {
-                    "idempotency-key": string;
+                path: {
+                    id: number;
                 };
-            } | undefined;
+                header: {
+                    "if-match": string;
+                } | undefined;
+            };
+            body: {
+                fileName: string;
+                fileContent: string;
+                fileSize?: number;
+            };
         }, `${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).
+         * Clear import-derived curve, events, metrics, and provenance data from
+         * one of the caller's existing roasts without deleting the roast profile.
          */
-        update: (id: number, body: RoastUpdateRequest, options?: {
-            ifMatch?: string;
-        }) => Promise<openapi_fetch.FetchResponse<{
+        clearArtisanImport: (id: number) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
-                header?: {
-                    "if-match"?: string;
-                };
+                header?: never;
                 path: {
                     id: number;
                 };
                 cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["RoastUpdateRequest"];
-                };
-            };
-            responses: {
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["RoastDetailResponse"];
-                    };
-                };
-                400: {
+            };
+            requestBody?: never;
+            responses: {
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"]["RoastArtisanImportClearResponse"];
                     };
                 };
                 401: {
@@ -7494,14 +8368,6 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
                 429: {
                     headers: {
                         [name: string]: unknown;
@@ -7524,56 +8390,23 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 path: {
                     id: number;
                 };
-                header: {
-                    "if-match": string;
-                } | undefined;
-            };
-            body: {
-                coffeeName?: string;
-                batchName?: string;
-                roastDate?: string;
-                ozIn?: number;
-                ozOut?: number;
-                weightLossPercent?: number;
-                notes?: string;
-                targets?: string;
-                roasterType?: string;
-                roasterSize?: string;
-                temperatureUnit?: "F" | "C";
-                totalRoastTime?: number;
-                developmentPercent?: number;
-                dataSource?: string;
-                roastUuid?: string;
-                fcStartTime?: number;
-                fcStartTemp?: number;
-                fcEndTime?: number;
-                fcEndTemp?: number;
-                dropTime?: number;
-                dropTemp?: number;
-                chargeTemp?: number;
-                chargeTime?: number;
-                tpTime?: number;
-                tpTemp?: number;
-                totalRor?: number;
-                dryPercent?: number;
-                maillardPercent?: number;
-                auc?: number;
-                dryPhaseRor?: number;
-                midPhaseRor?: number;
-                finishPhaseRor?: number;
-                dryPhaseDeltaTemp?: number;
-                temperatures?: components["schemas"]["RoastTemperatureInput"][];
-                events?: components["schemas"]["RoastEventInput"][];
             };
         }, `${string}/${string}`>>;
-        /** Delete one of the caller's own roast profiles. */
-        delete: (id: number) => Promise<openapi_fetch.FetchResponse<{
+    };
+    sales: {
+        /** List the caller's own sales (owner-scoped). */
+        list: (query?: SalesListQuery) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    id: number;
+                query?: {
+                    green_coffee_inv_id?: number;
+                    date_start?: string;
+                    date_end?: string;
+                    buyer?: string;
+                    limit?: number;
+                    offset?: number | null;
                 };
+                header?: never;
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
@@ -7583,7 +8416,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RoastDeleteResponse"];
+                        "application/json": components["schemas"]["SalesListResponse"];
                     };
                 };
                 400: {
@@ -7610,46 +8443,27 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "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: {
-                    id: number;
-                };
+                query: {
+                    green_coffee_inv_id?: number;
+                    date_start?: string;
+                    date_end?: string;
+                    buyer?: string;
+                    limit?: number;
+                    offset?: number | null;
+                } | undefined;
             };
         }, `${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
-         * an artisan_import_log entry atomically. Requires a session or an
-         * owner-bound API key carrying the exact `roast:write` scope. Pass
-         * `idempotencyKey` to make retries safe.
+         * Record a sale against one of the caller's own green-coffee inventory
+         * lots. Requires a session or an owner-bound API key carrying the exact
+         * `sales:write` scope. Pass `idempotencyKey` to make retries safe: the
+         * same key replays the original result, and a concurrent duplicate gets
+         * 409 while the first is in flight.
          */
-        import: (body: RoastImportRequest, options?: {
+        create: (body: SalesCreateRequest, options?: {
             idempotencyKey?: string;
         }) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
@@ -7660,9 +8474,9 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 path?: never;
                 cookie?: never;
             };
-            requestBody: {
+            requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["RoastImportCreateRequest"];
+                    "application/json": components["schemas"]["SalesCreateRequest"];
                 };
             };
             responses: {
@@ -7671,7 +8485,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RoastImportResponse"];
+                        "application/json": components["schemas"]["SaleItemResponse"];
                     };
                 };
                 400: {
@@ -7698,14 +8512,6 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -7733,14 +8539,12 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             };
         }, {
             body: {
-                fileName: string;
-                fileContent: string;
-                coffeeId: number;
+                greenCoffeeInvId: number;
+                ozSold: number;
+                price: number;
+                buyer?: string;
                 batchName?: string;
-                ozIn?: number;
-                roastNotes?: string;
-                roastTargets?: string;
-                fileSize?: number;
+                sellDate?: string;
             };
             params: {
                 header: {
@@ -7749,27 +8553,22 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             } | undefined;
         }, `${string}/${string}`>>;
         /**
-         * Replace the Artisan import data on one of the caller's existing roasts,
-         * re-deriving its curve, events, and computed metrics while preserving the
-         * roast's identity. Pass `ifMatch` (the roast's `last_updated`) to enable
-         * optimistic concurrency (409 on mismatch).
+         * Update one of the caller's own sales. The sales table carries no
+         * `last_updated` column, so no If-Match optimistic concurrency is
+         * offered.
          */
-        replaceArtisanImport: (id: number, body: RoastArtisanImportReplaceRequest, options?: {
-            ifMatch?: string;
-        }) => Promise<openapi_fetch.FetchResponse<{
+        update: (id: number, body: SalesUpdateRequest) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
-                header?: {
-                    "if-match"?: string;
-                };
+                header?: never;
                 path: {
                     id: number;
                 };
                 cookie?: never;
             };
-            requestBody: {
+            requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["RoastArtisanImportReplaceRequest"];
+                    "application/json": components["schemas"]["SalesUpdateRequest"];
                 };
             };
             responses: {
@@ -7778,7 +8577,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RoastImportResponse"];
+                        "application/json": components["schemas"]["SaleItemResponse"];
                     };
                 };
                 400: {
@@ -7813,14 +8612,6 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
                 429: {
                     headers: {
                         [name: string]: unknown;
@@ -7843,21 +8634,17 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 path: {
                     id: number;
                 };
-                header: {
-                    "if-match": string;
-                } | undefined;
             };
             body: {
-                fileName: string;
-                fileContent: string;
-                fileSize?: number;
+                ozSold?: number;
+                price?: number;
+                buyer?: string;
+                batchName?: string;
+                sellDate?: string;
             };
         }, `${string}/${string}`>>;
-        /**
-         * Clear import-derived curve, events, metrics, and provenance data from
-         * one of the caller's existing roasts without deleting the roast profile.
-         */
-        clearArtisanImport: (id: number) => Promise<openapi_fetch.FetchResponse<{
+        /** Delete one of the caller's own sales. */
+        delete: (id: number) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
                 header?: never;
@@ -7873,7 +8660,15 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["RoastArtisanImportClearResponse"];
+                        "application/json": components["schemas"]["SaleDeleteResponse"];
+                    };
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
                 401: {
@@ -7925,20 +8720,17 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             };
         }, `${string}/${string}`>>;
     };
-    sales: {
-        /** List the caller's own sales (owner-scoped). */
-        list: (query?: SalesListQuery) => Promise<openapi_fetch.FetchResponse<{
+    tasting: {
+        /** Fetch supplier notes plus the caller's own latest tasting notes. */
+        get: (catalogId: string, query?: TastingGetQuery) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: {
-                    green_coffee_inv_id?: number;
-                    date_start?: string;
-                    date_end?: string;
-                    buyer?: string;
-                    limit?: number;
-                    offset?: number | null;
+                    filter?: "user" | "supplier" | "both";
                 };
                 header?: never;
-                path?: never;
+                path: {
+                    catalogId: string;
+                };
                 cookie?: never;
             };
             requestBody?: never;
@@ -7948,7 +8740,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["SalesListResponse"];
+                        "application/json": components["schemas"]["TastingResponse"];
                     };
                 };
                 400: {
@@ -7975,41 +8767,47 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
             };
         }, {
             params: {
+                path: {
+                    catalogId: string;
+                };
                 query: {
-                    green_coffee_inv_id?: number;
-                    date_start?: string;
-                    date_end?: string;
-                    buyer?: string;
-                    limit?: number;
-                    offset?: number | null;
+                    filter?: "user" | "supplier" | "both";
                 } | undefined;
             };
         }, `${string}/${string}`>>;
-    };
-    tasting: {
-        /** Fetch supplier notes plus the caller's own latest tasting notes. */
-        get: (catalogId: string, query?: TastingGetQuery) => Promise<openapi_fetch.FetchResponse<{
+        /** Replace the caller's rating for one owned inventory lot. */
+        rate: (inventoryId: number, body: TastingRateRequest) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
-                query?: {
-                    filter?: "user" | "supplier" | "both";
-                };
+                query?: never;
                 header?: never;
                 path: {
-                    catalogId: string;
+                    inventoryId: number;
                 };
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["TastingRateRequest"];
+                };
+            };
             responses: {
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["TastingResponse"];
+                        "application/json": components["schemas"]["TastingRateResponse"];
                     };
                 };
                 400: {
@@ -8044,19 +8842,41 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "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: {
-                    catalogId: string;
+                    inventoryId: number;
                 };
-                query: {
-                    filter?: "user" | "supplier" | "both";
-                } | undefined;
+            };
+            body: {
+                aroma: number;
+                body: number;
+                acidity: number;
+                sweetness: number;
+                aftertaste: number;
+                brewMethod?: string;
+                notes?: string;
             };
         }, `${string}/${string}`>>;
     };
 };
 type ParchmentClient = ReturnType<typeof createParchmentClient>;
 
-export { type BriefMatchesQuery, type CatalogListQuery, type CatalogSimilarQuery, type InventoryCreateRequest, type InventoryUpdateRequest, type MarketSignalsQuery, type MetadataIndexQuery, type ParchmentClient, type ParchmentClientOptions, type PriceIndexQuery, type PriceIndexStatsQuery, type SourcingBriefCreateRequest, type components, createParchmentClient, type paths };
+export { type BriefMatchesQuery, type CatalogListQuery, type CatalogSimilarQuery, type InventoryCreateRequest, type InventoryUpdateRequest, type MarketSignalsQuery, type MetadataIndexQuery, type ParchmentClient, type ParchmentClientOptions, type PriceIndexQuery, type PriceIndexStatsQuery, type SalesCreateRequest, type SalesListQuery, type SalesUpdateRequest, type SourcingBriefCreateRequest, type components, createParchmentClient, type paths };