@purveyors/sdk 0.34.0 → 0.35.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/dist/index.d.ts +35 -1
  2. package/package.json +1 -1
package/dist/index.d.ts CHANGED
@@ -2626,6 +2626,7 @@ interface paths {
2626
2626
  pricePerLbMax?: number | null;
2627
2627
  elevationMinMasl?: number | null;
2628
2628
  elevationMaxMasl?: number | null;
2629
+ includeUnknownElevation?: "true" | "false";
2629
2630
  processing_base_method?: string;
2630
2631
  fermentation_type?: string;
2631
2632
  process_additive?: string;
@@ -2706,7 +2707,7 @@ interface paths {
2706
2707
  };
2707
2708
  /**
2708
2709
  * Map projection over the caller-visible catalog
2709
- * @description Returns deterministic lightweight clusters and place features after applying the canonical catalog visibility, filters, and entitlement policy. Global unique/unplaced totals remain separate from viewport placement totals; multi-origin placement counts are intentionally non-additive. Public/demo callers receive country/region-safe features, while canonical place navigation, bounding boxes, and elevation profiles are available to member sessions and customer API keys. Green map projections inspect at most 25 catalog rows; feature counts follow the aggregate map grouping rather than the collection-item cap. These catalog routes require a Supabase session JWT or Parchment API key. For entitlement-gated params, strict callers (non-demo API keys, bearer-session JWTs) receive a 401/403; lenient callers (first-party cookie-session and the configured public-demo API key) get the params stripped with a `meta.notices` entry. Send `Prefer: handling=strict` to opt into strict enforcement; `Prefer: handling=lenient` is honored only for callers already lenient-eligible and cannot downgrade a strict caller's enforcement.
2710
+ * @description Returns deterministic lightweight clusters, semantic location groups, and place features after applying the canonical catalog visibility, filters, and entitlement policy. The optional locations projection groups placements by canonical place identity so contained coffees can be selected without inventing screen-space coordinates. Global unique/unplaced totals remain separate from viewport placement totals; multi-origin placement counts are intentionally non-additive. Public/demo callers receive country/region-safe features, while canonical place navigation, bounding boxes, and elevation profiles are available to member sessions and customer API keys. Green map projections inspect at most 25 catalog rows; feature counts follow the aggregate map grouping rather than the collection-item cap. These catalog routes require a Supabase session JWT or Parchment API key. For entitlement-gated params, strict callers (non-demo API keys, bearer-session JWTs) receive a 401/403; lenient callers (first-party cookie-session and the configured public-demo API key) get the params stripped with a `meta.notices` entry. Send `Prefer: handling=strict` to opt into strict enforcement; `Prefer: handling=lenient` is honored only for callers already lenient-eligible and cannot downgrade a strict caller's enforcement.
2710
2711
  */
2711
2712
  get: {
2712
2713
  parameters: {
@@ -2738,6 +2739,7 @@ interface paths {
2738
2739
  pricePerLbMax?: number | null;
2739
2740
  elevationMinMasl?: number | null;
2740
2741
  elevationMaxMasl?: number | null;
2742
+ includeUnknownElevation?: "true" | "false";
2741
2743
  processing_base_method?: string;
2742
2744
  fermentation_type?: string;
2743
2745
  process_additive?: string;
@@ -2748,6 +2750,7 @@ interface paths {
2748
2750
  bbox?: string;
2749
2751
  zoom?: number;
2750
2752
  lens?: "catalog" | "elevation";
2753
+ projection?: "clusters" | "locations";
2751
2754
  };
2752
2755
  header?: {
2753
2756
  Prefer?: string;
@@ -2884,6 +2887,7 @@ interface paths {
2884
2887
  pricePerLbMax?: number | null;
2885
2888
  elevationMinMasl?: number | null;
2886
2889
  elevationMaxMasl?: number | null;
2890
+ includeUnknownElevation?: "true" | "false";
2887
2891
  processing_base_method?: string;
2888
2892
  fermentation_type?: string;
2889
2893
  process_additive?: string;
@@ -9849,6 +9853,26 @@ interface components {
9849
9853
  placement_count: number;
9850
9854
  unique_coffee_count: number;
9851
9855
  catalog_ids: number[];
9856
+ } | {
9857
+ /** @enum {string} */
9858
+ type: "location";
9859
+ id: string;
9860
+ /** Format: uuid */
9861
+ place_id: string | null;
9862
+ canonical_name: string;
9863
+ /** @enum {string} */
9864
+ place_type: "continent" | "country" | "region" | "subregion" | "locality" | "site";
9865
+ longitude: number;
9866
+ latitude: number;
9867
+ /** @enum {string} */
9868
+ geographic_precision: "none" | "continent" | "country" | "region" | "subregion" | "locality" | "site" | "exact_site";
9869
+ /** @enum {string} */
9870
+ coordinate_kind: "none" | "centroid" | "exact_point";
9871
+ /** @enum {string} */
9872
+ place_provenance: "reference_dataset" | "source_evidence" | "deterministic_resolution" | "manual_review";
9873
+ placement_count: number;
9874
+ unique_coffee_count: number;
9875
+ catalog_ids: number[];
9852
9876
  } | {
9853
9877
  /** @enum {string} */
9854
9878
  type: "place";
@@ -9925,6 +9949,8 @@ interface components {
9925
9949
  zoom: number;
9926
9950
  /** @enum {string} */
9927
9951
  lens: "catalog" | "elevation";
9952
+ /** @enum {string} */
9953
+ projection: "clusters" | "locations";
9928
9954
  /** Format: uuid */
9929
9955
  place_id: string | null;
9930
9956
  bbox: {
@@ -15335,6 +15361,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
15335
15361
  pricePerLbMax?: number | null;
15336
15362
  elevationMinMasl?: number | null;
15337
15363
  elevationMaxMasl?: number | null;
15364
+ includeUnknownElevation?: "true" | "false";
15338
15365
  processing_base_method?: string;
15339
15366
  fermentation_type?: string;
15340
15367
  process_additive?: string;
@@ -15429,6 +15456,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
15429
15456
  pricePerLbMax?: number | null;
15430
15457
  elevationMinMasl?: number | null;
15431
15458
  elevationMaxMasl?: number | null;
15459
+ includeUnknownElevation?: "true" | "false";
15432
15460
  processing_base_method?: string;
15433
15461
  fermentation_type?: string;
15434
15462
  process_additive?: string;
@@ -15472,6 +15500,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
15472
15500
  pricePerLbMax?: number | null;
15473
15501
  elevationMinMasl?: number | null;
15474
15502
  elevationMaxMasl?: number | null;
15503
+ includeUnknownElevation?: "true" | "false";
15475
15504
  processing_base_method?: string;
15476
15505
  fermentation_type?: string;
15477
15506
  process_additive?: string;
@@ -15482,6 +15511,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
15482
15511
  bbox?: string;
15483
15512
  zoom?: number;
15484
15513
  lens?: "catalog" | "elevation";
15514
+ projection?: "clusters" | "locations";
15485
15515
  };
15486
15516
  header?: {
15487
15517
  Prefer?: string;
@@ -15593,6 +15623,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
15593
15623
  pricePerLbMax?: number | null;
15594
15624
  elevationMinMasl?: number | null;
15595
15625
  elevationMaxMasl?: number | null;
15626
+ includeUnknownElevation?: "true" | "false";
15596
15627
  processing_base_method?: string;
15597
15628
  fermentation_type?: string;
15598
15629
  process_additive?: string;
@@ -15603,6 +15634,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
15603
15634
  bbox?: string;
15604
15635
  zoom?: number;
15605
15636
  lens?: "catalog" | "elevation";
15637
+ projection?: "clusters" | "locations";
15606
15638
  } | undefined;
15607
15639
  header: {
15608
15640
  Prefer?: string;
@@ -15643,6 +15675,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
15643
15675
  pricePerLbMax?: number | null;
15644
15676
  elevationMinMasl?: number | null;
15645
15677
  elevationMaxMasl?: number | null;
15678
+ includeUnknownElevation?: "true" | "false";
15646
15679
  processing_base_method?: string;
15647
15680
  fermentation_type?: string;
15648
15681
  process_additive?: string;
@@ -15732,6 +15765,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
15732
15765
  pricePerLbMax?: number | null;
15733
15766
  elevationMinMasl?: number | null;
15734
15767
  elevationMaxMasl?: number | null;
15768
+ includeUnknownElevation?: "true" | "false";
15735
15769
  processing_base_method?: string;
15736
15770
  fermentation_type?: string;
15737
15771
  process_additive?: string;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@purveyors/sdk",
3
- "version": "0.34.0",
3
+ "version": "0.35.0",
4
4
  "description": "Typed client for the Purveyors Parchment API, generated from its OpenAPI spec.",
5
5
  "license": "MIT",
6
6
  "type": "module",