@purveyors/sdk 0.15.0 → 0.17.0

package/dist/index.d.ts

@@ -268,6 +268,84 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/api-usage": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read the session owner's API-key traffic analytics
+         * @description Returns bounded API-key traffic summaries, a UTC daily series, recent per-key requests, and canonical per-key plan request limits. This key-centric compatibility resource excludes session traffic and is not account billing usage. Query validation runs before endpoint authorization, so malformed queries return the documented 400 envelope even for unauthenticated callers.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    days?: number;
+                    recentPerKey?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Bounded owner API-key traffic analytics */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["OwnerApiUsageResponse"];
+                    };
+                };
+                /** @description Invalid analytics window */
+                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 usage storage is unavailable */
+                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/api-keys/{id}": {
         parameters: {
             query?: never;
@@ -434,6 +512,151 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/email-subscriptions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the session user's Market Read email preference
+         * @description Returns an unsubscribed default when the account has no stored preference. This endpoint accepts session principals only.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The account's Market Read email preference */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["EmailSubscriptionResponse"];
+                    };
+                };
+                /** @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 Email preference storage is unavailable */
+                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/email-subscriptions/market-read": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Set the session user's Market Read email preference
+         * @description Idempotently subscribes or unsubscribes the account. Delivery-provider state is outside this preference contract. This endpoint accepts session principals only.
+         */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["MarketReadPreferenceInput"];
+                };
+            };
+            responses: {
+                /** @description The resulting Market Read email preference */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["EmailSubscriptionResponse"];
+                    };
+                };
+                /** @description Invalid preference input */
+                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 Email preference storage is unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/cli-auth/requests": {
         parameters: {
             query?: never;
@@ -1599,6 +1822,7 @@ interface paths {
                     from?: string;
                     to?: string;
                     wholesale?: "true" | "false";
+                    aggregationTier?: number;
                     order?: "asc" | "desc";
                 };
                 header?: never;
@@ -1616,6 +1840,15 @@ interface paths {
                         "application/json": components["schemas"]["PriceIndexResponse"];
                     };
                 };
