@roastbook/open-coffee-schema 0.0.0-stage → 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Roastbook Open Coffee contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,66 @@
-# Temporary Holding Version
+# @roastbook/open-coffee-schema
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+TypeScript types, JSON Schemas, the JSON-LD context and the allowed values of the [Open Coffee](https://schema.roastbook.coffee/) standard: coffee places, equipment and brew methods. By [Roastbook](https://roastbook.coffee/).
+
+The package version is the release of the standard (`1.2.0` = tag `v1.2.0` of [Roastbook/open-coffee-schema](https://github.com/Roastbook/open-coffee-schema)). Each family keeps its own schema version inside it; see `SCHEMA_IDS`. No runtime dependencies.
+
+## Install
+
+The package is on the public npm registry. No token or registry setting is needed:
+
+```sh
+bun add @roastbook/open-coffee-schema     # or: npm i @roastbook/open-coffee-schema
+```
+
+Releases are published from GitHub Actions with npm Trusted Publishing and carry provenance, which links each version to the release workflow run in [Roastbook/open-coffee-schema](https://github.com/Roastbook/open-coffee-schema). Versions 0.1.0 to 0.3.0 were published only to GitHub Packages (`npm.pkg.github.com`); from 0.4.0 the package is on npmjs.org.
+
+## Types
+
+```ts
+import type { CoffeePlacesDataset, CoffeePlace, BrewMethodsDataset, BrewMethod, EquipmentItem, SpecialtyTier } from "@roastbook/open-coffee-schema";
+
+const res = await fetch("https://data.roastbook.coffee/datasets/coffee-places/de/munich.json");
+const munich = (await res.json()) as CoffeePlacesDataset;
+const filterBars: CoffeePlace[] = munich.places.filter((p) => p.serving?.filter);
+```
+
+The types come from the newest version of each family. Rules that TypeScript cannot express (patterns, ranges, "closed_on only when status is closed") are checked by validation, below.
+
+## Validation with Ajv
+
+```ts
+import Ajv2020 from "ajv/dist/2020.js";
+import addFormats from "ajv-formats";
+import { schemas } from "@roastbook/open-coffee-schema/schemas";
+import { SCHEMA_IDS, isIri } from "@roastbook/open-coffee-schema";
+
+const ajv = new Ajv2020({ allErrors: true });
+addFormats(ajv);
+ajv.addFormat("iri", isIri); // URL fields use the "iri" format, which ajv-formats lacks
+for (const schema of Object.values(schemas)) ajv.addSchema(schema);
+
+const validate = ajv.getSchema(SCHEMA_IDS["brew-methods"].latest)!;
+if (!validate(data)) console.error(validate.errors);
+```
+
+Validate against the `$id` a file names in its `$schema` to keep old files valid after new versions come out: `ajv.getSchema(data.$schema)`.
+
+Single schema files are exported too: `@roastbook/open-coffee-schema/coffee-places/v0.4.0.json` (every published version stays included, for example `…/coffee-places/v0.1.0.json`), `…/coffee-places/latest.json`, and the JSON-LD context `…/coffee-places/context.v0.4.0.json` (`context.latest.json`; `.json` so Node and bundlers can import it).
+
+## Allowed values
+
+Every fixed list of values is exported as a read-only array, so apps do not re-declare them:
+
+```ts
+import { SPECIALTY_TIER_VALUES, EQUIPMENT_TYPE_VALUES, BREW_PARAMETER_VALUES, COFFEE_PLACE_STATUS_VALUES } from "@roastbook/open-coffee-schema";
+
+for (const type of EQUIPMENT_TYPE_VALUES) console.log(type); // "espresso_machine", "grinder", …
+```
+
+Names follow the type (`SpecialtyTier` → `SPECIALTY_TIER_VALUES`) or the family and field path (`status` of a coffee place → `COFFEE_PLACE_STATUS_VALUES`).
+
+Coffee journals can take the values of recorded brew parameters from here too: `BREW_PARAMETER_VALUES` (the parameter keys), `PAPER_FILTER_POSITION_VALUES` and `DISTRIBUTION_METHOD_VALUES`. A journal that keeps one ratio plus a basis maps a ratio based on brew water to `brew_ratio` and a ratio based on the yield to `yield_ratio`.
+
+## Licence
+
+MIT. Field documentation: <https://schema.roastbook.coffee/>.

package/brew-methods/latest.json

@@ -0,0 +1,312 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schema.roastbook.coffee/brew-methods/brew-methods.schema.v0.4.0.json",
+  "title": "Open Coffee brew methods",
+  "description": "Ways of brewing coffee (espresso, pour-over, V60, AeroPress, cold brew…), their typical parameters and what a coffee journal should record for each. Methods form a tree: a device-specific method such as v60 has the general method pour-over as parent. Part of Roastbook Open Coffee.",
+  "type": "object",
+  "required": [
+    "$schema",
+    "meta",
+    "brew_methods"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "pattern": "^https://schema\\.roastbook\\.coffee/brew-methods/brew-methods\\.schema\\.v[0-9]+\\.[0-9]+\\.[0-9]+\\.json$",
+      "description": "Canonical URL of the schema version this file follows."
+    },
+    "meta": {
+      "type": "object",
+      "$ref": "https://schema.roastbook.coffee/common/common.schema.v0.4.0.json#/$defs/dataset_meta",
+      "unevaluatedProperties": false
+    },
+    "brew_methods": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/brew_method"
+      }
+    }
+  },
+  "$defs": {
+    "range": {
+      "title": "Range",
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "min": {
+          "type": "number",
+          "minimum": 0,
+          "description": "Lowest common value, in the unit named by the parameter (for example grams for dose_g, degrees Celsius for brew_temperature_celsius)."
+        },
+        "max": {
+          "type": "number",
+          "minimum": 0,
+          "description": "Highest common value, in the unit named by the parameter."
+        },
+        "typical": {
+          "type": "number",
+          "minimum": 0,
+          "description": "A good starting value, in the unit named by the parameter."
+        }
+      },
+      "description": "A starting range. When several values are given they must be ordered: min ≤ typical ≤ max. JSON Schema cannot compare two values, so this repository checks it in its examples and data repositories check it in their data."
+    },
+    "parameter": {
+      "title": "Brew parameter",
+      "enum": [
+        "dose_g",
+        "brew_water_g",
+        "yield_g",
+        "brew_ratio",
+        "yield_ratio",
+        "grind_setting",
+        "brew_time_seconds",
+        "target_time_seconds",
+        "brew_temperature_celsius",
+        "bloom_time_seconds",
+        "bloom_water_g",
+        "preinfusion_time_seconds",
+        "preinfusion_pressure_bar",
+        "brew_pressure_bar",
+        "flow_rate_ml_per_second",
+        "tamp_force_kg",
+        "uses_puck_screen",
+        "paper_filter_position",
+        "distribution_method",
+        "pour_count",
+        "steep_time_seconds"
+      ],
+      "description": "Parameter keys shared with coffee journals such as Roastbook. brew_ratio is grams of brew water per gram of coffee (16 means 1:16); yield_ratio is grams of drink in the cup per gram of coffee (2 means a 1:2 espresso). brew_temperature_celsius is the temperature of the brew water. uses_puck_screen records whether a puck screen sat on top of the espresso puck (true or false). paper_filter_position takes a paper_filter_position value and distribution_method a distribution_method value."
+    },
+    "grind_size": {
+      "title": "Grind size",
+      "enum": [
+        "extra_fine",
+        "fine",
+        "medium_fine",
+        "medium",
+        "medium_coarse",
+        "coarse",
+        "extra_coarse"
+      ],
+      "description": "Descriptive grind size; extra_fine is Turkish, fine espresso, medium filter, coarse French press and cold brew."
+    },
+    "paper_filter_position": {
+      "title": "Paper filter position",
+      "enum": [
+        "none",
+        "top",
+        "bottom",
+        "both"
+      ],
+      "description": "Where paper filter discs sit in an espresso basket. none: no paper filter; top: on top of the coffee, under the shower screen; bottom: under the coffee, at the basket floor; both: one disc on top and one at the bottom."
+    },
+    "distribution_method": {
+      "title": "Distribution method",
+      "enum": [
+        "wdt",
+        "blind_shaker",
+        "distribution_tool",
+        "stockfleth_move"
+      ],
+      "description": "How ground coffee is spread evenly in the basket before tamping. wdt: stirring with fine needles (Weiss Distribution Technique); blind_shaker: grinding into a closed cup, shaking it and tipping the coffee into the basket; distribution_tool: a spinning leveller set on the basket; stockfleth_move: sweeping the coffee level with a finger while turning the portafilter."
+    },
+    "brew_method": {
+      "title": "Brew method",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "name",
+        "category",
+        "extraction",
+        "description",
+        "checked_at"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "https://schema.roastbook.coffee/common/common.schema.v0.4.0.json#/$defs/id",
+          "description": "Stable readable slug, e.g. v60, french-press. Never reused.",
+          "examples": [
+            "v60"
+          ]
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Common English name of the method, for example Pour-over or French press."
+        },
+        "aliases": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": "Other names in any language, e.g. Filterkaffee, drip."
+        },
+        "parent": {
+          "$ref": "https://schema.roastbook.coffee/common/common.schema.v0.4.0.json#/$defs/id",
+          "description": "The more general method, e.g. pour-over for v60."
+        },
+        "category": {
+          "enum": [
+            "espresso",
+            "filter",
+            "immersion",
+            "pressure",
+            "vacuum",
+            "boiling",
+            "cold"
+          ],
+          "description": "Family used for grouping: espresso (9-bar style pressure), filter (percolation through a filter), immersion (steep, then separate), pressure (non-espresso pressure such as AeroPress or moka pot), vacuum (siphon), boiling (cezve/ibrik), cold (cold water over hours)."
+        },
+        "extraction": {
+          "enum": [
+            "percolation",
+            "immersion",
+            "hybrid"
+          ],
+          "description": "Physical principle; matches equipment brewer.mechanism."
+        },
+        "description": {
+          "type": "string",
+          "minLength": 20,
+          "maxLength": 600,
+          "description": "Short neutral explanation in our own words."
+        },
+        "introduced_year": {
+          "type": "integer",
+          "minimum": 1000,
+          "maximum": 2100,
+          "description": "Year the method or device was invented or first sold."
+        },
+        "origin_country_code": {
+          "$ref": "https://schema.roastbook.coffee/common/common.schema.v0.4.0.json#/$defs/country_code"
+        },
+        "equipment_types": {
+          "type": "array",
+          "uniqueItems": true,
+          "description": "Equipment types needed, from the equipment schema's type list.",
+          "items": {
+            "$ref": "https://schema.roastbook.coffee/equipment/equipment.schema.v0.4.0.json#/$defs/type"
+          }
+        },
+        "typical_parameters": {
+          "title": "Typical parameters",
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Common starting ranges, not rules.",
+          "properties": {
+            "dose_g": {
+              "$ref": "#/$defs/range"
+            },
+            "brew_ratio": {
+              "$ref": "#/$defs/range",
+              "description": "Grams of brew water per gram of coffee, for example 16 for 1:16. Used for filter, immersion and cold brew. A journal that keeps one ratio and a basis puts the ratio here when the basis is brew water (Roastbook: ratioBasis brew_water)."
+            },
+            "yield_ratio": {
+              "$ref": "#/$defs/range",
+              "description": "Grams of drink in the cup per gram of coffee, for example 2 for a 1:2 espresso. Used where the drink is weighed, mainly espresso. A journal that keeps one ratio and a basis puts the ratio here when the basis is the yield (Roastbook: ratioBasis target_yield)."
+            },
+            "brew_temperature_celsius": {
+              "$ref": "#/$defs/range",
+              "description": "Temperature of the brew water, in degrees Celsius."
+            },
+            "brew_time_seconds": {
+              "$ref": "#/$defs/range"
+            },
+            "brew_pressure_bar": {
+              "$ref": "#/$defs/range"
+            },
+            "grind_size": {
+              "type": "array",
+              "uniqueItems": true,
+              "minItems": 1,
+              "items": {
+                "$ref": "#/$defs/grind_size"
+              }
+            },
+            "grind_d50_microns": {
+              "$ref": "#/$defs/range",
+              "description": "Median particle size in micrometres, comparable across grinders."
+            },
+            "paper_filter_position": {
+              "type": "array",
+              "uniqueItems": true,
+              "minItems": 1,
+              "items": {
+                "$ref": "#/$defs/paper_filter_position"
+              },
+              "description": "Paper filter positions commonly used with this method."
+            },
+            "distribution_method": {
+              "type": "array",
+              "uniqueItems": true,
+              "minItems": 1,
+              "items": {
+                "$ref": "#/$defs/distribution_method"
+              },
+              "description": "Distribution methods commonly used with this method."
+            }
+          }
+        },
+        "recorded_parameters": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/parameter"
+          },
+          "description": "Parameters a coffee journal should offer when logging a brew with this method."
+        },
+        "typical_drinks": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": "Drinks usually made with this method, in plain lowercase English, for example espresso, cappuccino or flat white."
+        },
+        "xref": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "wikidata": {
+              "type": "string",
+              "pattern": "^Q[1-9][0-9]*$",
+              "description": "Wikidata item id of the method, for example Q180289 for espresso."
+            },
+            "beanconqueror": {
+              "type": "string",
+              "pattern": "^[A-Z0-9_]+$",
+              "description": "Beanconqueror PREPARATION_TYPES key, for app imports."
+            }
+          },
+          "description": "Identifiers of the method in other datasets and apps."
+        },
+        "image": {
+          "$ref": "https://schema.roastbook.coffee/common/common.schema.v0.4.0.json#/$defs/image"
+        },
+        "checked_at": {
+          "$ref": "https://schema.roastbook.coffee/common/common.schema.v0.4.0.json#/$defs/datetime"
+        },
+        "filter_types": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "paper",
+              "metal",
+              "cloth",
+              "none"
+            ]
+          },
+          "description": "Filters the method can use. paper: paper filters; metal: metal mesh or perforated metal; cloth: cloth filters; none: no filter (for example cezve or cold brew in a jar)."
+        }
+      }
+    }
+  }
+}

