{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://smartlinks-app-nutrition.lovable.app/schemas/nutrition-record-v1.json",
  "title": "SmartLinks Nutrition Record v1",
  "description": "Canonical payload stored in SL.app.records under recordType 'nutrition'. All nutrient values are expressed per 100 g (food) or per 100 ml (beverage).",
  "type": "object",
  "required": ["nutrients", "serving", "productType"],
  "additionalProperties": false,
  "properties": {
    "productType": {
      "type": "string",
      "enum": ["food", "beverage"],
      "description": "Drives per-100g vs per-100ml interpretation and UK traffic-light thresholds."
    },
    "lastUpdated": {
      "type": "string",
      "format": "date-time",
      "description": "ISO-8601 timestamp of the last write. Optional."
    },
    "basis": {
      "type": "object",
      "additionalProperties": false,
      "required": ["kind"],
      "description": "Declares what the `nutrients` values are expressed per. OMIT (or use kind '100') when values are already per 100 g/ml — that is the canonical default. When you only have per-serving or per-pack figures, set this and the app converts to per-100 for labels and traffic-light ratings.",
      "properties": {
        "kind": {
          "type": "string",
          "enum": ["100", "serving", "amount"],
          "description": "'100' = per 100 g/ml (default). 'serving' = per one serving (serving.servingSize must be set). 'amount' = per the custom reference amount below."
        },
        "amount": {
          "type": ["number", "null"],
          "exclusiveMinimum": 0,
          "description": "Reference amount (in serving.servingSizeUnit) the values refer to. Required when kind is 'amount'."
        }
      }
    },
    "serving": {
      "type": "object",
      "required": ["servingSize", "servingSizeUnit"],
      "additionalProperties": false,
      "properties": {
        "servingSize":            { "type": "number", "exclusiveMinimum": 0 },
        "servingSizeUnit":        { "type": "string", "enum": ["g", "ml"] },
        "servingSizeDescription": { "type": ["string", "null"], "description": "Human label e.g. '1 slice (30g)'." },
        "servingsPerContainer":   { "type": ["number", "null"], "exclusiveMinimum": 0 },
        "referenceServing":       { "type": ["number", "null"], "description": "Optional reference serving for %RI calculations." }
      }
    },
    "nutrients": {
      "type": "object",
      "description": "All values per 100 g (food) or per 100 ml (beverage). Use null for unknown.",
      "additionalProperties": false,
      "properties": {
        "energyKj":            { "type": ["number", "null"], "description": "kJ per 100. 1 kcal = 4.184 kJ." },
        "energyKcal":          { "type": ["number", "null"], "description": "kcal per 100." },
        "fat":                 { "type": ["number", "null"], "description": "g per 100." },
        "saturatedFat":        { "type": ["number", "null"], "description": "g per 100." },
        "monoUnsaturatedFat":  { "type": ["number", "null"], "description": "g per 100." },
        "polyUnsaturatedFat":  { "type": ["number", "null"], "description": "g per 100." },
        "transFat":            { "type": ["number", "null"], "description": "g per 100." },
        "carbohydrate":        { "type": ["number", "null"], "description": "g per 100." },
        "sugars":              { "type": ["number", "null"], "description": "g per 100 (EU 'of which sugars')." },
        "totalSugars":         { "type": ["number", "null"], "description": "g per 100 (US 'Total Sugars')." },
        "addedSugars":         { "type": ["number", "null"], "description": "g per 100 (US 'Includes Xg Added Sugars')." },
        "polyols":             { "type": ["number", "null"], "description": "g per 100." },
        "starch":              { "type": ["number", "null"], "description": "g per 100." },
        "fibre":               { "type": ["number", "null"], "description": "g per 100." },
        "protein":             { "type": ["number", "null"], "description": "g per 100." },
        "salt":                { "type": ["number", "null"], "description": "g per 100. salt = sodium(g) * 2.5." },
        "sodium":              { "type": ["number", "null"], "description": "mg per 100. Provide either salt or sodium; both is OK." },
        "cholesterol":         { "type": ["number", "null"], "description": "mg per 100 (US)." }
      }
    },
    "vitaminsAndMinerals": {
      "type": "object",
      "description": "Optional micronutrients per 100 g/ml. Units vary by nutrient — see property descriptions.",
      "additionalProperties": false,
      "properties": {
        "vitaminA":        { "type": ["number", "null"], "description": "µg per 100." },
        "vitaminC":        { "type": ["number", "null"], "description": "mg per 100." },
        "vitaminD":        { "type": ["number", "null"], "description": "µg per 100." },
        "vitaminE":        { "type": ["number", "null"], "description": "mg per 100." },
        "vitaminK":        { "type": ["number", "null"], "description": "µg per 100." },
        "vitaminB1":       { "type": ["number", "null"], "description": "mg per 100 (thiamin)." },
        "vitaminB2":       { "type": ["number", "null"], "description": "mg per 100 (riboflavin)." },
        "vitaminB3":       { "type": ["number", "null"], "description": "mg per 100 (niacin)." },
        "vitaminB6":       { "type": ["number", "null"], "description": "mg per 100." },
        "vitaminB12":      { "type": ["number", "null"], "description": "µg per 100." },
        "folicAcid":       { "type": ["number", "null"], "description": "µg per 100." },
        "biotin":          { "type": ["number", "null"], "description": "µg per 100." },
        "pantothenicAcid": { "type": ["number", "null"], "description": "mg per 100." },
        "calcium":         { "type": ["number", "null"], "description": "mg per 100." },
        "iron":            { "type": ["number", "null"], "description": "mg per 100." },
        "magnesium":       { "type": ["number", "null"], "description": "mg per 100." },
        "zinc":            { "type": ["number", "null"], "description": "mg per 100." },
        "potassium":       { "type": ["number", "null"], "description": "mg per 100." },
        "phosphorus":      { "type": ["number", "null"], "description": "mg per 100." },
        "iodine":          { "type": ["number", "null"], "description": "µg per 100." },
        "selenium":        { "type": ["number", "null"], "description": "µg per 100." },
        "manganese":       { "type": ["number", "null"], "description": "mg per 100." },
        "copper":          { "type": ["number", "null"], "description": "mg per 100." },
        "chromium":        { "type": ["number", "null"], "description": "µg per 100." },
        "molybdenum":      { "type": ["number", "null"], "description": "µg per 100." }
      }
    },
    "healthClaims": {
      "type": "array",
      "description": "Regulated marketing claims. `validated` must reflect the writer's regulatory check.",
      "items": {
        "type": "object",
        "required": ["claim", "regulation", "validated"],
        "additionalProperties": false,
        "properties": {
          "claim":      { "type": "string", "description": "Display text, e.g. 'Low fat'." },
          "regulation": { "type": "string", "enum": ["eu", "uk", "us"] },
          "validated":  { "type": "boolean", "description": "True if nutrient values pass the regulator's threshold for this claim." },
          "note":       { "type": "string" }
        }
      }
    }
  }
}
