@purveyors/sdk 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -2601,7 +2601,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;
@@ -2926,6 +2996,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 +3123,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 +3174,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 +3221,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 +3473,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: {
@@ -4185,6 +4295,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;
@@ -7060,6 +7198,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). */

package/dist/index.js

@@ -177,6 +177,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":"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","names":["options"]}
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import createClient, { type ClientOptions } from \"openapi-fetch\";\nimport type { components, paths } from \"./schema\";\n\nexport interface ParchmentClientOptions {\n  /** Base URL of the Parchment API, e.g. https://api.purveyors.io */\n  baseUrl: string;\n  /**\n   * Optional bearer token (a Supabase JWT or, later, an API key). Sent as\n   * `Authorization: Bearer <token>`. Auth is resolved server-side against the\n   * unified principal model; the SDK only forwards the credential.\n   */\n  token?: string;\n  /** Override the fetch implementation (useful for tests or custom runtimes). */\n  fetch?: ClientOptions[\"fetch\"];\n}\n\n/** Query parameters for {@link ParchmentClient.catalog.list}. */\nexport type CatalogListQuery = NonNullable<\n  paths[\"/v1/catalog\"][\"get\"][\"parameters\"][\"query\"]\n>;\n/** 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       * 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.6.0",
   "description": "Typed client for the Purveyors Parchment API, generated from its OpenAPI spec.",
   "license": "MIT",
   "type": "module",