@purveyors/sdk 0.5.0 → 0.7.0

package/dist/index.d.ts

@@ -1271,6 +1271,205 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/market/signals": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Market value signals (actionable buy signals)
+         * @description Daily actionable value signals over market_signals. The unfiltered summary slice is public; item rows and filtered queries require Parchment Intelligence (ppiAccess).
+         */
+        get: {
+            parameters: {
+                query?: {
+                    page?: number;
+                    limit?: number;
+                    summary?: "true" | "false";
+                    type?: string | string[];
+                    origin?: string;
+                    process?: string;
+                    market?: "retail" | "wholesale" | "all";
+                    min_discount_pct?: number | null;
+                    min_score?: number | null;
+                    window?: "7d" | "30d";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description A page of market value signals (or a public summary) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MarketSignalsResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/price-index/stats": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Price movement significance stats
+         * @description Precomputed movement-significance stats over price_index_move_stats. The unfiltered retail slice is public; origin/process/wholesale filters require Parchment Intelligence (ppiAccess).
+         */
+        get: {
+            parameters: {
+                query?: {
+                    page?: number;
+                    limit?: number;
+                    origin?: string;
+                    process?: string;
+                    market?: "retail" | "wholesale" | "all";
+                    window?: "7d" | "30d";
+                    baseline_weeks?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description A page of price movement significance stats */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["PriceIndexStatsResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/market/metadata-index": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Metadata-trend index (process/disclosure/score over time)
+         * @description Metadata-trend index over metadata_index_snapshots. The process/retail/month slice is public; other dimensions, origins, and grains require Parchment Intelligence (ppiAccess).
+         */
+        get: {
+            parameters: {
+                query?: {
+                    page?: number;
+                    limit?: number;
+                    dimension?: "process" | "disclosure" | "score";
+                    origin?: string;
+                    market?: "retail" | "wholesale" | "all";
+                    grain?: "week" | "month";
+                    from?: string;
+                    to?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description A metadata-trend series */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MetadataIndexResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/catalog/{id}/similar": {
         parameters: {
             query?: never;
@@ -2601,7 +2800,77 @@ interface paths {
             };
         };
         post?: never;
-        delete?: never;
+        /**
+         * Clear a roast's Artisan import
+         * @description Remove import-derived temperature samples, event markers, and artisan_import_log rows from one of the caller's existing roasts without deleting the roast profile. Import-derived profile metrics are reset to manual/null values. Requires an authenticated session, or an owner-bound API key carrying the exact roast:write scope.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The cleared roast id plus deleted row counts */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RoastArtisanImportClearResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description No such roast profile owned by the caller */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Per-user mutation throttle exceeded; retry after a short wait */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Roast writes are not enabled in this environment */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
         options?: never;
         head?: never;
         patch?: never;
@@ -2778,6 +3047,7 @@ interface components {
             health: string;
             docs: string;
             openapi: string;
+            llms: string;
         };
         MeResponse: {
             authenticated: boolean;
@@ -2926,6 +3196,14 @@ interface components {
                     limited: boolean;
                     totalAvailable: number;
                 };
+                /** @description Freshness contract. `generatedAt` (ISO 8601) is the authoritative time this body was generated. `cacheStatus`/`ttlSeconds` are the resolved cache policy (ttl 0 for private/no-store); ttl is policy, not a promise — stale-while-revalidate may serve an older body, so trust `generatedAt` for actual age. */
+                freshness: {
+                    /** Format: date-time */
+                    generatedAt: string;
+                    /** @enum {string} */
+                    cacheStatus: "public" | "private";
+                    ttlSeconds: number;
+                };
                 /** @description Present only when requested filters/sorts were stripped because the caller lacked the capability. The request still returns 200 with the entitled subset applied. */
                 notices?: {
                     status: 401 | 403;
@@ -3045,6 +3323,14 @@ interface components {
                     stocked: boolean | null;
                     premiumMetadata: boolean;
                 };
+                /** @description Freshness contract. `generatedAt` (ISO 8601) is the authoritative time this body was generated. `cacheStatus`/`ttlSeconds` are the resolved cache policy (ttl 0 for private/no-store); ttl is policy, not a promise — stale-while-revalidate may serve an older body, so trust `generatedAt` for actual age. */
+                freshness: {
+                    /** Format: date-time */
+                    generatedAt: string;
+                    /** @enum {string} */
+                    cacheStatus: "public" | "private";
+                    ttlSeconds: number;
+                };
                 notices?: {
                     status: 401 | 403;
                     /** @enum {string} */
@@ -3088,6 +3374,14 @@ interface components {
                     scope: "retail" | "wholesale" | "all";
                     totalAvailable: number;
                 };
+                /** @description Freshness contract. `generatedAt` (ISO 8601) is the authoritative time this body was generated. `cacheStatus`/`ttlSeconds` are the resolved cache policy (ttl 0 for private/no-store); ttl is policy, not a promise — stale-while-revalidate may serve an older body, so trust `generatedAt` for actual age. */
+                freshness: {
+                    /** Format: date-time */
+                    generatedAt: string;
+                    /** @enum {string} */
+                    cacheStatus: "public" | "private";
+                    ttlSeconds: number;
+                };
             };
         };
         CatalogStatsResponse: {
@@ -3127,6 +3421,14 @@ interface components {
                     stocked: boolean | null;
                     totalAvailable: number;
                 };
+                /** @description Freshness contract. `generatedAt` (ISO 8601) is the authoritative time this body was generated. `cacheStatus`/`ttlSeconds` are the resolved cache policy (ttl 0 for private/no-store); ttl is policy, not a promise — stale-while-revalidate may serve an older body, so trust `generatedAt` for actual age. */
+                freshness: {
+                    /** Format: date-time */
+                    generatedAt: string;
+                    /** @enum {string} */
+                    cacheStatus: "public" | "private";
+                    ttlSeconds: number;
+                };
             };
         };
         CatalogRankedItem: {
@@ -3371,6 +3673,14 @@ interface components {
                     sampled: number;
                     totalAvailable: number;
                 };
+                /** @description Freshness contract. `generatedAt` (ISO 8601) is the authoritative time this body was generated. `cacheStatus`/`ttlSeconds` are the resolved cache policy (ttl 0 for private/no-store); ttl is policy, not a promise — stale-while-revalidate may serve an older body, so trust `generatedAt` for actual age. */
+                freshness: {
+                    /** Format: date-time */
+                    generatedAt: string;
+                    /** @enum {string} */
+                    cacheStatus: "public" | "private";
+                    ttlSeconds: number;
+                };
             };
             coverage: {
                 overall: {
@@ -3421,8 +3731,264 @@ interface components {
                 synthetic: boolean;
             };
         };
-        PriceIndexResponse: {
-            data: components["schemas"]["PriceIndexItem"][];
+        PriceIndexResponse: {
+            data: components["schemas"]["PriceIndexItem"][];
+            pagination: {
+                page: number;
+                limit: number;
+                total: number;
+                totalPages: number;
+                hasNext: boolean;
+                hasPrev: boolean;
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "price-index";
+                /** @enum {string} */
+                namespace: "/v1/price-index";
+                /** @enum {string} */
+                version: "v1";
+                auth: {
+                    /** @enum {string} */
+                    kind: "api-key";
+                    /** @enum {string|null} */
+                    apiPlan: "viewer" | "member" | "enterprise" | null;
+                    /** @enum {boolean} */
+                    ppiAccess: true;
+                };
+                filters: {
+                    origin: string | null;
+                    process: string | null;
+                    grade: string | null;
+                    from: string | null;
+                    to: string | null;
+                    wholesale: boolean | null;
+                };
+                access: {
+                    rowLimit: number | null;
+                    limited: boolean;
+                    totalAvailable: number;
+                };
+                source: {
+                    /** @enum {string} */
+                    table: "price_index_snapshots";
+                    /** @enum {boolean} */
+                    aggregateOnly: true;
+                };
+            };
+        };
+        MarketSignalEvidence: {
+            segment: {
+                origin: string | null;
+                process: string;
+                /** @enum {string} */
+                market: "retail" | "wholesale";
+            };
+            segment_median: number | null;
+            segment_p25: number | null;
+            discount_vs_median_pct: number | null;
+            price_percentile_in_segment: number | null;
+            /** @enum {string|null} */
+            own_trailing_window: "7d" | "30d" | null;
+            own_trailing_median: number | null;
+            drop_vs_own_median_pct: number | null;
+            score_value: number | null;
+            value_ratio: number | null;
+            origin_market_value_ratio_mean: number | null;
+            origin_market_value_ratio_stddev: number | null;
+            value_z_score: number | null;
+            as_of: string;
+        };
+        MarketSignalItem: {
+            /** @enum {string} */
+            signalType: "price_drop" | "below_market" | "value_quality";
+            /** @enum {string} */
+            signalWindow: "7d" | "30d" | "n/a";
+            catalogId: number;
+            source: string | null;
+            origin: string | null;
+            process: string;
+            /** @enum {string} */
+            market: "retail" | "wholesale";
+            scoreValue: number | null;
+            currentPriceLb: number;
+            rankScore: number;
+            /** @enum {string} */
+            rankScoreInput: "drop_vs_own_median_pct" | "discount_vs_median_pct" | "value_z_score";
+            rankSignalMagnitude: number;
+            evidence: components["schemas"]["MarketSignalEvidence"];
+            catalogUrl: string;
+        };
+        MarketSignalsResponse: {
+            data: components["schemas"]["MarketSignalItem"][];
+            pagination: {
+                page: number;
+                limit: number;
+                total: number;
+                totalPages: number;
+                hasNext: boolean;
+                hasPrev: boolean;
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "market-signals";
+                /** @enum {string} */
+                namespace: "/v1/market/signals";
+                /** @enum {string} */
+                version: "v1";
+                auth: {
+                    /** @enum {string} */
+                    kind: "anonymous" | "session" | "api-key";
+                    role: string | null;
+                    /** @enum {string|null} */
+                    apiPlan: "viewer" | "member" | "enterprise" | null;
+                    ppiAccess: boolean;
+                };
+                filters: {
+                    summary: boolean;
+                    types: ("price_drop" | "below_market" | "value_quality")[];
+                    origin: string | null;
+                    process: string | null;
+                    /** @enum {string} */
+                    market: "retail" | "wholesale" | "all";
+                    minDiscountPct: number | null;
+                    minScore: number | null;
+                    /** @enum {string} */
+                    window: "7d" | "30d";
+                };
+                access: {
+                    publicSlice: boolean;
+                    rowLimit: number | null;
+                    limited: boolean;
+                    totalAvailable: number;
+                };
+                asOf: string | null;
+                computedAt: string | null;
+                thresholds: {
+                    dropThresholdPct: number;
+                    valueZThreshold: number;
+                    benchmarkMinLots: number;
+                    benchmarkMinSuppliers: number;
+                };
+                summary: {
+                    total: number;
+                    byType: {
+                        price_drop: number;
+                        below_market: number;
+                        value_quality: number;
+                    };
+                } | null;
+                source: {
+                    /** @enum {string} */
+                    table: "market_signals";
+                    /** @enum {boolean} */
+                    aggregateOnly: true;
+                };
+            };
+        };
+        PriceMoveStatsItem: {
+            segment: {
+                origin: string | null;
+                process: string | null;
+                /** @enum {string} */
+                market: "retail" | "wholesale" | "all";
+            };
+            /** @enum {string} */
+            window: "7d" | "30d";
+            latestMovePct: number | null;
+            baselineMeanMovePct: number | null;
+            baselineStddev: number | null;
+            zScore: number | null;
+            movePercentile: number | null;
+            weeksSinceLargerMove: number | null;
+            /** @enum {string|null} */
+            classification: "quiet" | "normal" | "notable" | "exceptional" | null;
+            matchedLotMovePct: number | null;
+            matchedLotCount: number;
+            /** @enum {string|null} */
+            moveDriver: "repricing" | "mix_shift" | "mixed" | "insufficient_overlap" | null;
+            sampleSize: number;
+            supplierCount: number;
+            availableBaselineWeeks: number;
+            note: string | null;
+        };
+        PriceIndexStatsResponse: {
+            data: components["schemas"]["PriceMoveStatsItem"][];
+            pagination: {
+                page: number;
+                limit: number;
+                total: number;
+                totalPages: number;
+                hasNext: boolean;
+                hasPrev: boolean;
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "price-index-stats";
+                /** @enum {string} */
+                namespace: "/v1/price-index/stats";
+                /** @enum {string} */
+                version: "v1";
+                auth: {
+                    /** @enum {string} */
+                    kind: "anonymous" | "session" | "api-key";
+                    role: string | null;
+                    /** @enum {string|null} */
+                    apiPlan: "viewer" | "member" | "enterprise" | null;
+                    ppiAccess: boolean;
+                };
+                filters: {
+                    origin: string | null;
+                    process: string | null;
+                    /** @enum {string} */
+                    market: "retail" | "wholesale" | "all";
+                    /** @enum {string} */
+                    window: "7d" | "30d";
+                    baselineWeeks: number;
+                };
+                access: {
+                    publicSlice: boolean;
+                    rowLimit: number | null;
+                    limited: boolean;
+                    totalAvailable: number;
+                };
+                asOf: string | null;
+                computedAt: string | null;
+                thresholds: {
+                    baselineWeeks: number;
+                    minimumBaselineWeeks: number;
+                    quietPercentile: number;
+                    normalPercentile: number;
+                    notablePercentile: number;
+                    matchedLotMinimum: number;
+                };
+                source: {
+                    /** @enum {string} */
+                    table: "price_index_move_stats";
+                    /** @enum {boolean} */
+                    aggregateOnly: true;
+                };
+            };
+        };
+        MetadataSeriesItem: {
+            period: string;
+            lotCount: number;
+            supplierCount: number;
+            buckets: ({
+                key: string;
+                share: number | null;
+                count: number;
+                supplierCount: number;
+            } | {
+                /** @enum {string} */
+                key: "p25" | "p50" | "p75";
+                value: number | null;
+                count: number;
+                supplierCount: number;
+            })[];
+        };
+        MetadataIndexResponse: {
+            data: components["schemas"]["MetadataSeriesItem"][];
             pagination: {
                 page: number;
                 limit: number;
@@ -3433,35 +3999,53 @@ interface components {
             };
             meta: {
                 /** @enum {string} */
-                resource: "price-index";
+                resource: "market-metadata-index";
                 /** @enum {string} */
-                namespace: "/v1/price-index";
+                namespace: "/v1/market/metadata-index";
                 /** @enum {string} */
                 version: "v1";
                 auth: {
                     /** @enum {string} */
-                    kind: "api-key";
+                    kind: "anonymous" | "session" | "api-key";
+                    role: string | null;
                     /** @enum {string|null} */
                     apiPlan: "viewer" | "member" | "enterprise" | null;
-                    /** @enum {boolean} */
-                    ppiAccess: true;
+                    ppiAccess: boolean;
                 };
                 filters: {
+                    /** @enum {string} */
+                    dimension: "process" | "disclosure" | "score";
                     origin: string | null;
-                    process: string | null;
-                    grade: string | null;
+                    /** @enum {string} */
+                    market: "retail" | "wholesale" | "all";
+                    /** @enum {string} */
+                    grain: "week" | "month";
                     from: string | null;
                     to: string | null;
-                    wholesale: boolean | null;
                 };
                 access: {
+                    publicSlice: boolean;
                     rowLimit: number | null;
                     limited: boolean;
                     totalAvailable: number;
                 };
+                asOf: string | null;
+                computedAt: string | null;
+                thresholds: {
+                    originSuppressionMinLots: number;
+                    publicSlice: {
+                        /** @enum {string} */
+                        dimension: "process";
+                        origin: null;
+                        /** @enum {string} */
+                        market: "retail";
+                        /** @enum {string} */
+                        grain: "month";
+                    };
+                };
                 source: {
                     /** @enum {string} */
-                    table: "price_index_snapshots";
+                    table: "metadata_index_snapshots";
                     /** @enum {boolean} */
                     aggregateOnly: true;
                 };
@@ -4185,6 +4769,34 @@ interface components {
             /** @description Reported source size in bytes for import-log metadata; defaults to the content length. */
             fileSize?: number;
         };
+        RoastArtisanImportClearCounts: {
+            artisan_import_log: number;
+            roast_events: number;
+            roast_temperatures: number;
+        };
+        RoastArtisanImportClearResponse: {
+            data: {
+                id: number;
+                deletedCounts: components["schemas"]["RoastArtisanImportClearCounts"];
+                batchName: string | null;
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "roasts";
+                /** @enum {string} */
+                namespace: "/v1/roasts";
+                /** @enum {string} */
+                version: "v1";
+                auth: {
+                    /** @enum {string} */
+                    kind: "session" | "api-key";
+                    /** @enum {string|null} */
+                    role: "admin" | "member" | "viewer" | null;
+                    /** @enum {string|null} */
+                    apiPlan: "viewer" | "member" | "enterprise" | null;
+                };
+            };
+        };
         RoastListResource: {
             roast_id: number;
             batch_name: string | null;
@@ -4377,6 +4989,12 @@ type CatalogSupplierHeaders = NonNullable<paths["/v1/catalog/suppliers"]["get"][
 type CatalogSimilarQuery = NonNullable<paths["/v1/catalog/{id}/similar"]["get"]["parameters"]["query"]>;
 /** Query parameters for {@link ParchmentClient.priceIndex.list}. */
 type PriceIndexQuery = NonNullable<paths["/v1/price-index"]["get"]["parameters"]["query"]>;
+/** Query parameters for {@link ParchmentClient.market.signals}. */
+type MarketSignalsQuery = NonNullable<paths["/v1/market/signals"]["get"]["parameters"]["query"]>;
+/** Query parameters for {@link ParchmentClient.priceIndex.stats}. */
+type PriceIndexStatsQuery = NonNullable<paths["/v1/price-index/stats"]["get"]["parameters"]["query"]>;
+/** Query parameters for {@link ParchmentClient.market.metadataIndex}. */
+type MetadataIndexQuery = NonNullable<paths["/v1/market/metadata-index"]["get"]["parameters"]["query"]>;
 /** Query parameters for {@link ParchmentClient.procurement.briefs.matches}. */
 type BriefMatchesQuery = NonNullable<paths["/v1/procurement/briefs/{id}/matches"]["get"]["parameters"]["query"]>;
 /** Request body for {@link ParchmentClient.procurement.briefs.create}. */
@@ -4673,7 +5291,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"] /** Rotate an API key and return the replacement secret once. */["ErrorResponse"];
                     };
                 };
             };
@@ -4792,12 +5410,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": 
-                        /**
-                         * Delete one of the caller's own inventory rows. Returns 409 if dependent
-                         * roast profiles or sales exist (no force-cascade).
-                         */
-                        components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
                 404: {
@@ -4906,7 +5519,12 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     page?: number;
                     limit?: number;
                     stocked?: "true" | "false" | "all";
-                    sort?: string;
+                    sort? /**
+                     * Replace the Artisan import data on one of the caller's existing roasts,
+                     * re-deriving its curve, events, and computed metrics while preserving the
+                     * roast's identity. Pass `ifMatch` (the roast's `last_updated`) to enable
+                     * optimistic concurrency (409 on mismatch).
+                     */: string;
                     order?: "asc" | "desc";
                     showWholesale?: "true" | "false";
                     wholesaleOnly?: "true" | "false";
@@ -4923,7 +5541,10 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     appearance?: string;
                     supplier?: string;
                     dryingMethod?: string;
-                    flavorKeywords?: string | string[];
+                    flavorKeywords? /**
+                     * Clear import-derived curve, events, metrics, and provenance data from
+                     * one of the caller's existing roasts without deleting the roast profile.
+                     */: string | string[];
                     arrivalDate?: string;
                     stockedDate?: string;
                     stockedDays?: number;
@@ -5764,6 +6385,184 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 } | undefined;
             };
         }, `${string}/${string}`>>;
+        /** Price movement significance stats (precomputed). */
+        stats: (query?: PriceIndexStatsQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    page?: number;
+                    limit?: number;
+                    origin?: string;
+                    process?: string;
+                    market?: "retail" | "wholesale" | "all";
+                    window?: "7d" | "30d";
+                    baseline_weeks?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["PriceIndexStatsResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                query: {
+                    page?: number;
+                    limit?: number;
+                    origin?: string;
+                    process?: string;
+                    market?: "retail" | "wholesale" | "all";
+                    window?: "7d" | "30d";
+                    baseline_weeks?: number;
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+    };
+    market: {
+        /** Actionable market value signals. */
+        signals: (query?: MarketSignalsQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    page?: number;
+                    limit?: number;
+                    summary?: "true" | "false";
+                    type?: string | string[];
+                    origin?: string;
+                    process?: string;
+                    market?: "retail" | "wholesale" | "all";
+                    min_discount_pct?: number | null;
+                    min_score?: number | null;
+                    window?: "7d" | "30d";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MarketSignalsResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                query: {
+                    page?: number;
+                    limit?: number;
+                    summary?: "true" | "false";
+                    type?: string | string[];
+                    origin?: string;
+                    process?: string;
+                    market?: "retail" | "wholesale" | "all";
+                    min_discount_pct?: number | null;
+                    min_score?: number | null;
+                    window?: "7d" | "30d";
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+        /** Metadata-trend index (process/disclosure/score over time). */
+        metadataIndex: (query?: MetadataIndexQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    page?: number;
+                    limit?: number;
+                    dimension?: "process" | "disclosure" | "score";
+                    origin?: string;
+                    market?: "retail" | "wholesale" | "all";
+                    grain?: "week" | "month";
+                    from?: string;
+                    to?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MetadataIndexResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                query: {
+                    page?: number;
+                    limit?: number;
+                    dimension?: "process" | "disclosure" | "score";
+                    origin?: string;
+                    market?: "retail" | "wholesale" | "all";
+                    grain?: "week" | "month";
+                    from?: string;
+                    to?: string;
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
     };
     procurement: {
         briefs: {
@@ -7060,6 +7859,77 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 fileSize?: number;
             };
         }, `${string}/${string}`>>;
+        /**
+         * Clear import-derived curve, events, metrics, and provenance data from
+         * one of the caller's existing roasts without deleting the roast profile.
+         */
+        clearArtisanImport: (id: number) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RoastArtisanImportClearResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                path: {
+                    id: number;
+                };
+            };
+        }, `${string}/${string}`>>;
     };
     sales: {
         /** List the caller's own sales (owner-scoped). */
@@ -7195,4 +8065,4 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
 };
 type ParchmentClient = ReturnType<typeof createParchmentClient>;
 
-export { type BriefMatchesQuery, type CatalogListQuery, type CatalogSimilarQuery, type InventoryCreateRequest, type InventoryUpdateRequest, type ParchmentClient, type ParchmentClientOptions, type PriceIndexQuery, type SourcingBriefCreateRequest, type components, createParchmentClient, type paths };
+export { type BriefMatchesQuery, type CatalogListQuery, type CatalogSimilarQuery, type InventoryCreateRequest, type InventoryUpdateRequest, type MarketSignalsQuery, type MetadataIndexQuery, type ParchmentClient, type ParchmentClientOptions, type PriceIndexQuery, type PriceIndexStatsQuery, type SourcingBriefCreateRequest, type components, createParchmentClient, type paths };

package/dist/index.js

@@ -76,7 +76,15 @@ function createParchmentClient(options) {
     },
     priceIndex: {
       /** Parchment Price Index (aggregate snapshots). */
-      list: (query) => client.GET("/v1/price-index", { params: { query } })
+      list: (query) => client.GET("/v1/price-index", { params: { query } }),
+      /** Price movement significance stats (precomputed). */
+      stats: (query) => client.GET("/v1/price-index/stats", { params: { query } })
+    },
+    market: {
+      /** Actionable market value signals. */
+      signals: (query) => client.GET("/v1/market/signals", { params: { query } }),
+      /** Metadata-trend index (process/disclosure/score over time). */
+      metadataIndex: (query) => client.GET("/v1/market/metadata-index", { params: { query } })
     },
     procurement: {
       briefs: {
@@ -177,6 +185,13 @@ function createParchmentClient(options) {
           header: options2?.ifMatch ? { "if-match": options2.ifMatch } : void 0
         },
         body
+      }),
+      /**
+       * Clear import-derived curve, events, metrics, and provenance data from
+       * one of the caller's existing roasts without deleting the roast profile.
+       */
+      clearArtisanImport: (id) => client.DELETE("/v1/roasts/{id}/artisan-import", {
+        params: { path: { id } }
       })
     },
     sales: {

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/** 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.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.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.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/** 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.apiKeys.create}. */\nexport type ApiKeyCreateRequest = NonNullable<\n  paths[\"/v1/api-keys\"][\"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    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    },\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    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      /** 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    sales: {\n      /** List the caller's own sales (owner-scoped). */\n      list: (query?: SalesListQuery) =>\n        client.GET(\"/v1/sales\", { params: { query } }),\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    },\n  };\n}\n\nexport type ParchmentClient = ReturnType<typeof createParchmentClient>;\n"],"mappings":";AAAA,OAAO,kBAA0C;AAqJ1C,SAAS,sBAAsB,SAAiC;AACrE,QAAM,EAAE,SAAS,OAAO,OAAO,UAAU,IAAI;AAE7C,QAAM,SAAS,aAAoB;AAAA,IACjC;AAAA,IACA,OAAO;AAAA,IACP,SAAS,QAAQ,EAAE,eAAe,UAAU,KAAK,GAAG,IAAI;AAAA,EAC1D,CAAC;AAED,SAAO;AAAA;AAAA,IAEL,KAAK;AAAA;AAAA,IAEL,QAAQ,MAAM,OAAO,IAAI,SAAS;AAAA;AAAA,IAElC,IAAI,MAAM,OAAO,IAAI,QAAQ;AAAA,IAC7B,SAAS;AAAA;AAAA,MAEP,MAAM,MAAM,OAAO,IAAI,cAAc;AAAA;AAAA,MAErC,QAAQ,CAAC,SACP,OAAO,KAAK,gBAAgB,EAAE,KAAK,CAAC;AAAA;AAAA,MAEtC,QAAQ,CAAC,OACP,OAAO,OAAO,qBAAqB;AAAA,QACjC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE;AAAA,MACzB,CAAC;AAAA;AAAA,MAEH,QAAQ,CAAC,OACP,OAAO,KAAK,4BAA4B;AAAA,QACtC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE;AAAA,MACzB,CAAC;AAAA,IACL;AAAA,IACA,SAAS;AAAA;AAAA,MAEP,QAAQ,MAAM,OAAO,IAAI,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA,MAK7C,MAAM,CAAC,OAA0B,YAC/B,OAAO,IAAI,eAAe,EAAE,QAAQ,EAAE,OAAO,QAAQ,QAAQ,EAAE,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,MAKlE,QAAQ,CAAC,OAA4B,YACnC,OAAO,IAAI,sBAAsB;AAAA,QAC/B,QAAQ,EAAE,OAAO,QAAQ,QAAQ;AAAA,MACnC,CAAC;AAAA;AAAA,MAEH,kBAAkB,CAAC,UACjB,OAAO,IAAI,kCAAkC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAAA;AAAA,MAEpE,OAAO,CAAC,UACN,OAAO,IAAI,qBAAqB,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAAA;AAAA,MAEvD,MAAM,CAAC,OAA0B,YAC/B,OAAO,IAAI,oBAAoB;AAAA,QAC7B,QAAQ,EAAE,OAAO,QAAQ,QAAQ;AAAA,MACnC,CAAC;AAAA;AAAA,MAEH,aAAa,CACX,OACA,YAEA,OAAO,IAAI,4BAA4B;AAAA,QACrC,QAAQ,EAAE,OAAO,QAAQ,QAAQ;AAAA,MACnC,CAAC;AAAA;AAAA,MAEH,WAAW,CACT,OACA,YAEA,OAAO,IAAI,yBAAyB;AAAA,QAClC,QAAQ,EAAE,OAAO,QAAQ,QAAQ;AAAA,MACnC,CAAC;AAAA;AAAA,MAEH,gBAAgB,CACd,OACA,YAEA,OAAO,IAAI,gCAAgC;AAAA,QACzC,QAAQ,EAAE,OAAO,QAAQ,QAAQ;AAAA,MACnC,CAAC;AAAA;AAAA,MAEH,cAAc,CACZ,OACA,YAEA,OAAO,IAAI,8BAA8B;AAAA,QACvC,QAAQ,EAAE,OAAO,QAAQ,QAAQ;AAAA,MACnC,CAAC;AAAA;AAAA,MAEH,eAAe,MAAM,OAAO,IAAI,4BAA4B;AAAA;AAAA,MAE5D,SAAS,CAAC,IAAY,UACpB,OAAO,IAAI,4BAA4B;AAAA,QACrC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAG,MAAM;AAAA,MAChC,CAAC;AAAA,IACL;AAAA,IACA,YAAY;AAAA;AAAA,MAEV,MAAM,CAAC,UACL,OAAO,IAAI,mBAAmB,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAAA,IACvD;AAAA,IACA,aAAa;AAAA,MACX,QAAQ;AAAA;AAAA,QAEN,MAAM,MAAM,OAAO,IAAI,wBAAwB;AAAA;AAAA,QAE/C,QAAQ,CAAC,SACP,OAAO,KAAK,0BAA0B,EAAE,KAAK,CAAC;AAAA;AAAA,QAEhD,KAAK,CAAC,OACJ,OAAO,IAAI,+BAA+B;AAAA,UACxC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE;AAAA,QACzB,CAAC;AAAA;AAAA,QAEH,SAAS,CAAC,IAAY,UACpB,OAAO,IAAI,uCAAuC;AAAA,UAChD,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAG,MAAM;AAAA,QAChC,CAAC;AAAA,MACL;AAAA,IACF;AAAA,IACA,WAAW;AAAA;AAAA,MAET,MAAM,CAAC,UACL,OAAO,IAAI,iBAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAOnD,QAAQ,CACN,MACAA,aAEA,OAAO,KAAK,iBAAiB;AAAA,QAC3B;AAAA,QACA,QAAQA,UAAS,iBACb,EAAE,QAAQ,EAAE,mBAAmBA,SAAQ,eAAe,EAAE,IACxD;AAAA,MACN,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,MAKH,QAAQ,CACN,IACA,MACAA,aAEA,OAAO,MAAM,sBAAsB;AAAA,QACjC,QAAQ;AAAA,UACN,MAAM,EAAE,GAAG;AAAA,UACX,QAAQA,UAAS,UACb,EAAE,YAAYA,SAAQ,QAAQ,IAC9B;AAAA,QACN;AAAA,QACA;AAAA,MACF,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,MAKH,QAAQ,CAAC,OACP,OAAO,OAAO,sBAAsB,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;AAAA,IACpE;AAAA,IACA,QAAQ;AAAA;AAAA,MAEN,MAAM,CAAC,UACL,OAAO,IAAI,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,MAKhD,KAAK,CAAC,IAAY,UAChB,OAAO,IAAI,mBAAmB,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMnE,QAAQ,CACN,MACAA,aAEA,OAAO,KAAK,cAAc;AAAA,QACxB;AAAA,QACA,QAAQA,UAAS,iBACb,EAAE,QAAQ,EAAE,mBAAmBA,SAAQ,eAAe,EAAE,IACxD;AAAA,MACN,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,MAKH,QAAQ,CACN,IACA,MACAA,aAEA,OAAO,MAAM,mBAAmB;AAAA,QAC9B,QAAQ;AAAA,UACN,MAAM,EAAE,GAAG;AAAA,UACX,QAAQA,UAAS,UACb,EAAE,YAAYA,SAAQ,QAAQ,IAC9B;AAAA,QACN;AAAA,QACA;AAAA,MACF,CAAC;AAAA;AAAA,MAEH,QAAQ,CAAC,OACP,OAAO,OAAO,mBAAmB,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAQ/D,QAAQ,CACN,MACAA,aAEA,OAAO,KAAK,sBAAsB;AAAA,QAChC;AAAA,QACA,QAAQA,UAAS,iBACb,EAAE,QAAQ,EAAE,mBAAmBA,SAAQ,eAAe,EAAE,IACxD;AAAA,MACN,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAOH,sBAAsB,CACpB,IACA,MACAA,aAEA,OAAO,IAAI,kCAAkC;AAAA,QAC3C,QAAQ;AAAA,UACN,MAAM,EAAE,GAAG;AAAA,UACX,QAAQA,UAAS,UACb,EAAE,YAAYA,SAAQ,QAAQ,IAC9B;AAAA,QACN;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACL;AAAA,IACA,OAAO;AAAA;AAAA,MAEL,MAAM,CAAC,UACL,OAAO,IAAI,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAAA,IACjD;AAAA,IACA,SAAS;AAAA;AAAA,MAEP,KAAK,CAAC,WAAmB,UACvB,OAAO,IAAI,2BAA2B;AAAA,QACpC,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM;AAAA,MACvC,CAAC;AAAA,IACL;AAAA,EACF;AACF;","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/** 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.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.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/** 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.apiKeys.create}. */\nexport type ApiKeyCreateRequest = NonNullable<\n  paths[\"/v1/api-keys\"][\"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    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/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    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      /** 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    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    },\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.5.0",
+  "version": "0.7.0",
   "description": "Typed client for the Purveyors Parchment API, generated from its OpenAPI spec.",
   "license": "MIT",
   "type": "module",