package/brew-methods/v0.1.0.json

@@ -0,0 +1,265 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schema.roastbook.coffee/brew-methods/brew-methods.schema.v0.1.0.json",
+  "title": "Open Coffee brew methods",
+  "description": "Ways of brewing coffee (espresso, pour-over, V60, AeroPress, cold brew…), their typical parameters and what a coffee journal should record for each. Methods form a tree: a device-specific method such as v60 has the general method pour-over as parent. Part of Roastbook Open Coffee.",
+  "type": "object",
+  "required": [
+    "$schema",
+    "meta",
+    "brew_methods"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "pattern": "^https://schema\\.roastbook\\.coffee/brew-methods/brew-methods\\.schema\\.v[0-9]+\\.[0-9]+\\.[0-9]+\\.json$",
+      "description": "Canonical URL of the schema version this file follows."
+    },
+    "meta": {
+      "type": "object",
+      "$ref": "https://schema.roastbook.coffee/common/common.schema.v0.1.0.json#/$defs/dataset_meta",
+      "unevaluatedProperties": false
+    },
+    "brew_methods": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/brew_method"
+      }
+    }
+  },
+  "$defs": {
+    "range": {
+      "title": "Range",
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "min": {
+          "type": "number",
+          "minimum": 0,
+          "description": "Lowest common value, in the unit named by the parameter (for example grams for dose_g, degrees Celsius for water_temperature_celsius)."
+        },
+        "max": {
+          "type": "number",
+          "minimum": 0,
+          "description": "Highest common value, in the unit named by the parameter."
+        },
+        "typical": {
+          "type": "number",
+          "minimum": 0,
+          "description": "A good starting value, in the unit named by the parameter."
+        }
+      }
+    },
+    "parameter": {
+      "title": "Brew parameter",
+      "enum": [
+        "dose_g",
+        "brew_water_g",
+        "yield_g",
+        "ratio",
+        "grind_setting",
+        "brew_time_seconds",
+        "target_time_seconds",
+        "water_temperature_celsius",
+        "bloom_time_seconds",
+        "bloom_water_g",
+        "preinfusion_time_seconds",
+        "preinfusion_pressure_bar",
+        "brew_pressure_bar",
+        "flow_rate_ml_per_second",
+        "tamp_force_kg",
+        "paper_filter_position",
+        "distribution_method",
+        "pour_count",
+        "steep_time_seconds"
+      ],
+      "description": "Parameter keys shared with coffee journals such as Roastbook. ratio is brew water to coffee (16 means 1:16); for espresso it is yield to dose (2 means 1:2)."
+    },
+    "grind_size": {
+      "title": "Grind size",
+      "enum": [
+        "extra_fine",
+        "fine",
+        "medium_fine",
+        "medium",
+        "medium_coarse",
+        "coarse",
+        "extra_coarse"
+      ],
+      "description": "Descriptive grind size; extra_fine is Turkish, fine espresso, medium filter, coarse French press and cold brew."
+    },
+    "brew_method": {
+      "title": "Brew method",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "name",
+        "category",
+        "extraction",
+        "description",
+        "checked_at"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "https://schema.roastbook.coffee/common/common.schema.v0.1.0.json#/$defs/id",
+          "description": "Stable readable slug, e.g. v60, french-press. Never reused.",
+          "examples": [
+            "v60"
+          ]
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Common English name of the method, for example Pour-over or French press."
+        },
+        "aliases": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": "Other names in any language, e.g. Filterkaffee, drip."
+        },
+        "parent": {
+          "$ref": "https://schema.roastbook.coffee/common/common.schema.v0.1.0.json#/$defs/id",
+          "description": "The more general method, e.g. pour-over for v60."
+        },
+        "category": {
+          "enum": [
+            "espresso",
+            "filter",
+            "immersion",
+            "pressure",
+            "vacuum",
+            "boiling",
+            "cold"
+          ],
+          "description": "Family used for grouping: espresso (9-bar style pressure), filter (percolation through a filter), immersion (steep, then separate), pressure (non-espresso pressure such as AeroPress or moka pot), vacuum (siphon), boiling (cezve/ibrik), cold (cold water over hours)."
+        },
+        "extraction": {
+          "enum": [
+            "percolation",
+            "immersion",
+            "hybrid"
+          ],
+          "description": "Physical principle; matches equipment brewer.mechanism."
+        },
+        "description": {
+          "type": "string",
+          "minLength": 20,
+          "maxLength": 600,
+          "description": "Short neutral explanation in our own words."
+        },
+        "introduced_year": {
+          "type": "integer",
+          "minimum": 1000,
+          "maximum": 2100,
+          "description": "Year the method or device was invented or first sold."
+        },
+        "origin_country_code": {
+          "$ref": "https://schema.roastbook.coffee/common/common.schema.v0.1.0.json#/$defs/country_code"
+        },
+        "equipment_types": {
+          "type": "array",
+          "uniqueItems": true,
+          "description": "Equipment types needed, from the equipment schema's type list.",
+          "items": {
+            "$ref": "https://schema.roastbook.coffee/equipment/equipment.schema.v0.1.0.json#/$defs/type"
+          }
+        },
+        "typical_parameters": {
+          "title": "Typical parameters",
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Common starting ranges, not rules.",
+          "properties": {
+            "dose_g": {
+              "$ref": "#/$defs/range"
+            },
+            "ratio": {
+              "$ref": "#/$defs/range"
+            },
+            "water_temperature_celsius": {
+              "$ref": "#/$defs/range"
+            },
+            "brew_time_seconds": {
+              "$ref": "#/$defs/range"
+            },
+            "brew_pressure_bar": {
+              "$ref": "#/$defs/range"
+            },
+            "grind_size": {
+              "type": "array",
+              "uniqueItems": true,
+              "minItems": 1,
+              "items": {
+                "$ref": "#/$defs/grind_size"
+              }
+            },
+            "grind_d50_microns": {
+              "$ref": "#/$defs/range",
+              "description": "Median particle size in micrometres, comparable across grinders."
+            }
+          }
+        },
+        "recorded_parameters": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/parameter"
+          },
+          "description": "Parameters a coffee journal should offer when logging a brew with this method."
+        },
+        "typical_drinks": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": "Drinks usually made with this method, in plain lowercase English, for example espresso, cappuccino or flat white."
+        },
+        "xref": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "wikidata": {
+              "type": "string",
+              "pattern": "^Q[1-9][0-9]*$",
+              "description": "Wikidata item id of the method, for example Q180289 for espresso."
+            },
+            "beanconqueror": {
+              "type": "string",
+              "pattern": "^[A-Z0-9_]+$",
+              "description": "Beanconqueror PREPARATION_TYPES key, for app imports."
+            }
+          },
+          "description": "Identifiers of the method in other datasets and apps."
+        },
+        "image": {
+          "$ref": "https://schema.roastbook.coffee/common/common.schema.v0.1.0.json#/$defs/image"
+        },
+        "checked_at": {
+          "$ref": "https://schema.roastbook.coffee/common/common.schema.v0.1.0.json#/$defs/datetime"
+        },
+        "filter_types": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "paper",
+              "metal",
+              "cloth",
+              "none"
+            ]
+          },
+          "description": "Filters the method can use. paper: paper filters; metal: metal mesh or perforated metal; cloth: cloth filters; none: no filter (for example cezve or cold brew in a jar)."
+        }
+      }
+    }
+  }
+}