+                /** @description Invalid price-index query */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
                 /** @description Authentication required */
                 401: {
                     headers: {
@@ -2504,7 +2737,7 @@ interface paths {
         put?: never;
         /**
          * Create an owner inventory item
-         * @description Create a green-coffee inventory lot owned by the authenticated principal. Requires an authenticated session, or an owner-bound API key carrying the exact inventory:write scope.
+         * @description Create a green-coffee inventory lot owned by the authenticated principal. Supply either an existing catalogId or a manualCoffee object. Manual coffees require Idempotency-Key and are stored as real owner-private coffee_catalog rows (public_coffee=false) linked atomically to the new inventory row. Requires an authenticated session, or an owner-bound API key carrying the exact inventory:write scope.
          */
         post: {
             parameters: {
@@ -4153,6 +4386,91 @@ interface components {
                 message: string;
             };
         };
+        OwnerApiUsageDailySummary: {
+            /** Format: date */
+            date: string;
+            totalRequests: number;
+            successRequests: number;
+            errorRequests: number;
+            pendingRequests: number;
+            averageResponseTimeMs: number;
+        };
+        OwnerApiUsageRecord: {
+            endpoint: string;
+            /** Format: date-time */
+            timestamp: string | null;
+            statusCode: number | null;
+            responseTimeMs: number | null;
+        };
+        OwnerApiKeyTrafficSummary: {
+            /** Format: uuid */
+            id: string;
+            name: string;
+            /** Format: date-time */
+            createdAt: string | null;
+            /** Format: date-time */
+            lastUsedAt: string | null;
+            isActive: boolean;
+            scopes: string[];
+            /** @description Exact current UTC calendar-month requests for this API key, inclusive of pending reservations. */
+            monthlyRequests: number;
+            windowRequests: number;
+            successRequests: number;
+            errorRequests: number;
+            pendingRequests: number;
+            averageResponseTimeMs: number;
+            /** @description True when the bounded global series reached its record limit, so this key's window summary must be treated as a lower bound. */
+            windowTruncated: boolean;
+            recent: components["schemas"]["OwnerApiUsageRecord"][];
+        };
+        OwnerApiUsageResponse: {
+            /**
+             * @description This resource reports only traffic metered through the owner's API keys; it excludes session traffic and is not billing/account usage.
+             * @enum {string}
+             */
+            kind: "owner_api_key_traffic";
+            /** Format: date-time */
+            generatedAt: string;
+            window: {
+                /** Format: date-time */
+                from: string;
+                /** Format: date-time */
+                to: string;
+                days: number;
+                recordsReturned: number;
+                /** @enum {number} */
+                recordLimit: 20000;
+                truncated: boolean;
+                /**
+                 * @description Coverage of the daily and per-key window series. Monthly/hourly summary counts remain exact database counts.
+                 * @enum {string}
+                 */
+                seriesCoverage: "complete" | "truncated";
+            };
+            plan: {
+                /** @enum {string} */
+                id: "viewer" | "member" | "enterprise";
+                monthlyRequestLimitPerKey: number;
+                /** @enum {string} */
+                limitScope: "api_key";
+                unlimited: boolean;
+            };
+            summary: {
+                /** @description Exact aggregate owner API-key traffic for the current UTC calendar month. This is not compared with the per-key request limit. */
+                monthlyRequests: number;
+                hourlyRequests: number;
+                totalKeys: number;
+                activeKeys: number;
+            };
+            daily: components["schemas"]["OwnerApiUsageDailySummary"][];
+            keys: components["schemas"]["OwnerApiKeyTrafficSummary"][];
+            bounds: {
+                /** @enum {number} */
+                keyLimit: 100;
+                keysTruncated: boolean;
+                recentPerKey: number;
+            };
+        };
         ApiKeyCreateResponse: {
             /** @description Raw API key. Returned only once; store the secret client-side. */
             apiKey: string;
@@ -4161,6 +4479,35 @@ interface components {
         ApiKeyMutationResponse: {
             key: components["schemas"]["ApiKeyRecord"];
         };
+        EmailSubscriptionPreference: {
+            /** @enum {string} */
+            publication: "market_read";
+            /** @enum {string} */
+            status: "subscribed" | "unsubscribed";
+            subscribed: boolean;
+            /** @enum {string|null} */
+            consentSource: "account_settings" | "signup" | null;
+            /** Format: date-time */
+            consentedAt: string | null;
+            /** Format: date-time */
+            unsubscribedAt: string | null;
+            /** Format: date-time */
+            createdAt: string | null;
+            /** Format: date-time */
+            updatedAt: string | null;
+        };
+        EmailSubscriptionResponse: {
+            data: components["schemas"]["EmailSubscriptionPreference"];
+        };
+        MarketReadPreferenceInput: {
+            /** @enum {boolean} */
+            subscribed: true;
+            /** @enum {string} */
+            consentSource: "account_settings" | "signup";
+        } | {
+            /** @enum {boolean} */
+            subscribed: false;
+        };
         CatalogAccessResponse: {
             visibility: {
                 isPrivilegedSession: boolean;
@@ -4877,6 +5224,7 @@ interface components {
                     from: string | null;
                     to: string | null;
                     wholesale: boolean | null;
+                    aggregationTier: number | null;
                     /** @enum {string} */
                     order: "asc" | "desc";
                 };
@@ -5578,21 +5926,62 @@ interface components {
                 };
             };
         };
-        InventoryCreateRequest: {
-            /** @description coffee_catalog.id this inventory lot is bought from. */
-            catalogId: number;
+        CatalogInventoryCreateRequest: {
             /** @description Purchased quantity in pounds. */
             qty: number;
             /** @description Purchase date (YYYY-MM-DD); defaults to today (UTC). */
             purchaseDate?: string;
-            /** @description Bean cost (per the CLU convention). */
+            /** @description Total bean cost for this inventory lot. */
             cost?: number;
             /** @description Tax and shipping cost. */
             taxShip?: number;
             notes?: string;
+            /** @description Existing coffee_catalog.id this inventory lot is bought from. */
+            catalogId: number;
+            /** @enum {string} */
+            manualCoffee?: never;
         };
-        InventoryUpdateRequest: {
-            qty?: number;
+        /** @description Owner-private catalog coffee to create atomically with the inventory lot. The API always stores public_coffee=false and binds coffee_user to the authenticated owner. */
+        ManualCoffeeCreate: {
+            name: string;
+            country?: string;
+            region?: string;
+            processing?: string;
+            dryingMethod?: string;
+            roastRecommendations?: string;
+            lotSize?: string;
+            bagSize?: string;
+            packaging?: string;
+            cultivarDetail?: string;
+            grade?: string;
+            appearance?: string;
+            shortDescription?: string;
+            farmNotes?: string;
+            type?: string;
+            longDescription?: string;
+            costPerLb?: number;
+            source?: string;
+            supplierCuppingNotes?: string;
+            arrivalDate?: string;
+            scoreValue?: number;
+        };
+        ManualInventoryCreateRequest: {
+            /** @description Purchased quantity in pounds. */
+            qty: number;
+            /** @description Purchase date (YYYY-MM-DD); defaults to today (UTC). */
+            purchaseDate?: string;
+            /** @description Total bean cost for this inventory lot. */
+            cost?: number;
+            /** @description Tax and shipping cost. */
+            taxShip?: number;
+            notes?: string;
+            /** @enum {string} */
+            catalogId?: never;
+            manualCoffee: components["schemas"]["ManualCoffeeCreate"];
+        };
+        InventoryCreateRequest: components["schemas"]["CatalogInventoryCreateRequest"] | components["schemas"]["ManualInventoryCreateRequest"];
+        InventoryUpdateRequest: {
+            qty?: number;
             cost?: number;
             taxShip?: number;
             notes?: string;
@@ -6256,6 +6645,8 @@ 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"];
+type CatalogInventoryCreateRequest = components["schemas"]["CatalogInventoryCreateRequest"];
+type ManualInventoryCreateRequest = components["schemas"]["ManualInventoryCreateRequest"];
 /** Request body for {@link ParchmentClient.inventory.update}. */
 type InventoryUpdateRequest = NonNullable<paths["/v1/inventory/{id}"]["patch"]["requestBody"]>["content"]["application/json"];
 /** Query parameters for {@link ParchmentClient.roasts.list}. */
@@ -6284,6 +6675,12 @@ type TastingGetQuery = NonNullable<paths["/v1/tasting/{catalogId}"]["get"]["para
 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"];
+/** Query parameters for the session owner's API-key traffic analytics. */
+type OwnerApiUsageQuery = NonNullable<paths["/v1/api-usage"]["get"]["parameters"]["query"]>;
+/** Bounded owner API-key traffic analytics (not session or billing usage). */
+type OwnerApiUsage = components["schemas"]["OwnerApiUsageResponse"];
+/** Request body for {@link ParchmentClient.emailSubscriptions.setMarketRead}. */
+type MarketReadPreferenceRequest = NonNullable<paths["/v1/email-subscriptions/market-read"]["put"]["requestBody"]>["content"]["application/json"];
 type CliAuthRequestCreate = NonNullable<paths["/v1/cli-auth/requests"]["post"]["requestBody"]>["content"]["application/json"];
 type CliAuthInspectRequest = NonNullable<paths["/v1/cli-auth/inspect"]["post"]["requestBody"]>["content"]["application/json"];
 type CliAuthApproveRequest = NonNullable<paths["/v1/cli-auth/approve"]["post"]["requestBody"]>["content"]["application/json"];
@@ -6599,7 +6996,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"] /** Create a signed, short-lived login request bound to a PKCE challenge. */["ErrorResponse"];
                     };
                 };
                 403: {
@@ -6703,6 +7100,228 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             };
         }, `${string}/${string}`>>;
     };
+    apiUsage: {
+        /**
+         * Read bounded API-key traffic analytics for the authenticated session
+         * owner. Headline monthly/hourly counts are exact; daily/per-key series
+         * carry explicit truncation metadata.
+         */
+        get: (query?: OwnerApiUsageQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    days?: number;
+                    recentPerKey?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["OwnerApiUsageResponse"];
+                    };
+                };
+                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: {
+                    days?: number;
+                    recentPerKey?: number;
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+    };
+    emailSubscriptions: {
+        /** Get the authenticated session user's Market Read preference. */
+        get: () => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["EmailSubscriptionResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+            };
+        }, openapi_fetch.FetchOptions<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["EmailSubscriptionResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+            };
+        }> | undefined, `${string}/${string}`>>;
+        /** Idempotently set the authenticated session user's Market Read preference. */
+        setMarketRead: (body: MarketReadPreferenceRequest) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["MarketReadPreferenceInput"];
+                };
+            };
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["EmailSubscriptionResponse"];
+                    };
+                };
+                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"] /**
+                         * Update one of the caller's own roast profiles. Pass `ifMatch` (the
+                         * row's `last_updated`) to enable optimistic concurrency (409 on mismatch).
+                         */["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            body: {
+                subscribed: true;
+                consentSource: "account_settings" | "signup";
+            } | {
+                subscribed: false;
+            };
+        }, `${string}/${string}`>>;
+    };
     cliAuth: {
         /** Create a signed, short-lived login request bound to a PKCE challenge. */
         create: (body: CliAuthRequestCreate) => Promise<openapi_fetch.FetchResponse<{
@@ -6780,7 +7399,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 query?: never;
                 header?: never;
                 path?: never;
-                cookie?: never;
+                cookie? /** Replace the caller's rating for one owned inventory lot. */: never;
             };
             requestBody: {
                 content: {
@@ -7905,6 +8524,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     from?: string;
                     to?: string;
                     wholesale?: "true" | "false";
+                    aggregationTier?: number;
                     order?: "asc" | "desc";
                 };
                 header?: never;
@@ -7921,6 +8541,14 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["PriceIndexResponse"];
                     };
                 };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
                 401: {
                     headers: {
                         [name: string]: unknown;
@@ -7949,6 +8577,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     from?: string;
                     to?: string;
                     wholesale?: "true" | "false";
+                    aggregationTier?: number;
                     order?: "asc" | "desc";
                 } | undefined;
             };
@@ -8657,99 +9286,212 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
         }, `${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.
+         * 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.
          */
-        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;
+        create: {
+            (body: ManualInventoryCreateRequest, options: {
+                idempotencyKey: string;
+            }): ReturnType<(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"]["InventoryItemResponse"];
+                        "application/json": components["schemas"]["InventoryCreateRequest"];
                     };
                 };
-                400: {
-                    headers: {
-                        [name: string]: unknown;
+                responses: {
+                    201: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["InventoryItemResponse"];
+                        };
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                    400: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
                     };
-                };
-                401: {
-                    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"];
+                        };
                     };
-                };
-                403: {
-                    headers: {
-                        [name: string]: unknown;
+                    409: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
                     };
-                    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"];
+                        };
                     };
                 };
-                409: {
-                    headers: {
-                        [name: string]: unknown;
+            }, {
+                body: {
+                    qty: number;
+                    purchaseDate?: string;
+                    cost?: number;
+                    taxShip?: number;
+                    notes?: string;
+                    catalogId: number;
+                    manualCoffee?: never;
+                } | {
+                    qty: number;
+                    purchaseDate?: string;
+                    cost?: number;
+                    taxShip?: number;
+                    notes?: string;
+                    catalogId?: never;
+                    manualCoffee: components["schemas"]["ManualCoffeeCreate"];
+                };
+                params: {
+                    header: {
+                        "idempotency-key": string;
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                } | undefined;
+            }, `${string}/${string}`>>>;
+            (body: CatalogInventoryCreateRequest, options?: {
+                idempotencyKey?: string;
+            }): ReturnType<(body: InventoryCreateRequest, options?: {
+                idempotencyKey?: string;
+            }) => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query?: never;
+                    header?: {
+                        "idempotency-key"?: string;
                     };
+                    path?: never;
+                    cookie?: never;
                 };
-                429: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
+                requestBody?: {
                     content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"]["InventoryCreateRequest"];
                     };
                 };
-                503: {
-                    headers: {
-                        [name: string]: unknown;
+                responses: {
+                    201: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["InventoryItemResponse"];
+                        };
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                    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;
+            }, {
+                body: {
+                    qty: number;
+                    purchaseDate?: string;
+                    cost?: number;
+                    taxShip?: number;
+                    notes?: string;
+                    catalogId: number;
+                    manualCoffee?: never;
+                } | {
+                    qty: number;
+                    purchaseDate?: string;
+                    cost?: number;
+                    taxShip?: number;
+                    notes?: string;
+                    catalogId?: never;
+                    manualCoffee: components["schemas"]["ManualCoffeeCreate"];
                 };
-            } | undefined;
-        }, `${string}/${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).
@@ -10277,4 +11019,4 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
 };
 type ParchmentClient = ReturnType<typeof createParchmentClient>;
 
-export { type BriefMatchesQuery, type CatalogItem, type CatalogListQuery, type CatalogProofSummary, 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 TrackedLotMutation, type TrackedLotSummary, type TrackedLotsListQuery, type components, createParchmentClient, type paths };
+export { type BriefMatchesQuery, type CatalogItem, type CatalogListQuery, type CatalogProofSummary, type CatalogSimilarQuery, type InventoryCreateRequest, type InventoryUpdateRequest, type MarketSignalsQuery, type MetadataIndexQuery, type OwnerApiUsage, type OwnerApiUsageQuery, type ParchmentClient, type ParchmentClientOptions, type PriceIndexQuery, type PriceIndexStatsQuery, type SalesCreateRequest, type SalesListQuery, type SalesUpdateRequest, type SourcingBriefCreateRequest, type TrackedLotMutation, type TrackedLotSummary, type TrackedLotsListQuery, type components, createParchmentClient, type paths };

