@purveyors/sdk 0.0.0 → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1295 @@
+import * as openapi_fetch from 'openapi-fetch';
+import { ClientOptions } from 'openapi-fetch';
+
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+interface paths {
+    "/health": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Liveness and service identity */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Service is healthy */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["HealthResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Service discovery document */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Discovery document with pointers to docs and the spec */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["DiscoveryResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/me": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Resolved principal and entitlements for the caller */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The caller's principal (anonymous if unauthenticated) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MeResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/catalog/access": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Catalog capabilities and visibility for the caller */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Resolved catalog access policy for the caller's principal */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogAccessResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/catalog": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List public catalog coffees
+         * @description Public catalog listing. Excludes wholesale-restricted rows and returns only public fields. API-key callers are capped to their plan's per-call row limit.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    page?: number;
+                    limit?: number;
+                    stocked?: "true" | "false" | "all";
+                    sort?: string;
+                    order?: "asc" | "desc";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description A page of public catalog rows with pagination + meta */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogListResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/catalog/proof-coverage": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Aggregate proof-coverage over the public catalog
+         * @description Aggregate-only proof coverage (no row-level evidence) computed over the stocked public catalog.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Proof-coverage summary with per-family buckets and gaps */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogProofCoverageResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/price-index": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Parchment Price Index (aggregate snapshots)
+         * @description Aggregate-only price index over price_index_snapshots. Requires an API key with Parchment Intelligence (ppiAccess).
+         */
+        get: {
+            parameters: {
+                query?: {
+                    page?: number;
+                    limit?: number;
+                    origin?: string;
+                    process?: string;
+                    grade?: string;
+                    from?: string;
+                    to?: string;
+                    wholesale?: "true" | "false";
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description A page of aggregate price-index snapshots */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["PriceIndexResponse"];
+                    };
+                };
+                /** @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;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Find catalog coffees similar to a target coffee
+         * @description Vector-similarity matches for a target catalog coffee, with deterministic identity gating, supplier-diversity re-ranking, and a canonical/similar split. Requires the bean-matching capability (a member session or a paid API plan).
+         */
+        get: {
+            parameters: {
+                query?: {
+                    threshold?: string;
+                    limit?: number;
+                    stocked_only?: "true" | "false";
+                    mode?: "all" | "likely_same" | "similar_profile";
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Target coffee with grouped similarity matches */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogSimilarityResponse"];
+                    };
+                };
+                /** @description Invalid path id or query parameter */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Catalog coffee not found */
+                404: {
+                    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/procurement/briefs": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List saved sourcing briefs
+         * @description List the authenticated principal's active sourcing briefs. Requires a member session or a paid (member+) API plan; API keys also need the catalog:read scope.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The principal's active sourcing briefs */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["SourcingBriefsListResponse"];
+                    };
+                };
+                /** @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;
+        /**
+         * Create a sourcing brief
+         * @description Create a saved sourcing brief for the authenticated principal. Requires a member session or a paid (member+) API plan; API keys also need the catalog:read scope.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["SourcingBriefCreateRequest"];
+                };
+            };
+            responses: {
+                /** @description The created sourcing brief */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["SourcingBriefResponse"];
+                    };
+                };
+                /** @description Invalid request body or unsupported criteria */
+                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"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/procurement/briefs/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a sourcing brief
+         * @description Fetch one of the authenticated principal's sourcing briefs by id. Requires a member session or a paid (member+) API plan; API keys also need the catalog:read scope.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The requested sourcing brief */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["SourcingBriefResponse"];
+                    };
+                };
+                /** @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 brief for this principal */
+                404: {
+                    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/procurement/briefs/{id}/matches": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Run a sourcing brief against the catalog
+         * @description Return the catalog coffees that satisfy a saved brief's criteria, each annotated with the deterministic reasons it matched. Requires a member session or a paid (member+) API plan; API keys also need the catalog:read scope.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    page?: number;
+                    limit?: number;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description A page of catalog matches for the brief */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["SourcingBriefMatchesResponse"];
+                    };
+                };
+                /** @description Invalid pagination parameter */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description No such brief for this principal */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+interface components {
+    schemas: {
+        HealthResponse: {
+            /** @enum {string} */
+            status: "ok";
+            /** @enum {string} */
+            service: "parchment-api";
+            version: string;
+            /** Format: date-time */
+            timestamp: string;
+        };
+        DiscoveryResponse: {
+            /** @enum {string} */
+            product: "Parchment";
+            namespace: string;
+            health: string;
+            docs: string;
+            openapi: string;
+        };
+        MeResponse: {
+            authenticated: boolean;
+            /** @enum {string} */
+            authKind: "anonymous" | "session" | "api-key";
+            userId: string | null;
+            appRoles: string[];
+            primaryAppRole: string | null;
+            /** @enum {string|null} */
+            apiPlan: "viewer" | "member" | "enterprise" | null;
+            ppiAccess: boolean;
+            apiScopes: string[];
+        };
+        CatalogAccessResponse: {
+            visibility: {
+                isPrivilegedSession: boolean;
+                publicOnly: boolean;
+                showWholesale: boolean;
+                wholesaleOnly: boolean;
+            };
+            capabilities: {
+                canViewPublicCatalog: boolean;
+                canViewFullCatalog: boolean;
+                canViewWholesale: boolean;
+                canUseBasicFilters: boolean;
+                canUseAdvancedFilters: boolean;
+                canUseProcessFacets: boolean;
+                canUsePriceScoreRanges: boolean;
+                canUseAdvancedSorts: boolean;
+                canViewPremiumFilterMetadata: boolean;
+                canUseSemanticSearch: boolean;
+                canUseBeanMatching: boolean;
+                canUseSavedSearches: boolean;
+                canExport: boolean;
+            };
+        };
+        CatalogItem: {
+            id: number;
+            name?: string | null;
+            source?: string | null;
+            continent?: string | null;
+            country?: string | null;
+            region?: string | null;
+            processing?: string | null;
+            cultivar_detail?: string | null;
+            type?: string | null;
+            grade?: string | null;
+            appearance?: string | null;
+            score_value?: number | null;
+            cost_lb?: number | null;
+            price_per_lb?: number | null;
+            arrival_date?: string | null;
+            stocked_date?: string | null;
+            stocked?: boolean | null;
+        };
+        CatalogListResponse: {
+            data: components["schemas"]["CatalogItem"][];
+            pagination: {
+                page: number;
+                limit: number;
+                total: number;
+                totalPages: number;
+                hasNext: boolean;
+                hasPrev: boolean;
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "catalog";
+                /** @enum {string} */
+                namespace: "/v1/catalog";
+                /** @enum {string} */
+                version: "v1";
+                auth: {
+                    /** @enum {string} */
+                    kind: "anonymous" | "session" | "api-key";
+                    /** @enum {string|null} */
+                    role: "viewer" | "member" | "admin" | null;
+                    /** @enum {string|null} */
+                    apiPlan: "viewer" | "member" | "enterprise" | null;
+                };
+                access: {
+                    publicOnly: boolean;
+                    rowLimit: number | null;
+                    limited: boolean;
+                    totalAvailable: number;
+                };
+            };
+        };
+        CatalogProofCoverageResponse: {
+            meta: {
+                /** @enum {string} */
+                resource: "catalog-proof-coverage";
+                /** @enum {string} */
+                namespace: "/v1/catalog/proof-coverage";
+                /** @enum {string} */
+                version: "v1";
+                auth: {
+                    /** @enum {string} */
+                    kind: "anonymous" | "session" | "api-key";
+                    /** @enum {string|null} */
+                    role: "viewer" | "member" | "admin" | null;
+                    /** @enum {string|null} */
+                    apiPlan: "viewer" | "member" | "enterprise" | null;
+                };
+                access: {
+                    publicOnly: boolean;
+                    sampled: number;
+                    totalAvailable: number;
+                };
+            };
+            coverage: {
+                overall: {
+                    label: string;
+                    count: number;
+                    share: number;
+                }[];
+                families: {
+                    [key: string]: {
+                        label: string;
+                        count: number;
+                        share: number;
+                    }[];
+                };
+                signals: {
+                    [key: string]: number;
+                };
+                top_gaps: {
+                    family: string;
+                    label: string;
+                    count: number;
+                    share: number;
+                }[];
+                limitations: string[];
+            };
+        };
+        PriceIndexItem: {
+            date: string;
+            origin: string;
+            process: string | null;
+            grade: string | null;
+            wholesale: boolean;
+            price: {
+                min: number | null;
+                max: number | null;
+                avg: number | null;
+                median: number | null;
+                p25: number | null;
+                p75: number | null;
+                stdev: number | null;
+            };
+            sample: {
+                suppliers: number;
+                listings: number;
+                aggregationTier: number | null;
+            };
+            provenance: {
+                synthetic: boolean;
+            };
+        };
+        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;
+                };
+            };
+        };
+        ErrorResponse: {
+            error: {
+                code: string;
+                message: string;
+            };
+        };
+        CatalogSimilarityTarget: {
+            id: number;
+            name: string;
+            source: string | null;
+            origin: string | null;
+            country: string | null;
+            continent: string | null;
+            processing: string | null;
+            processing_base_method: string | null;
+            fermentation_type: string | null;
+            drying_method: string | null;
+            stocked: boolean | null;
+            arrival_date: string | null;
+            stocked_date: string | null;
+            price_per_lb: number | null;
+            price_tiers?: unknown;
+            cost_lb: number | null;
+            pricing: {
+                price_per_lb: number | null;
+                price_tiers?: unknown;
+                cost_lb: number | null;
+                /** @enum {number} */
+                baseline_quantity_lbs: 1;
+                baseline_price_per_lb: number | null;
+                /** @enum {string|null} */
+                baseline_source: "price_per_lb" | "price_tiers" | "cost_lb" | null;
+            };
+            proof: {
+                /** @enum {string} */
+                version: "proof-summary-v1";
+                overall: {
+                    /** @enum {string} */
+                    label: "strong" | "partial" | "limited" | "not_available";
+                    families_with_signals: number;
+                };
+                families: {
+                    process: {
+                        label: string;
+                        confidence: number | null;
+                        signals: string[];
+                        message: string;
+                    };
+                    provenance: {
+                        label: string;
+                        confidence: number | null;
+                        signals: string[];
+                        message: string;
+                    };
+                    freshness: {
+                        label: string;
+                        confidence: number | null;
+                        signals: string[];
+                        message: string;
+                    };
+                    pricing: {
+                        label: string;
+                        confidence: number | null;
+                        signals: string[];
+                        message: string;
+                    };
+                };
+                limitations: string[];
+            };
+        };
+        CatalogSimilarityMatch: {
+            coffee: {
+                id: number;
+                name: string;
+                source: string | null;
+                origin: string | null;
+                country: string | null;
+                continent: string | null;
+                processing: string | null;
+                processing_base_method: string | null;
+                fermentation_type: string | null;
+                drying_method: string | null;
+                stocked: boolean | null;
+                arrival_date: string | null;
+                stocked_date: string | null;
+                proof: {
+                    /** @enum {string} */
+                    version: "proof-summary-v1";
+                    overall: {
+                        /** @enum {string} */
+                        label: "strong" | "partial" | "limited" | "not_available";
+                        families_with_signals: number;
+                    };
+                    families: {
+                        process: {
+                            label: string;
+                            confidence: number | null;
+                            signals: string[];
+                            message: string;
+                        };
+                        provenance: {
+                            label: string;
+                            confidence: number | null;
+                            signals: string[];
+                            message: string;
+                        };
+                        freshness: {
+                            label: string;
+                            confidence: number | null;
+                            signals: string[];
+                            message: string;
+                        };
+                        pricing: {
+                            label: string;
+                            confidence: number | null;
+                            signals: string[];
+                            message: string;
+                        };
+                    };
+                    limitations: string[];
+                };
+            };
+            pricing: {
+                price_per_lb: number | null;
+                price_tiers?: unknown;
+                cost_lb: number | null;
+                /** @enum {number} */
+                baseline_quantity_lbs: 1;
+                baseline_price_per_lb: number | null;
+                /** @enum {string|null} */
+                baseline_source: "price_per_lb" | "price_tiers" | "cost_lb" | null;
+            };
+            price_delta_1lb: {
+                amount: number | null;
+                percent: number | null;
+                /** @enum {string} */
+                currency: "USD";
+            };
+            score: {
+                average: number;
+                dimensions: {
+                    origin: number | null;
+                    processing: number | null;
+                    tasting: number | null;
+                };
+                chunk_matches: number;
+            };
+            match: {
+                /** @enum {string} */
+                category: "likely_same" | "similar_profile";
+                classification: {
+                    /** @enum {string} */
+                    kind: "canonical_candidate" | "similar_recommendation";
+                    /** @enum {string} */
+                    identity_eligibility: "eligible" | "blocked" | "insufficient_evidence";
+                    /** @enum {string} */
+                    confidence: "high_beta" | "medium_beta" | "low_beta";
+                    blockers: {
+                        code: string;
+                        /** @enum {string} */
+                        severity: "hard" | "soft";
+                        target_value: string | null;
+                        candidate_value: string | null;
+                    }[];
+                    evidence: string[];
+                };
+                /** @enum {string} */
+                confidence: "high_beta" | "medium_beta" | "low_beta";
+                /** @enum {boolean} */
+                beta: true;
+                language: string;
+                same_supplier: boolean;
+            };
+            explanation: {
+                summary: string;
+                signals: string[];
+            };
+            compatibility: {
+                cost_lb: number | null;
+            };
+        };
+        CatalogSimilarityResponse: {
+            data: {
+                target: components["schemas"]["CatalogSimilarityTarget"];
+                groups: {
+                    canonical_candidates: components["schemas"]["CatalogSimilarityMatch"][];
+                    similar_recommendations: components["schemas"]["CatalogSimilarityMatch"][];
+                };
+                matches: components["schemas"]["CatalogSimilarityMatch"][];
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "catalog-similarity";
+                /** @enum {string} */
+                namespace: "/v1/catalog/{id}/similar";
+                /** @enum {string} */
+                version: "v1";
+                /** @enum {string} */
+                status: "beta";
+                auth: {
+                    /** @enum {string} */
+                    kind: "session" | "api-key";
+                    /** @enum {string|null} */
+                    role: "viewer" | "member" | "admin" | null;
+                    /** @enum {string|null} */
+                    apiPlan: "viewer" | "member" | "enterprise" | null;
+                };
+                access: {
+                    /** @enum {string} */
+                    requiredCapability: "canUseBeanMatching";
+                    /** @enum {boolean} */
+                    canUseBeanMatching: true;
+                };
+                query: {
+                    threshold: number;
+                    limit: number;
+                    stockedOnly: boolean;
+                    /** @enum {string} */
+                    mode: "all" | "likely_same" | "similar_profile";
+                };
+                copy: {
+                    confidence: string;
+                };
+                /** @enum {string} */
+                classification_version: "canonical-match-v1";
+                /** @enum {string} */
+                query_strategy: "bounded-vector-candidates-v1" | "canonical-vector-aggregated-v2" | "legacy-vector-aggregated-v1";
+            };
+        };
+        SourcingBriefCriteria: {
+            /** @enum {number} */
+            version?: 1;
+            country?: string;
+            region?: string;
+            processing?: string;
+            processing_base_method?: string;
+            max_price_per_lb?: number;
+            stocked_only?: boolean;
+            wholesale_only?: boolean;
+            stocked_days?: number;
+        };
+        SourcingBriefResource: {
+            id: string;
+            name: string;
+            criteria: components["schemas"]["SourcingBriefCriteria"] & Record<string, never>;
+            /** @enum {string} */
+            cadence: "manual";
+            isActive: boolean;
+            lastRunAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+        };
+        SourcingBriefsListResponse: {
+            data: components["schemas"]["SourcingBriefResource"][];
+            meta: {
+                /** @enum {string} */
+                resource: "procurement-briefs";
+                /** @enum {string} */
+                namespace: "/v1/procurement/briefs";
+                /** @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;
+                };
+            };
+        };
+        SourcingBriefResponse: {
+            data: components["schemas"]["SourcingBriefResource"];
+            meta: {
+                /** @enum {string} */
+                resource: "procurement-brief";
+                /** @enum {string} */
+                namespace: "/v1/procurement/briefs" | "/v1/procurement/briefs/:id";
+                /** @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;
+                };
+            };
+        };
+        SourcingBriefCreateRequest: {
+            /** @description Human label, 1-120 chars. */
+            name: string;
+            criteria: components["schemas"]["SourcingBriefCriteria"] & unknown;
+            /** @enum {string} */
+            cadence?: "manual";
+        };
+        SourcingBriefMatch: {
+            id: number;
+            name?: string | null;
+            source?: string | null;
+            continent?: string | null;
+            country?: string | null;
+            region?: string | null;
+            processing?: string | null;
+            processing_base_method?: string | null;
+            fermentation_type?: string | null;
+            drying_method?: string | null;
+            cultivar_detail?: string | null;
+            type?: string | null;
+            grade?: string | null;
+            appearance?: string | null;
+            score_value?: number | null;
+            purveyor_score?: number | null;
+            cost_lb?: number | null;
+            price_per_lb?: number | null;
+            price_tiers?: unknown;
+            arrival_date?: string | null;
+            stocked_date?: string | null;
+            stocked?: boolean | null;
+            wholesale?: boolean | null;
+            public_coffee?: boolean | null;
+            matchReasons: string[];
+        };
+        SourcingBriefMatchesResponse: {
+            data: components["schemas"]["SourcingBriefMatch"][];
+            pagination: {
+                page: number;
+                limit: number;
+                total: number;
+                totalPages: number;
+                hasNext: boolean;
+                hasPrev: boolean;
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "procurement-brief-matches";
+                /** @enum {string} */
+                namespace: "/v1/procurement/briefs/:id/matches";
+                /** @enum {string} */
+                version: "v1";
+                generatedAt: string;
+                auth: {
+                    /** @enum {string} */
+                    kind: "session" | "api-key";
+                    /** @enum {string|null} */
+                    role: "admin" | "member" | "viewer" | null;
+                    /** @enum {string|null} */
+                    apiPlan: "viewer" | "member" | "enterprise" | null;
+                };
+                brief: components["schemas"]["SourcingBriefResource"];
+                criteria: components["schemas"]["SourcingBriefCriteria"] & Record<string, never>;
+                limitations: string[];
+            };
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+
+interface ParchmentClientOptions {
+    /** Base URL of the Parchment API, e.g. https://api.purveyors.io */
+    baseUrl: string;
+    /**
+     * Optional bearer token (a Supabase JWT or, later, an API key). Sent as
+     * `Authorization: Bearer <token>`. Auth is resolved server-side against the
+     * unified principal model; the SDK only forwards the credential.
+     */
+    token?: string;
+    /** Override the fetch implementation (useful for tests or custom runtimes). */
+    fetch?: ClientOptions["fetch"];
+}
+/**
+ * Create a typed Parchment API client.
+ *
+ * The generated core (openapi-fetch over the generated `paths` types) is the
+ * contract truth; the small named helpers below are the hand-maintained
+ * ergonomic layer and grow as endpoints land.
+ */
+declare function createParchmentClient(options: ParchmentClientOptions): {
+    /** The underlying typed openapi-fetch client for direct path access. */
+    raw: openapi_fetch.Client<paths, `${string}/${string}`>;
+    /** Liveness and service identity. */
+    health: () => 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"]["HealthResponse"];
+                };
+            };
+        };
+    }, 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"]["HealthResponse"];
+                };
+            };
+        };
+    }> | undefined, `${string}/${string}`>>;
+};
+type ParchmentClient = ReturnType<typeof createParchmentClient>;
+
+export { type ParchmentClient, type ParchmentClientOptions, type components, createParchmentClient, type paths };

package/dist/index.js

@@ -0,0 +1,20 @@
+// src/client.ts
+import createClient from "openapi-fetch";
+function createParchmentClient(options) {
+  const { baseUrl, token, fetch: fetchImpl } = options;
+  const client = createClient({
+    baseUrl,
+    fetch: fetchImpl,
+    headers: token ? { Authorization: `Bearer ${token}` } : void 0
+  });
+  return {
+    /** The underlying typed openapi-fetch client for direct path access. */
+    raw: client,
+    /** Liveness and service identity. */
+    health: () => client.GET("/health")
+  };
+}
+export {
+  createParchmentClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import createClient, { type ClientOptions } from \"openapi-fetch\";\nimport type { 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/**\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 small named helpers below are the hand-maintained\n * ergonomic layer and grow as endpoints land.\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  };\n}\n\nexport type ParchmentClient = ReturnType<typeof createParchmentClient>;\n"],"mappings":";AAAA,OAAO,kBAA0C;AAuB1C,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,EACpC;AACF;","names":[]}

package/package.json

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