cooking-temperature

A comprehensive library for safe cooking temperatures, doneness levels, and cooking instructions for various ingredients.

Installation

npm install cooking-temperature

Usage

import {
  search,
  findByName,
  findById,
  findByCategory,
  getAllEntries,
  getAllCategories,
  getCategoryName,
  getQuickReference,
  getSafeMinimumTemp,
  getDonenessTemp,
  getCookingMethods,
  getCookingInstruction,
  convertTemperature,
} from "cooking-temperature"

// Search for ingredients
const results = search("chicken")
// Returns: CookingTemperatureEntry[] (all entries matching "chicken")

// Search with options
const limitedResults = search("pork", { category: "pork", limit: 3 })
// Returns: up to 3 pork entries matching "pork"

// Quick reference lookup
const chicken = getQuickReference("chicken breast", "oven_bake")
// Returns:
// {
//   name: "Chicken Breast",
//   safeMinimumTemp: 165,
//   tempUnit: "F",
//   restMinutes: 0,
//   suggestedMethod: {
//     method: "oven_bake",
//     applianceTemp: 400,
//     timeMinutes: { min: 22, max: 28 },
//     notes: "Let rest 5 minutes before slicing"
//   },
//   visualIndicators: ["No pink in center", "Juices run clear", "Firm to touch"]
// }

// Find an ingredient by name or alias
const beef = findByName("ribeye")
// Returns: CookingTemperatureEntry | undefined

// Get all available categories
const categories = getAllCategories()
// Returns: ["poultry", "beef", "pork", "seafood_fish", "seafood_shellfish", "egg", "vegetable", "grain"]

// Get human-readable category name
const name = getCategoryName("seafood_fish")
// Returns: "Fish"

// Get safe minimum temperature
const safeTemp = getSafeMinimumTemp("chicken-breast", "F")
// Returns: { temp: 165, restMinutes: 0 }

// Get doneness temperature for proteins
const mediumRare = getDonenessTemp("beef-steak-ribeye", "medium_rare", "F")
// Returns: 135

// Get available cooking methods
const methods = getCookingMethods("salmon-fillet")
// Returns: ["oven_bake", "pan_sear", "grill", "poach", "sous_vide"]

// Get cooking instructions
const instructions = getCookingInstruction("salmon-fillet", "oven_bake")
// Returns:
// {
//   applianceTemp: 400,
//   applianceTempUnit: "F",
//   timeMinutes: { min: 12, max: 15 },
//   notes: "Skin-side down",
//   portionDescription: "6 oz fillet, 1 inch thick"
// }

// Convert between Fahrenheit and Celsius
const celsius = convertTemperature(165, "F", "C")
// Returns: 74

API

Types

type TemperatureUnit = "F" | "C"

type IngredientCategory =
  | "poultry" | "beef" | "pork" | "lamb"
  | "seafood_fish" | "seafood_shellfish"
  | "egg" | "vegetable" | "grain" | "legume"

type DonenessLevel =
  | "rare" | "medium_rare" | "medium"
  | "medium_well" | "well_done" | "safe_minimum"

type CookingMethod =
  | "oven_roast" | "oven_bake" | "pan_sear" | "pan_fry"
  | "grill" | "broil" | "poach" | "simmer" | "boil" | "steam"
  | "sous_vide" | "air_fry" | "deep_fry" | "slow_cook"

Search & Lookup Functions

search(query: string, options?: { category?: IngredientCategory; limit?: number }): SearchResult[]

Search for ingredients by name or alias. Returns flattened results with one entry per cooking method, sorted by relevance.

type SearchResult = {
  category: IngredientCategory
  ingredientId: string
  ingredientName: string
  portionDescription: string
  cookingMethod: string
}

// Empty search - returns first 10 results (useful for initial display)
const defaultResults = search("")
// Returns: first 10 ingredient/method combinations

// Basic search - flattened by cooking method
const results = search("chicken")
// Returns: [
//   { category: 'poultry', ingredientId: 'chicken_breast_boneless', ingredientName: 'Chicken Breast...', portionDescription: 'standard (6-8 oz...)', cookingMethod: 'oven_bake' },
//   { category: 'poultry', ingredientId: 'chicken_breast_boneless', ingredientName: 'Chicken Breast...', portionDescription: 'standard (6-8 oz...)', cookingMethod: 'pan_sear' },
//   ...
// ]

// Filter by category
const fishResults = search("fillet", { category: "seafood_fish" })

// Custom limit (default is 10)
const topResults = search("sal", { limit: 5 })

// Combine options
const porkChops = search("chop", { category: "pork", limit: 3 })

findByName(query: string): CookingTemperatureEntry | undefined

Find the first ingredient matching a name or alias (case-insensitive partial match).

const entry = findByName("ribeye")
// Returns full CookingTemperatureEntry object or undefined

findById(id: string): CookingTemperatureEntry | undefined

Find an ingredient by its exact unique ID.

const entry = findById("beef_steak_ribeye")
// Returns full CookingTemperatureEntry object or undefined

findByCategory(category: IngredientCategory): CookingTemperatureEntry[]

Get all ingredients in a category.

const poultryItems = findByCategory("poultry")
// Returns: CookingTemperatureEntry[] (all poultry entries)

getAllEntries(): CookingTemperatureEntry[]

Get all cooking temperature entries in the library.

const all = getAllEntries()
// Returns: CookingTemperatureEntry[] (all entries)

getAllCategories(): IngredientCategory[]

Get all available categories.