package/dist/index.js

@@ -7,6 +7,13 @@ function createParchmentClient(options) {
     fetch: fetchImpl,
     headers: token ? { Authorization: `Bearer ${token}` } : void 0
   });
+  const postInventory = (body, options2) => client.POST("/v1/inventory", {
+    body,
+    params: options2?.idempotencyKey ? { header: { "idempotency-key": options2.idempotencyKey } } : void 0
+  });
+  function createInventory(body, options2) {
+    return postInventory(body, options2);
+  }
   return {
     /** The underlying typed openapi-fetch client for direct path access. */
     raw: client,
@@ -28,6 +35,20 @@ function createParchmentClient(options) {
         params: { path: { id } }
       })
     },
+    apiUsage: {
+      /**
+       * Read bounded API-key traffic analytics for the authenticated session
+       * owner. Headline monthly/hourly counts are exact; daily/per-key series
+       * carry explicit truncation metadata.
+       */
+      get: (query) => client.GET("/v1/api-usage", { params: { query } })
+    },
+    emailSubscriptions: {
+      /** Get the authenticated session user's Market Read preference. */
+      get: () => client.GET("/v1/email-subscriptions"),
+      /** Idempotently set the authenticated session user's Market Read preference. */
+      setMarketRead: (body) => client.PUT("/v1/email-subscriptions/market-read", { body })
+    },
     cliAuth: {
       /** Create a signed, short-lived login request bound to a PKCE challenge. */
       create: (body) => client.POST("/v1/cli-auth/requests", { body }),
@@ -136,14 +157,11 @@ function createParchmentClient(options) {
       list: (query) => client.GET("/v1/inventory", { params: { query } }),
       /**
        * 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.
+       * 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.
        */
-      create: (body, options2) => client.POST("/v1/inventory", {
-        body,
-        params: options2?.idempotencyKey ? { header: { "idempotency-key": options2.idempotencyKey } } : void 0
-      }),
+      create: createInventory,
       /**
        * Update one of the caller's own inventory rows. Pass `ifMatch` (the
        * row's `last_updated`) to enable optimistic concurrency (409 on mismatch).

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import createClient, { type ClientOptions } from \"openapi-fetch\";\nimport type { components, paths } from \"./schema\";\n\nexport interface ParchmentClientOptions {\n  /** Base URL of the Parchment API, e.g. https://api.purveyors.io */\n  baseUrl: string;\n  /**\n   * Optional bearer token (a Supabase JWT or, later, an API key). Sent as\n   * `Authorization: Bearer <token>`. Auth is resolved server-side against the\n   * unified principal model; the SDK only forwards the credential.\n   */\n  token?: string;\n  /** Override the fetch implementation (useful for tests or custom runtimes). */\n  fetch?: ClientOptions[\"fetch\"];\n}\n\n/** Query parameters for {@link ParchmentClient.catalog.list}. */\nexport type CatalogListQuery = NonNullable<\n  paths[\"/v1/catalog\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** A catalog row returned by the canonical listing resource. */\nexport type CatalogItem = components[\"schemas\"][\"CatalogItem\"];\n/** API-owned row-level trust summary returned when `include=proof`. */\nexport type CatalogProofSummary = components[\"schemas\"][\"CatalogProofSummary\"];\n/** Query parameters for {@link ParchmentClient.catalog.facets}. */\nexport type CatalogFacetsQuery = NonNullable<\n  paths[\"/v1/catalog/facets\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/**\n * Optional headers for {@link ParchmentClient.catalog.list}, notably the\n * RFC 7240 `Prefer: handling=lenient|strict` override (PADR-0013 §7). Sending\n * `handling=lenient` opts a strict caller (API key or bearer-session JWT) back\n * into strip-with-notice degradation instead of a 401/403 hard-deny.\n */\nexport type CatalogListHeaders = NonNullable<\n  paths[\"/v1/catalog\"][\"get\"][\"parameters\"][\"header\"]\n>;\n/** Optional headers for {@link ParchmentClient.catalog.facets}; see {@link CatalogListHeaders}. */\nexport type CatalogFacetsHeaders = NonNullable<\n  paths[\"/v1/catalog/facets\"][\"get\"][\"parameters\"][\"header\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.originPriceStats}. */\nexport type CatalogOriginPriceStatsQuery = NonNullable<\n  paths[\"/v1/catalog/origin-price-stats\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.stats}. */\nexport type CatalogStatsQuery = NonNullable<\n  paths[\"/v1/catalog/stats\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.rank}. */\nexport type CatalogRankQuery = NonNullable<\n  paths[\"/v1/catalog/rank\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.rankPremium}. */\nexport type CatalogRankPremiumQuery = NonNullable<\n  paths[\"/v1/catalog/rank-premium\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.suppliers}. */\nexport type CatalogSuppliersQuery = NonNullable<\n  paths[\"/v1/catalog/suppliers\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.supplierDetail}. */\nexport type CatalogSupplierDetailQuery = NonNullable<\n  paths[\"/v1/catalog/suppliers/detail\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.supplierRank}. */\nexport type CatalogSupplierRankQuery = NonNullable<\n  paths[\"/v1/catalog/suppliers/rank\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Optional headers for ranking endpoints; see {@link CatalogListHeaders}. */\nexport type CatalogRankHeaders = NonNullable<\n  paths[\"/v1/catalog/rank\"][\"get\"][\"parameters\"][\"header\"]\n>;\n/** Optional headers for premium ranking endpoints; see {@link CatalogListHeaders}. */\nexport type CatalogRankPremiumHeaders = NonNullable<\n  paths[\"/v1/catalog/rank-premium\"][\"get\"][\"parameters\"][\"header\"]\n>;\n/** Optional headers for supplier aggregate endpoints; see {@link CatalogListHeaders}. */\nexport type CatalogSupplierHeaders = NonNullable<\n  paths[\"/v1/catalog/suppliers\"][\"get\"][\"parameters\"][\"header\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.similar}. */\nexport type CatalogSimilarQuery = NonNullable<\n  paths[\"/v1/catalog/{id}/similar\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.priceIndex.list}. */\nexport type PriceIndexQuery = NonNullable<\n  paths[\"/v1/price-index\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.market.signals}. */\nexport type MarketSignalsQuery = NonNullable<\n  paths[\"/v1/market/signals\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.priceIndex.stats}. */\nexport type PriceIndexStatsQuery = NonNullable<\n  paths[\"/v1/price-index/stats\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.market.metadataIndex}. */\nexport type MetadataIndexQuery = NonNullable<\n  paths[\"/v1/market/metadata-index\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.procurement.briefs.matches}. */\nexport type BriefMatchesQuery = NonNullable<\n  paths[\"/v1/procurement/briefs/{id}/matches\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Request body for {@link ParchmentClient.procurement.briefs.create}. */\nexport type SourcingBriefCreateRequest =\n  components[\"schemas\"][\"SourcingBriefCreateRequest\"];\n/** Query parameters for {@link ParchmentClient.portfolio.trackedLots.list}. */\nexport type TrackedLotsListQuery = NonNullable<\n  paths[\"/v1/portfolio/tracked-lots\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** A tracked catalog lot enriched with current catalog and price state. */\nexport type TrackedLotSummary = components[\"schemas\"][\"TrackedLotSummary\"];\n/** State returned by tracked-lot PUT and DELETE mutations. */\nexport type TrackedLotMutation =\n  components[\"schemas\"][\"TrackedLotMutationResponse\"];\n/** Query parameters for {@link ParchmentClient.inventory.list}. */\nexport type InventoryListQuery = NonNullable<\n  paths[\"/v1/inventory\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Request body for {@link ParchmentClient.inventory.create}. */\nexport type InventoryCreateRequest = NonNullable<\n  paths[\"/v1/inventory\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Request body for {@link ParchmentClient.inventory.update}. */\nexport type InventoryUpdateRequest = NonNullable<\n  paths[\"/v1/inventory/{id}\"][\"patch\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Query parameters for {@link ParchmentClient.roasts.list}. */\nexport type RoastListQuery = NonNullable<\n  paths[\"/v1/roasts\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.roasts.get}. */\nexport type RoastGetQuery = NonNullable<\n  paths[\"/v1/roasts/{id}\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Request body for {@link ParchmentClient.roasts.classify}. */\nexport type RoastClassificationRequest = NonNullable<\n  paths[\"/v1/roasts/classify\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Request body for {@link ParchmentClient.roasts.create}. */\nexport type RoastCreateRequest = NonNullable<\n  paths[\"/v1/roasts\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Request body for {@link ParchmentClient.roasts.update}. */\nexport type RoastUpdateRequest = NonNullable<\n  paths[\"/v1/roasts/{id}\"][\"patch\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Request body for {@link ParchmentClient.roasts.import}. */\nexport type RoastImportRequest = NonNullable<\n  paths[\"/v1/roasts/imports\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Request body for {@link ParchmentClient.roasts.replaceArtisanImport}. */\nexport type RoastArtisanImportReplaceRequest = NonNullable<\n  paths[\"/v1/roasts/{id}/artisan-import\"][\"put\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Query parameters for {@link ParchmentClient.sales.list}. */\nexport type SalesListQuery = NonNullable<\n  paths[\"/v1/sales\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Request body for {@link ParchmentClient.sales.create}. */\nexport type SalesCreateRequest = NonNullable<\n  paths[\"/v1/sales\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Request body for {@link ParchmentClient.sales.update}. */\nexport type SalesUpdateRequest = NonNullable<\n  paths[\"/v1/sales/{id}\"][\"patch\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Query parameters for {@link ParchmentClient.tasting.get}. */\nexport type TastingGetQuery = NonNullable<\n  paths[\"/v1/tasting/{catalogId}\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Request body for {@link ParchmentClient.tasting.rate}. */\nexport type TastingRateRequest = NonNullable<\n  paths[\"/v1/tasting/inventory/{inventoryId}\"][\"put\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Request body for {@link ParchmentClient.apiKeys.create}. */\nexport type ApiKeyCreateRequest = NonNullable<\n  paths[\"/v1/api-keys\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\nexport type CliAuthRequestCreate = NonNullable<\n  paths[\"/v1/cli-auth/requests\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\nexport type CliAuthInspectRequest = NonNullable<\n  paths[\"/v1/cli-auth/inspect\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\nexport type CliAuthApproveRequest = NonNullable<\n  paths[\"/v1/cli-auth/approve\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\nexport type CliAuthExchangeRequest = NonNullable<\n  paths[\"/v1/cli-auth/token\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n\n/**\n * Create a typed Parchment API client.\n *\n * The generated core (openapi-fetch over the generated `paths` types) is the\n * contract truth; the named helpers below are the hand-maintained ergonomic\n * layer and grow as endpoints land. `raw` always exposes the underlying typed\n * client for direct path access to anything not yet wrapped.\n */\nexport function createParchmentClient(options: ParchmentClientOptions) {\n  const { baseUrl, token, fetch: fetchImpl } = options;\n\n  const client = createClient<paths>({\n    baseUrl,\n    fetch: fetchImpl,\n    headers: token ? { Authorization: `Bearer ${token}` } : undefined,\n  });\n\n  return {\n    /** The underlying typed openapi-fetch client for direct path access. */\n    raw: client,\n    /** Liveness and service identity. */\n    health: () => client.GET(\"/health\"),\n    /** Resolved principal and entitlements for the caller. */\n    me: () => client.GET(\"/v1/me\"),\n    apiKeys: {\n      /** List API keys owned by the authenticated session user. */\n      list: () => client.GET(\"/v1/api-keys\"),\n      /** Create an API key. The raw secret is returned only once. */\n      create: (body: ApiKeyCreateRequest) =>\n        client.POST(\"/v1/api-keys\", { body }),\n      /** Revoke an API key owned by the authenticated session user. */\n      revoke: (id: string) =>\n        client.DELETE(\"/v1/api-keys/{id}\", {\n          params: { path: { id } },\n        }),\n      /** Rotate an API key and return the replacement secret once. */\n      rotate: (id: string) =>\n        client.POST(\"/v1/api-keys/{id}/rotate\", {\n          params: { path: { id } },\n        }),\n    },\n    cliAuth: {\n      /** Create a signed, short-lived login request bound to a PKCE challenge. */\n      create: (body: CliAuthRequestCreate) =>\n        client.POST(\"/v1/cli-auth/requests\", { body }),\n      /** Inspect a signed request before displaying the web consent screen. */\n      inspect: (body: CliAuthInspectRequest) =>\n        client.POST(\"/v1/cli-auth/inspect\", { body }),\n      /** Approve a request using the client's authenticated user session. */\n      approve: (body: CliAuthApproveRequest) =>\n        client.POST(\"/v1/cli-auth/approve\", { body }),\n      /** Exchange an approved request and verifier for the one-time raw key. */\n      exchange: (body: CliAuthExchangeRequest) =>\n        client.POST(\"/v1/cli-auth/token\", { body }),\n    },\n    catalog: {\n      /** Catalog capabilities and visibility for the caller. */\n      access: () => client.GET(\"/v1/catalog/access\"),\n      /**\n       * List public catalog coffees (paginated). Pass `headers` to send the\n       * `Prefer: handling=lenient|strict` override (see {@link CatalogListHeaders}).\n       */\n      list: (query?: CatalogListQuery, headers?: CatalogListHeaders) =>\n        client.GET(\"/v1/catalog\", { params: { query, header: headers } }),\n      /**\n       * Catalog filter metadata and counted facets. Pass `headers` to send the\n       * `Prefer: handling=lenient|strict` override (see {@link CatalogFacetsHeaders}).\n       */\n      facets: (query?: CatalogFacetsQuery, headers?: CatalogFacetsHeaders) =>\n        client.GET(\"/v1/catalog/facets\", {\n          params: { query, header: headers },\n        }),\n      /** Live catalog price context by origin. */\n      originPriceStats: (query?: CatalogOriginPriceStatsQuery) =>\n        client.GET(\"/v1/catalog/origin-price-stats\", { params: { query } }),\n      /** Aggregate stats over the caller-visible catalog. */\n      stats: (query?: CatalogStatsQuery) =>\n        client.GET(\"/v1/catalog/stats\", { params: { query } }),\n      /** Rank caller-visible catalog coffees by deterministic objectives. */\n      rank: (query?: CatalogRankQuery, headers?: CatalogRankHeaders) =>\n        client.GET(\"/v1/catalog/rank\", {\n          params: { query, header: headers },\n        }),\n      /** Rank premium catalog candidates by Purveyor Score. */\n      rankPremium: (\n        query?: CatalogRankPremiumQuery,\n        headers?: CatalogRankPremiumHeaders,\n      ) =>\n        client.GET(\"/v1/catalog/rank-premium\", {\n          params: { query, header: headers },\n        }),\n      /** List supplier aggregates over caller-visible catalog coffees. */\n      suppliers: (\n        query?: CatalogSuppliersQuery,\n        headers?: CatalogSupplierHeaders,\n      ) =>\n        client.GET(\"/v1/catalog/suppliers\", {\n          params: { query, header: headers },\n        }),\n      /** Return aggregate detail for a supplier query. */\n      supplierDetail: (\n        query: CatalogSupplierDetailQuery,\n        headers?: CatalogSupplierHeaders,\n      ) =>\n        client.GET(\"/v1/catalog/suppliers/detail\", {\n          params: { query, header: headers },\n        }),\n      /** Rank suppliers by catalog score and availability. */\n      supplierRank: (\n        query?: CatalogSupplierRankQuery,\n        headers?: CatalogSupplierHeaders,\n      ) =>\n        client.GET(\"/v1/catalog/suppliers/rank\", {\n          params: { query, header: headers },\n        }),\n      /** Aggregate proof-coverage over the public catalog. */\n      proofCoverage: () => client.GET(\"/v1/catalog/proof-coverage\"),\n      /** Find catalog coffees similar to a target coffee. */\n      similar: (id: string, query?: CatalogSimilarQuery) =>\n        client.GET(\"/v1/catalog/{id}/similar\", {\n          params: { path: { id }, query },\n        }),\n    },\n    priceIndex: {\n      /** Parchment Price Index (aggregate snapshots). */\n      list: (query?: PriceIndexQuery) =>\n        client.GET(\"/v1/price-index\", { params: { query } }),\n      /** Price movement significance stats (precomputed). */\n      stats: (query?: PriceIndexStatsQuery) =>\n        client.GET(\"/v1/price-index/stats\", { params: { query } }),\n    },\n    market: {\n      /** Actionable market value signals. */\n      signals: (query?: MarketSignalsQuery) =>\n        client.GET(\"/v1/market/signals\", { params: { query } }),\n      /** Metadata-trend index (process/disclosure/Purveyor Score over time). */\n      metadataIndex: (query?: MetadataIndexQuery) =>\n        client.GET(\"/v1/market/metadata-index\", { params: { query } }),\n    },\n    procurement: {\n      briefs: {\n        /** List the caller's saved sourcing briefs. */\n        list: () => client.GET(\"/v1/procurement/briefs\"),\n        /** Create a saved sourcing brief. */\n        create: (body: SourcingBriefCreateRequest) =>\n          client.POST(\"/v1/procurement/briefs\", { body }),\n        /** Fetch one of the caller's sourcing briefs by id. */\n        get: (id: string) =>\n          client.GET(\"/v1/procurement/briefs/{id}\", {\n            params: { path: { id } },\n          }),\n        /** Run a saved brief against the catalog (paginated matches). */\n        matches: (id: string, query?: BriefMatchesQuery) =>\n          client.GET(\"/v1/procurement/briefs/{id}/matches\", {\n            params: { path: { id }, query },\n          }),\n      },\n    },\n    portfolio: {\n      trackedLots: {\n        /**\n         * List the caller's complete tracked catalog-id set and bounded recent\n         * summaries enriched with live catalog state.\n         */\n        list: (query?: TrackedLotsListQuery) =>\n          client.GET(\"/v1/portfolio/tracked-lots\", {\n            params: { query },\n          }),\n        /** Idempotently set a visible catalog lot to tracked. */\n        track: (catalogId: number) =>\n          client.PUT(\"/v1/portfolio/tracked-lots/{catalogId}\", {\n            params: { path: { catalogId } },\n          }),\n        /** Idempotently set an owner catalog lot to untracked. */\n        untrack: (catalogId: number) =>\n          client.DELETE(\"/v1/portfolio/tracked-lots/{catalogId}\", {\n            params: { path: { catalogId } },\n          }),\n      },\n    },\n    inventory: {\n      /** List the caller's own green-coffee inventory (owner-scoped). */\n      list: (query?: InventoryListQuery) =>\n        client.GET(\"/v1/inventory\", { params: { query } }),\n      /**\n       * Create an owner inventory lot. Requires a session or an owner-bound API\n       * key carrying the exact `inventory:write` scope. Pass `idempotencyKey`\n       * to make retries safe: the same key replays the original result, and a\n       * concurrent duplicate gets 409 while the first is in flight.\n       */\n      create: (\n        body: InventoryCreateRequest,\n        options?: { idempotencyKey?: string },\n      ) =>\n        client.POST(\"/v1/inventory\", {\n          body,\n          params: options?.idempotencyKey\n            ? { header: { \"idempotency-key\": options.idempotencyKey } }\n            : undefined,\n        }),\n      /**\n       * Update one of the caller's own inventory rows. Pass `ifMatch` (the\n       * row's `last_updated`) to enable optimistic concurrency (409 on mismatch).\n       */\n      update: (\n        id: number,\n        body: InventoryUpdateRequest,\n        options?: { ifMatch?: string },\n      ) =>\n        client.PATCH(\"/v1/inventory/{id}\", {\n          params: {\n            path: { id },\n            header: options?.ifMatch\n              ? { \"if-match\": options.ifMatch }\n              : undefined,\n          },\n          body,\n        }),\n      /**\n       * Delete one of the caller's own inventory rows. Returns 409 if dependent\n       * roast profiles or sales exist (no force-cascade).\n       */\n      delete: (id: number) =>\n        client.DELETE(\"/v1/inventory/{id}\", { params: { path: { id } } }),\n    },\n    roasts: {\n      /** Match Artisan roast metadata to one of the supplied inventory rows. */\n      classify: (body: RoastClassificationRequest) =>\n        client.POST(\"/v1/roasts/classify\", { body }),\n      /** List the caller's own roast profiles (owner-scoped). */\n      list: (query?: RoastListQuery) =>\n        client.GET(\"/v1/roasts\", { params: { query } }),\n      /**\n       * Fetch one of the caller's roast profiles by id, optionally with its\n       * temperature curve (`includeTemps`) and event markers (`includeEvents`).\n       */\n      get: (id: string, query?: RoastGetQuery) =>\n        client.GET(\"/v1/roasts/{id}\", { params: { path: { id }, query } }),\n      /**\n       * Create an owner roast profile, optionally with nested temperature/event\n       * rows. Requires a session or an owner-bound API key carrying the exact\n       * `roast:write` scope. Pass `idempotencyKey` to make retries safe.\n       */\n      create: (\n        body: RoastCreateRequest,\n        options?: { idempotencyKey?: string },\n      ) =>\n        client.POST(\"/v1/roasts\", {\n          body,\n          params: options?.idempotencyKey\n            ? { header: { \"idempotency-key\": options.idempotencyKey } }\n            : undefined,\n        }),\n      /**\n       * Update one of the caller's own roast profiles. Pass `ifMatch` (the\n       * row's `last_updated`) to enable optimistic concurrency (409 on mismatch).\n       */\n      update: (\n        id: number,\n        body: RoastUpdateRequest,\n        options?: { ifMatch?: string },\n      ) =>\n        client.PATCH(\"/v1/roasts/{id}\", {\n          params: {\n            path: { id },\n            header: options?.ifMatch\n              ? { \"if-match\": options.ifMatch }\n              : undefined,\n          },\n          body,\n        }),\n      /** Delete one of the caller's own roast profiles. */\n      delete: (id: number) =>\n        client.DELETE(\"/v1/roasts/{id}\", { params: { path: { id } } }),\n      /**\n       * Create a roast profile from an Artisan `.alog` file against one of the\n       * caller's green-coffee lots, persisting the imported curve, events, and\n       * an artisan_import_log entry atomically. Requires a session or an\n       * owner-bound API key carrying the exact `roast:write` scope. Pass\n       * `idempotencyKey` to make retries safe.\n       */\n      import: (\n        body: RoastImportRequest,\n        options?: { idempotencyKey?: string },\n      ) =>\n        client.POST(\"/v1/roasts/imports\", {\n          body,\n          params: options?.idempotencyKey\n            ? { header: { \"idempotency-key\": options.idempotencyKey } }\n            : undefined,\n        }),\n      /**\n       * Replace the Artisan import data on one of the caller's existing roasts,\n       * re-deriving its curve, events, and computed metrics while preserving the\n       * roast's identity. Pass `ifMatch` (the roast's `last_updated`) to enable\n       * optimistic concurrency (409 on mismatch).\n       */\n      replaceArtisanImport: (\n        id: number,\n        body: RoastArtisanImportReplaceRequest,\n        options?: { ifMatch?: string },\n      ) =>\n        client.PUT(\"/v1/roasts/{id}/artisan-import\", {\n          params: {\n            path: { id },\n            header: options?.ifMatch\n              ? { \"if-match\": options.ifMatch }\n              : undefined,\n          },\n          body,\n        }),\n      /**\n       * Clear import-derived curve, events, metrics, and provenance data from\n       * one of the caller's existing roasts without deleting the roast profile.\n       */\n      clearArtisanImport: (id: number) =>\n        client.DELETE(\"/v1/roasts/{id}/artisan-import\", {\n          params: { path: { id } },\n        }),\n    },\n    sales: {\n      /** List the caller's own sales (owner-scoped). */\n      list: (query?: SalesListQuery) =>\n        client.GET(\"/v1/sales\", { params: { query } }),\n      /**\n       * Record a sale against one of the caller's own green-coffee inventory\n       * lots. Requires a session or an owner-bound API key carrying the exact\n       * `sales:write` scope. Pass `idempotencyKey` to make retries safe: the\n       * same key replays the original result, and a concurrent duplicate gets\n       * 409 while the first is in flight.\n       */\n      create: (\n        body: SalesCreateRequest,\n        options?: { idempotencyKey?: string },\n      ) =>\n        client.POST(\"/v1/sales\", {\n          body,\n          params: options?.idempotencyKey\n            ? { header: { \"idempotency-key\": options.idempotencyKey } }\n            : undefined,\n        }),\n      /**\n       * Update one of the caller's own sales. The sales table carries no\n       * `last_updated` column, so no If-Match optimistic concurrency is\n       * offered.\n       */\n      update: (id: number, body: SalesUpdateRequest) =>\n        client.PATCH(\"/v1/sales/{id}\", {\n          params: { path: { id } },\n          body,\n        }),\n      /** Delete one of the caller's own sales. */\n      delete: (id: number) =>\n        client.DELETE(\"/v1/sales/{id}\", { params: { path: { id } } }),\n    },\n    tasting: {\n      /** Fetch supplier notes plus the caller's own latest tasting notes. */\n      get: (catalogId: string, query?: TastingGetQuery) =>\n        client.GET(\"/v1/tasting/{catalogId}\", {\n          params: { path: { catalogId }, query },\n        }),\n      /** Replace the caller's rating for one owned inventory lot. */\n      rate: (inventoryId: number, body: TastingRateRequest) =>\n        client.PUT(\"/v1/tasting/inventory/{inventoryId}\", {\n          params: { path: { inventoryId } },\n          body,\n        }),\n    },\n  };\n}\n\nexport type ParchmentClient = ReturnType<typeof createParchmentClient>;\n"],"mappings":"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","names":["options"]}
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import createClient, { type ClientOptions } from \"openapi-fetch\";\nimport type { components, paths } from \"./schema\";\n\nexport interface ParchmentClientOptions {\n  /** Base URL of the Parchment API, e.g. https://api.purveyors.io */\n  baseUrl: string;\n  /**\n   * Optional bearer token (a Supabase JWT or, later, an API key). Sent as\n   * `Authorization: Bearer <token>`. Auth is resolved server-side against the\n   * unified principal model; the SDK only forwards the credential.\n   */\n  token?: string;\n  /** Override the fetch implementation (useful for tests or custom runtimes). */\n  fetch?: ClientOptions[\"fetch\"];\n}\n\n/** Query parameters for {@link ParchmentClient.catalog.list}. */\nexport type CatalogListQuery = NonNullable<\n  paths[\"/v1/catalog\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** A catalog row returned by the canonical listing resource. */\nexport type CatalogItem = components[\"schemas\"][\"CatalogItem\"];\n/** API-owned row-level trust summary returned when `include=proof`. */\nexport type CatalogProofSummary = components[\"schemas\"][\"CatalogProofSummary\"];\n/** Query parameters for {@link ParchmentClient.catalog.facets}. */\nexport type CatalogFacetsQuery = NonNullable<\n  paths[\"/v1/catalog/facets\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/**\n * Optional headers for {@link ParchmentClient.catalog.list}, notably the\n * RFC 7240 `Prefer: handling=lenient|strict` override (PADR-0013 §7). Sending\n * `handling=lenient` opts a strict caller (API key or bearer-session JWT) back\n * into strip-with-notice degradation instead of a 401/403 hard-deny.\n */\nexport type CatalogListHeaders = NonNullable<\n  paths[\"/v1/catalog\"][\"get\"][\"parameters\"][\"header\"]\n>;\n/** Optional headers for {@link ParchmentClient.catalog.facets}; see {@link CatalogListHeaders}. */\nexport type CatalogFacetsHeaders = NonNullable<\n  paths[\"/v1/catalog/facets\"][\"get\"][\"parameters\"][\"header\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.originPriceStats}. */\nexport type CatalogOriginPriceStatsQuery = NonNullable<\n  paths[\"/v1/catalog/origin-price-stats\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.stats}. */\nexport type CatalogStatsQuery = NonNullable<\n  paths[\"/v1/catalog/stats\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.rank}. */\nexport type CatalogRankQuery = NonNullable<\n  paths[\"/v1/catalog/rank\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.rankPremium}. */\nexport type CatalogRankPremiumQuery = NonNullable<\n  paths[\"/v1/catalog/rank-premium\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.suppliers}. */\nexport type CatalogSuppliersQuery = NonNullable<\n  paths[\"/v1/catalog/suppliers\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.supplierDetail}. */\nexport type CatalogSupplierDetailQuery = NonNullable<\n  paths[\"/v1/catalog/suppliers/detail\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.supplierRank}. */\nexport type CatalogSupplierRankQuery = NonNullable<\n  paths[\"/v1/catalog/suppliers/rank\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Optional headers for ranking endpoints; see {@link CatalogListHeaders}. */\nexport type CatalogRankHeaders = NonNullable<\n  paths[\"/v1/catalog/rank\"][\"get\"][\"parameters\"][\"header\"]\n>;\n/** Optional headers for premium ranking endpoints; see {@link CatalogListHeaders}. */\nexport type CatalogRankPremiumHeaders = NonNullable<\n  paths[\"/v1/catalog/rank-premium\"][\"get\"][\"parameters\"][\"header\"]\n>;\n/** Optional headers for supplier aggregate endpoints; see {@link CatalogListHeaders}. */\nexport type CatalogSupplierHeaders = NonNullable<\n  paths[\"/v1/catalog/suppliers\"][\"get\"][\"parameters\"][\"header\"]\n>;\n/** Query parameters for {@link ParchmentClient.catalog.similar}. */\nexport type CatalogSimilarQuery = NonNullable<\n  paths[\"/v1/catalog/{id}/similar\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.priceIndex.list}. */\nexport type PriceIndexQuery = NonNullable<\n  paths[\"/v1/price-index\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.market.signals}. */\nexport type MarketSignalsQuery = NonNullable<\n  paths[\"/v1/market/signals\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.priceIndex.stats}. */\nexport type PriceIndexStatsQuery = NonNullable<\n  paths[\"/v1/price-index/stats\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.market.metadataIndex}. */\nexport type MetadataIndexQuery = NonNullable<\n  paths[\"/v1/market/metadata-index\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.procurement.briefs.matches}. */\nexport type BriefMatchesQuery = NonNullable<\n  paths[\"/v1/procurement/briefs/{id}/matches\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Request body for {@link ParchmentClient.procurement.briefs.create}. */\nexport type SourcingBriefCreateRequest =\n  components[\"schemas\"][\"SourcingBriefCreateRequest\"];\n/** Query parameters for {@link ParchmentClient.portfolio.trackedLots.list}. */\nexport type TrackedLotsListQuery = NonNullable<\n  paths[\"/v1/portfolio/tracked-lots\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** A tracked catalog lot enriched with current catalog and price state. */\nexport type TrackedLotSummary = components[\"schemas\"][\"TrackedLotSummary\"];\n/** State returned by tracked-lot PUT and DELETE mutations. */\nexport type TrackedLotMutation =\n  components[\"schemas\"][\"TrackedLotMutationResponse\"];\n/** Query parameters for {@link ParchmentClient.inventory.list}. */\nexport type InventoryListQuery = NonNullable<\n  paths[\"/v1/inventory\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Request body for {@link ParchmentClient.inventory.create}. */\nexport type InventoryCreateRequest = NonNullable<\n  paths[\"/v1/inventory\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\ntype CatalogInventoryCreateRequest =\n  components[\"schemas\"][\"CatalogInventoryCreateRequest\"];\ntype ManualInventoryCreateRequest =\n  components[\"schemas\"][\"ManualInventoryCreateRequest\"];\n/** Request body for {@link ParchmentClient.inventory.update}. */\nexport type InventoryUpdateRequest = NonNullable<\n  paths[\"/v1/inventory/{id}\"][\"patch\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Query parameters for {@link ParchmentClient.roasts.list}. */\nexport type RoastListQuery = NonNullable<\n  paths[\"/v1/roasts\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Query parameters for {@link ParchmentClient.roasts.get}. */\nexport type RoastGetQuery = NonNullable<\n  paths[\"/v1/roasts/{id}\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Request body for {@link ParchmentClient.roasts.classify}. */\nexport type RoastClassificationRequest = NonNullable<\n  paths[\"/v1/roasts/classify\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Request body for {@link ParchmentClient.roasts.create}. */\nexport type RoastCreateRequest = NonNullable<\n  paths[\"/v1/roasts\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Request body for {@link ParchmentClient.roasts.update}. */\nexport type RoastUpdateRequest = NonNullable<\n  paths[\"/v1/roasts/{id}\"][\"patch\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Request body for {@link ParchmentClient.roasts.import}. */\nexport type RoastImportRequest = NonNullable<\n  paths[\"/v1/roasts/imports\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Request body for {@link ParchmentClient.roasts.replaceArtisanImport}. */\nexport type RoastArtisanImportReplaceRequest = NonNullable<\n  paths[\"/v1/roasts/{id}/artisan-import\"][\"put\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Query parameters for {@link ParchmentClient.sales.list}. */\nexport type SalesListQuery = NonNullable<\n  paths[\"/v1/sales\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Request body for {@link ParchmentClient.sales.create}. */\nexport type SalesCreateRequest = NonNullable<\n  paths[\"/v1/sales\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Request body for {@link ParchmentClient.sales.update}. */\nexport type SalesUpdateRequest = NonNullable<\n  paths[\"/v1/sales/{id}\"][\"patch\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Query parameters for {@link ParchmentClient.tasting.get}. */\nexport type TastingGetQuery = NonNullable<\n  paths[\"/v1/tasting/{catalogId}\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Request body for {@link ParchmentClient.tasting.rate}. */\nexport type TastingRateRequest = NonNullable<\n  paths[\"/v1/tasting/inventory/{inventoryId}\"][\"put\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Request body for {@link ParchmentClient.apiKeys.create}. */\nexport type ApiKeyCreateRequest = NonNullable<\n  paths[\"/v1/api-keys\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Query parameters for the session owner's API-key traffic analytics. */\nexport type OwnerApiUsageQuery = NonNullable<\n  paths[\"/v1/api-usage\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** Bounded owner API-key traffic analytics (not session or billing usage). */\nexport type OwnerApiUsage = components[\"schemas\"][\"OwnerApiUsageResponse\"];\n/** Request body for {@link ParchmentClient.emailSubscriptions.setMarketRead}. */\nexport type MarketReadPreferenceRequest = NonNullable<\n  paths[\"/v1/email-subscriptions/market-read\"][\"put\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n/** Account-owned Market Read email preference. */\nexport type EmailSubscriptionPreference =\n  components[\"schemas\"][\"EmailSubscriptionPreference\"];\nexport type CliAuthRequestCreate = NonNullable<\n  paths[\"/v1/cli-auth/requests\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\nexport type CliAuthInspectRequest = NonNullable<\n  paths[\"/v1/cli-auth/inspect\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\nexport type CliAuthApproveRequest = NonNullable<\n  paths[\"/v1/cli-auth/approve\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\nexport type CliAuthExchangeRequest = NonNullable<\n  paths[\"/v1/cli-auth/token\"][\"post\"][\"requestBody\"]\n>[\"content\"][\"application/json\"];\n\n/**\n * Create a typed Parchment API client.\n *\n * The generated core (openapi-fetch over the generated `paths` types) is the\n * contract truth; the named helpers below are the hand-maintained ergonomic\n * layer and grow as endpoints land. `raw` always exposes the underlying typed\n * client for direct path access to anything not yet wrapped.\n */\nexport function createParchmentClient(options: ParchmentClientOptions) {\n  const { baseUrl, token, fetch: fetchImpl } = options;\n\n  const client = createClient<paths>({\n    baseUrl,\n    fetch: fetchImpl,\n    headers: token ? { Authorization: `Bearer ${token}` } : undefined,\n  });\n\n  const postInventory = (\n    body: InventoryCreateRequest,\n    options?: { idempotencyKey?: string },\n  ) =>\n    client.POST(\"/v1/inventory\", {\n      body,\n      params: options?.idempotencyKey\n        ? { header: { \"idempotency-key\": options.idempotencyKey } }\n        : undefined,\n    });\n\n  function createInventory(\n    body: ManualInventoryCreateRequest,\n    options: { idempotencyKey: string },\n  ): ReturnType<typeof postInventory>;\n  function createInventory(\n    body: CatalogInventoryCreateRequest,\n    options?: { idempotencyKey?: string },\n  ): ReturnType<typeof postInventory>;\n  function createInventory(\n    body: InventoryCreateRequest,\n    options?: { idempotencyKey?: string },\n  ): ReturnType<typeof postInventory> {\n    return postInventory(body, options);\n  }\n\n  return {\n    /** The underlying typed openapi-fetch client for direct path access. */\n    raw: client,\n    /** Liveness and service identity. */\n    health: () => client.GET(\"/health\"),\n    /** Resolved principal and entitlements for the caller. */\n    me: () => client.GET(\"/v1/me\"),\n    apiKeys: {\n      /** List API keys owned by the authenticated session user. */\n      list: () => client.GET(\"/v1/api-keys\"),\n      /** Create an API key. The raw secret is returned only once. */\n      create: (body: ApiKeyCreateRequest) =>\n        client.POST(\"/v1/api-keys\", { body }),\n      /** Revoke an API key owned by the authenticated session user. */\n      revoke: (id: string) =>\n        client.DELETE(\"/v1/api-keys/{id}\", {\n          params: { path: { id } },\n        }),\n      /** Rotate an API key and return the replacement secret once. */\n      rotate: (id: string) =>\n        client.POST(\"/v1/api-keys/{id}/rotate\", {\n          params: { path: { id } },\n        }),\n    },\n    apiUsage: {\n      /**\n       * Read bounded API-key traffic analytics for the authenticated session\n       * owner. Headline monthly/hourly counts are exact; daily/per-key series\n       * carry explicit truncation metadata.\n       */\n      get: (query?: OwnerApiUsageQuery) =>\n        client.GET(\"/v1/api-usage\", { params: { query } }),\n    },\n    emailSubscriptions: {\n      /** Get the authenticated session user's Market Read preference. */\n      get: () => client.GET(\"/v1/email-subscriptions\"),\n      /** Idempotently set the authenticated session user's Market Read preference. */\n      setMarketRead: (body: MarketReadPreferenceRequest) =>\n        client.PUT(\"/v1/email-subscriptions/market-read\", { body }),\n    },\n    cliAuth: {\n      /** Create a signed, short-lived login request bound to a PKCE challenge. */\n      create: (body: CliAuthRequestCreate) =>\n        client.POST(\"/v1/cli-auth/requests\", { body }),\n      /** Inspect a signed request before displaying the web consent screen. */\n      inspect: (body: CliAuthInspectRequest) =>\n        client.POST(\"/v1/cli-auth/inspect\", { body }),\n      /** Approve a request using the client's authenticated user session. */\n      approve: (body: CliAuthApproveRequest) =>\n        client.POST(\"/v1/cli-auth/approve\", { body }),\n      /** Exchange an approved request and verifier for the one-time raw key. */\n      exchange: (body: CliAuthExchangeRequest) =>\n        client.POST(\"/v1/cli-auth/token\", { body }),\n    },\n    catalog: {\n      /** Catalog capabilities and visibility for the caller. */\n      access: () => client.GET(\"/v1/catalog/access\"),\n      /**\n       * List public catalog coffees (paginated). Pass `headers` to send the\n       * `Prefer: handling=lenient|strict` override (see {@link CatalogListHeaders}).\n       */\n      list: (query?: CatalogListQuery, headers?: CatalogListHeaders) =>\n        client.GET(\"/v1/catalog\", { params: { query, header: headers } }),\n      /**\n       * Catalog filter metadata and counted facets. Pass `headers` to send the\n       * `Prefer: handling=lenient|strict` override (see {@link CatalogFacetsHeaders}).\n       */\n      facets: (query?: CatalogFacetsQuery, headers?: CatalogFacetsHeaders) =>\n        client.GET(\"/v1/catalog/facets\", {\n          params: { query, header: headers },\n        }),\n      /** Live catalog price context by origin. */\n      originPriceStats: (query?: CatalogOriginPriceStatsQuery) =>\n        client.GET(\"/v1/catalog/origin-price-stats\", { params: { query } }),\n      /** Aggregate stats over the caller-visible catalog. */\n      stats: (query?: CatalogStatsQuery) =>\n        client.GET(\"/v1/catalog/stats\", { params: { query } }),\n      /** Rank caller-visible catalog coffees by deterministic objectives. */\n      rank: (query?: CatalogRankQuery, headers?: CatalogRankHeaders) =>\n        client.GET(\"/v1/catalog/rank\", {\n          params: { query, header: headers },\n        }),\n      /** Rank premium catalog candidates by Purveyor Score. */\n      rankPremium: (\n        query?: CatalogRankPremiumQuery,\n        headers?: CatalogRankPremiumHeaders,\n      ) =>\n        client.GET(\"/v1/catalog/rank-premium\", {\n          params: { query, header: headers },\n        }),\n      /** List supplier aggregates over caller-visible catalog coffees. */\n      suppliers: (\n        query?: CatalogSuppliersQuery,\n        headers?: CatalogSupplierHeaders,\n      ) =>\n        client.GET(\"/v1/catalog/suppliers\", {\n          params: { query, header: headers },\n        }),\n      /** Return aggregate detail for a supplier query. */\n      supplierDetail: (\n        query: CatalogSupplierDetailQuery,\n        headers?: CatalogSupplierHeaders,\n      ) =>\n        client.GET(\"/v1/catalog/suppliers/detail\", {\n          params: { query, header: headers },\n        }),\n      /** Rank suppliers by catalog score and availability. */\n      supplierRank: (\n        query?: CatalogSupplierRankQuery,\n        headers?: CatalogSupplierHeaders,\n      ) =>\n        client.GET(\"/v1/catalog/suppliers/rank\", {\n          params: { query, header: headers },\n        }),\n      /** Aggregate proof-coverage over the public catalog. */\n      proofCoverage: () => client.GET(\"/v1/catalog/proof-coverage\"),\n      /** Find catalog coffees similar to a target coffee. */\n      similar: (id: string, query?: CatalogSimilarQuery) =>\n        client.GET(\"/v1/catalog/{id}/similar\", {\n          params: { path: { id }, query },\n        }),\n    },\n    priceIndex: {\n      /** Parchment Price Index (aggregate snapshots). */\n      list: (query?: PriceIndexQuery) =>\n        client.GET(\"/v1/price-index\", { params: { query } }),\n      /** Price movement significance stats (precomputed). */\n      stats: (query?: PriceIndexStatsQuery) =>\n        client.GET(\"/v1/price-index/stats\", { params: { query } }),\n    },\n    market: {\n      /** Actionable market value signals. */\n      signals: (query?: MarketSignalsQuery) =>\n        client.GET(\"/v1/market/signals\", { params: { query } }),\n      /** Metadata-trend index (process/disclosure/Purveyor Score over time). */\n      metadataIndex: (query?: MetadataIndexQuery) =>\n        client.GET(\"/v1/market/metadata-index\", { params: { query } }),\n    },\n    procurement: {\n      briefs: {\n        /** List the caller's saved sourcing briefs. */\n        list: () => client.GET(\"/v1/procurement/briefs\"),\n        /** Create a saved sourcing brief. */\n        create: (body: SourcingBriefCreateRequest) =>\n          client.POST(\"/v1/procurement/briefs\", { body }),\n        /** Fetch one of the caller's sourcing briefs by id. */\n        get: (id: string) =>\n          client.GET(\"/v1/procurement/briefs/{id}\", {\n            params: { path: { id } },\n          }),\n        /** Run a saved brief against the catalog (paginated matches). */\n        matches: (id: string, query?: BriefMatchesQuery) =>\n          client.GET(\"/v1/procurement/briefs/{id}/matches\", {\n            params: { path: { id }, query },\n          }),\n      },\n    },\n    portfolio: {\n      trackedLots: {\n        /**\n         * List the caller's complete tracked catalog-id set and bounded recent\n         * summaries enriched with live catalog state.\n         */\n        list: (query?: TrackedLotsListQuery) =>\n          client.GET(\"/v1/portfolio/tracked-lots\", {\n            params: { query },\n          }),\n        /** Idempotently set a visible catalog lot to tracked. */\n        track: (catalogId: number) =>\n          client.PUT(\"/v1/portfolio/tracked-lots/{catalogId}\", {\n            params: { path: { catalogId } },\n          }),\n        /** Idempotently set an owner catalog lot to untracked. */\n        untrack: (catalogId: number) =>\n          client.DELETE(\"/v1/portfolio/tracked-lots/{catalogId}\", {\n            params: { path: { catalogId } },\n          }),\n      },\n    },\n    inventory: {\n      /** List the caller's own green-coffee inventory (owner-scoped). */\n      list: (query?: InventoryListQuery) =>\n        client.GET(\"/v1/inventory\", { params: { query } }),\n      /**\n       * Create an owner inventory lot. Requires a session or an owner-bound API\n       * key carrying the exact `inventory:write` scope. Manual coffee creates\n       * require `idempotencyKey`; catalog-backed creates accept it optionally.\n       * The same key and payload replay the original result.\n       */\n      create: createInventory,\n      /**\n       * Update one of the caller's own inventory rows. Pass `ifMatch` (the\n       * row's `last_updated`) to enable optimistic concurrency (409 on mismatch).\n       */\n      update: (\n        id: number,\n        body: InventoryUpdateRequest,\n        options?: { ifMatch?: string },\n      ) =>\n        client.PATCH(\"/v1/inventory/{id}\", {\n          params: {\n            path: { id },\n            header: options?.ifMatch\n              ? { \"if-match\": options.ifMatch }\n              : undefined,\n          },\n          body,\n        }),\n      /**\n       * Delete one of the caller's own inventory rows. Returns 409 if dependent\n       * roast profiles or sales exist (no force-cascade).\n       */\n      delete: (id: number) =>\n        client.DELETE(\"/v1/inventory/{id}\", { params: { path: { id } } }),\n    },\n    roasts: {\n      /** Match Artisan roast metadata to one of the supplied inventory rows. */\n      classify: (body: RoastClassificationRequest) =>\n        client.POST(\"/v1/roasts/classify\", { body }),\n      /** List the caller's own roast profiles (owner-scoped). */\n      list: (query?: RoastListQuery) =>\n        client.GET(\"/v1/roasts\", { params: { query } }),\n      /**\n       * Fetch one of the caller's roast profiles by id, optionally with its\n       * temperature curve (`includeTemps`) and event markers (`includeEvents`).\n       */\n      get: (id: string, query?: RoastGetQuery) =>\n        client.GET(\"/v1/roasts/{id}\", { params: { path: { id }, query } }),\n      /**\n       * Create an owner roast profile, optionally with nested temperature/event\n       * rows. Requires a session or an owner-bound API key carrying the exact\n       * `roast:write` scope. Pass `idempotencyKey` to make retries safe.\n       */\n      create: (\n        body: RoastCreateRequest,\n        options?: { idempotencyKey?: string },\n      ) =>\n        client.POST(\"/v1/roasts\", {\n          body,\n          params: options?.idempotencyKey\n            ? { header: { \"idempotency-key\": options.idempotencyKey } }\n            : undefined,\n        }),\n      /**\n       * Update one of the caller's own roast profiles. Pass `ifMatch` (the\n       * row's `last_updated`) to enable optimistic concurrency (409 on mismatch).\n       */\n      update: (\n        id: number,\n        body: RoastUpdateRequest,\n        options?: { ifMatch?: string },\n      ) =>\n        client.PATCH(\"/v1/roasts/{id}\", {\n          params: {\n            path: { id },\n            header: options?.ifMatch\n              ? { \"if-match\": options.ifMatch }\n              : undefined,\n          },\n          body,\n        }),\n      /** Delete one of the caller's own roast profiles. */\n      delete: (id: number) =>\n        client.DELETE(\"/v1/roasts/{id}\", { params: { path: { id } } }),\n      /**\n       * Create a roast profile from an Artisan `.alog` file against one of the\n       * caller's green-coffee lots, persisting the imported curve, events, and\n       * an artisan_import_log entry atomically. Requires a session or an\n       * owner-bound API key carrying the exact `roast:write` scope. Pass\n       * `idempotencyKey` to make retries safe.\n       */\n      import: (\n        body: RoastImportRequest,\n        options?: { idempotencyKey?: string },\n      ) =>\n        client.POST(\"/v1/roasts/imports\", {\n          body,\n          params: options?.idempotencyKey\n            ? { header: { \"idempotency-key\": options.idempotencyKey } }\n            : undefined,\n        }),\n      /**\n       * Replace the Artisan import data on one of the caller's existing roasts,\n       * re-deriving its curve, events, and computed metrics while preserving the\n       * roast's identity. Pass `ifMatch` (the roast's `last_updated`) to enable\n       * optimistic concurrency (409 on mismatch).\n       */\n      replaceArtisanImport: (\n        id: number,\n        body: RoastArtisanImportReplaceRequest,\n        options?: { ifMatch?: string },\n      ) =>\n        client.PUT(\"/v1/roasts/{id}/artisan-import\", {\n          params: {\n            path: { id },\n            header: options?.ifMatch\n              ? { \"if-match\": options.ifMatch }\n              : undefined,\n          },\n          body,\n        }),\n      /**\n       * Clear import-derived curve, events, metrics, and provenance data from\n       * one of the caller's existing roasts without deleting the roast profile.\n       */\n      clearArtisanImport: (id: number) =>\n        client.DELETE(\"/v1/roasts/{id}/artisan-import\", {\n          params: { path: { id } },\n        }),\n    },\n    sales: {\n      /** List the caller's own sales (owner-scoped). */\n      list: (query?: SalesListQuery) =>\n        client.GET(\"/v1/sales\", { params: { query } }),\n      /**\n       * Record a sale against one of the caller's own green-coffee inventory\n       * lots. Requires a session or an owner-bound API key carrying the exact\n       * `sales:write` scope. Pass `idempotencyKey` to make retries safe: the\n       * same key replays the original result, and a concurrent duplicate gets\n       * 409 while the first is in flight.\n       */\n      create: (\n        body: SalesCreateRequest,\n        options?: { idempotencyKey?: string },\n      ) =>\n        client.POST(\"/v1/sales\", {\n          body,\n          params: options?.idempotencyKey\n            ? { header: { \"idempotency-key\": options.idempotencyKey } }\n            : undefined,\n        }),\n      /**\n       * Update one of the caller's own sales. The sales table carries no\n       * `last_updated` column, so no If-Match optimistic concurrency is\n       * offered.\n       */\n      update: (id: number, body: SalesUpdateRequest) =>\n        client.PATCH(\"/v1/sales/{id}\", {\n          params: { path: { id } },\n          body,\n        }),\n      /** Delete one of the caller's own sales. */\n      delete: (id: number) =>\n        client.DELETE(\"/v1/sales/{id}\", { params: { path: { id } } }),\n    },\n    tasting: {\n      /** Fetch supplier notes plus the caller's own latest tasting notes. */\n      get: (catalogId: string, query?: TastingGetQuery) =>\n        client.GET(\"/v1/tasting/{catalogId}\", {\n          params: { path: { catalogId }, query },\n        }),\n      /** Replace the caller's rating for one owned inventory lot. */\n      rate: (inventoryId: number, body: TastingRateRequest) =>\n        client.PUT(\"/v1/tasting/inventory/{inventoryId}\", {\n          params: { path: { inventoryId } },\n          body,\n        }),\n    },\n  };\n}\n\nexport type ParchmentClient = ReturnType<typeof createParchmentClient>;\n"],"mappings":"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","names":["options"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@purveyors/sdk",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "Typed client for the Purveyors Parchment API, generated from its OpenAPI spec.",
   "license": "MIT",
   "type": "module",