tgh-flavours

Lightweight Node.js wrapper around Tampa General Hospital Flavours cafeteria menu data.

It fetches and parses menu data directly from the public TGH CaterTrax endpoint and returns JSON with calories always included for each item.

Install

npm install tgh-flavours

Test

npm test

Requirements

• Node.js 18+ (uses built-in fetch)

Usage

import {
  DietTag,
  MealPeriod,
  MenuDay,
  TghFlavoursClient,
  getTghMenu,
} from "tgh-flavours";

const client = new TghFlavoursClient();

const mondayBreakfast = await client.getMenu({
  day: MenuDay.Monday,
  meal: MealPeriod.Breakfast,
});

const lunchItems = await client.getItems({
  meal: MealPeriod.Lunch,
});

const veganOrPlantBased = await client.getItems({
  dietaryInfo: [DietTag.VEGAN, DietTag.PLANT_BASED],
});

const mindfulOrVegetarian = await client.getItems({
  dietaryInfo: [DietTag.MINDFUL, DietTag.VEGETARIAN],
});

const fullMenu = await getTghMenu();

API

new TghFlavoursClient(options?)

Client options:

• portalUrl?: string
• fetchImpl?: (input, init?) => Promise<Response>
• requestInit?: RequestInit
• cache?: { enabled?: boolean; ttlMs?: number }
• cacheEnabled?: boolean (legacy fallback)
• cacheTtlMs?: number (legacy fallback)
• requestTimeoutMs?: number (default: 10000)

Disable cache example:

const client = new TghFlavoursClient({
  cache: { enabled: false },
});

client.getMenu(options?)

Returns structured JSON:

• source: source URLs and fetch timestamp
• week: selected week metadata
• filters: applied filters
• days: grouped output by day/group/category
• items: flattened list of all filtered items

client.getItems(options?)

Returns only the flattened items array.

Query options

• day?: string | string[] ("Monday", "Tuesday", etc.)
• meal?: string | string[] ("breakfast", "lunch", "dinner", "other")
• dietaryInfo?: DietTag | DietTag[]
• weekOffset?: number
• menuTitle?: string
• includeEmptyGroups?: boolean
• includeRawNutrition?: boolean
• forceRefresh?: boolean

Item shape

Each item includes:

• id
• name
• calories (number, always present)
• caloriesText
• mindful
• dietTags
• allergens
• servingSize
• description
• price
• day
• mealGroup
• mealPeriod
• category
• menu

Optionally:

• rawNutrition when includeRawNutrition: true

Items may contain multiple dietary tags. dietaryInfo accepts one or many enum values and returns items matching any provided dietary tag.