const categories = getAllCategories()
// Returns: ["poultry", "beef", "pork", "seafood_fish", "seafood_shellfish", "egg", "vegetable", "grain"]

getCategoryName(category: IngredientCategory): string

Get the human-readable display name for a category.

const name = getCategoryName("seafood_fish")
// Returns: "Fish"

const name2 = getCategoryName("seafood_shellfish")
// Returns: "Shellfish"

Temperature Functions

convertTemperature(temp: number, from_unit: TemperatureUnit, to_unit: TemperatureUnit): number

Convert between Fahrenheit and Celsius.

const celsius = convertTemperature(165, "F", "C")
// Returns: 74

const fahrenheit = convertTemperature(74, "C", "F")
// Returns: 165

getSafeMinimumTemp(ingredientId: string, unit?: TemperatureUnit): { temp: number; restMinutes: number } | undefined

Get USDA safe minimum internal temperature for an ingredient.

const safeTemp = getSafeMinimumTemp("chicken_breast_boneless", "F")
// Returns: { temp: 165, restMinutes: 0 }

const beefTemp = getSafeMinimumTemp("beef_steak_ribeye", "F")
// Returns: { temp: 145, restMinutes: 3 }

const inCelsius = getSafeMinimumTemp("chicken_breast_boneless", "C")
// Returns: { temp: 74, restMinutes: 0 }

getDonenessTemp(ingredientId: string, doneness_level: DonenessLevel, unit?: TemperatureUnit): number | undefined

Get internal temperature for a specific doneness level.

const rare = getDonenessTemp("beef_steak_ribeye", "rare", "F")
// Returns: 125

const mediumRare = getDonenessTemp("beef_steak_ribeye", "medium_rare", "F")
// Returns: 135

const medium = getDonenessTemp("beef_steak_ribeye", "medium", "C")
// Returns: 60

Cooking Instructions

getCookingMethods(ingredientId: string): CookingMethod[]

Get available cooking methods for an ingredient.

const methods = getCookingMethods("salmon_fillet")
// Returns: ["oven_bake", "pan_sear", "grill", "poach", "sous_vide"]

const chickenMethods = getCookingMethods("chicken_breast_boneless")
// Returns: ["oven_bake", "pan_sear", "grill", "poach", "sous_vide", "air_fry"]

getCookingInstruction(ingredientId: string, cooking_method: CookingMethod, portionHint?: string): object | undefined

Get detailed cooking instructions for a specific method.

const instructions = getCookingInstruction("salmon_fillet", "oven_bake")
// Returns:
// {
//   applianceTemp: 400,
//   applianceTempUnit: "F",
//   timeMinutes: { min: 12, max: 15 },
//   notes: "Skin-side down",
//   portionDescription: "6 oz fillet, 1 inch thick"
// }

// With portion hint for specific cuts
const thickCut = getCookingInstruction("beef_steak_ribeye", "grill", "1.5 inch")
// Returns instructions for 1.5 inch thick steak

getQuickReference(query: string, cooking_method?: CookingMethod, unit?: TemperatureUnit): object | undefined

Get a quick reference with all relevant cooking info combined.

const ref = getQuickReference("chicken breast", "oven_bake", "F")
// Returns:
// {
//   name: "Chicken Breast",
//   safeMinimumTemp: 165,
//   tempUnit: "F",
//   restMinutes: 0,
//   suggestedMethod: {
//     method: "oven_bake",
//     applianceTemp: 400,
//     timeMinutes: { min: 22, max: 28 },
//     notes: "Let rest 5 minutes before slicing"
//   },
//   visualIndicators: ["No pink in center", "Juices run clear", "Firm to touch"]
// }

// Without method - returns just temperature info
const tempOnly = getQuickReference("salmon", undefined, "C")
// Returns:
// {
//   name: "Salmon Fillet",
//   safeMinimumTemp: 63,
//   tempUnit: "C",
//   restMinutes: 0,
//   suggestedMethod: undefined,
//   visualIndicators: ["Flesh flakes easily", "Opaque throughout"]
// }

Categories

| Category | Description | ID | |----------|-------------|-----| | Poultry | Chicken, turkey, duck | poultry | | Beef | Steaks, roasts, ground beef | beef | | Pork | Chops, tenderloin, ribs | pork | | Lamb | Chops, leg, ground lamb | lamb | | Fish | Salmon, tuna, cod | seafood_fish | | Shellfish | Shrimp, lobster, scallops | seafood_shellfish | | Eggs | Various egg preparations | egg | | Vegetables | Common vegetables | vegetable | | Grains | Rice, pasta, quinoa | grain | | Legumes | Beans, lentils | legume |

Doneness Levels

For proteins that support doneness preferences:

| Level | Description | |-------|-------------| | rare | Cool red center | | medium_rare | Warm red center | | medium | Warm pink center | | medium_well | Slightly pink center | | well_done | No pink, fully cooked | | safe_minimum | USDA recommended baseline |

Cooking Methods

| Method | Description | |--------|-------------| | oven_roast | Dry heat, uncovered, typically for larger cuts | | oven_bake | Dry heat, may be covered | | pan_sear | High heat, quick cooking | | pan_fry | Medium heat, more oil | | grill | Direct heat from below | | broil | Direct heat from above | | poach | Gentle simmering liquid | | simmer | Low bubbling liquid | | boil | Rolling boil | | steam | Suspended over boiling water | | sous_vide | Vacuum-sealed, precise temperature water bath | | air_fry | Circulating hot air | | deep_fry | Submerged in hot oil | | slow_cook | Low temperature, long duration |

License

MIT